Movies Catalog Android App

Website • Play Store • FAQ

🚀 About

BAZZ Movies is an Android app build with Kotlin, offering comprehensive movie and TV catalog. BAZZ Movies allows users to discover, explore, and manage their favorite and watchlist with ease.

This project is a non-commercial application for showcasing movies and TV shows, intended for personal and educational use as part of my portfolio.

BAZZ Movies use TMDB API, but not endorsed, certified, or approved by TMDB

🌟 Features

• Integrated with TMDB account
• Save favorites and watchlist on local
• Swipe action for easy to organize between favorite and watchlist
• Guest session (no need to login)
• Search movies, tv-series, and actors
• Detailed information

⬇️ Download

BAZZ Movies available downloaded via Google Play Store

📝 Installation

1. Make sure already install Android Studio.

2. Clone this project.

3. (Optional) Configure Crashlytics and Analytics

4. Get your api on TMDB and OMDb.

5. Create or edit local.properties and put your API keys:

   MDB_API_KEY = { TMDB_API_KEY }
   OMDB_API_KEY = { OMDB_API_KEY }
   

6. Build the project (Ctrl + F9).

7. Run with your virtual or phone devices

🧪 Testing

We use testing to ensure the stability and quality of our code. Here’s how you can run different types of tests in the project:

1. Unit Tests (Still in Progress)

   For unit tests, you can easily run them with the following command:

   ./gradlew test
   

   This will execute all the unit tests in the project to ensure everything is functioning as expected. Tests are also automatically run on GitHub Actions with each push or pull request, so you can see if everything is passing directly in the GitHub interface.

2. UI Tests (Still in Progress)

   While we’re still working on Android UI test coverage, you can run some of the Android-specific tests that are available using:

   ./gradlew connectedAndroidTest
   

   This command runs the tests on a connected Android device or emulator. Keep in mind that this is still a work in progress, so we may not have full test coverage just yet.

🛠️ Architecture

The BAZZ Movies app follows the official architecture guidance and is described in detail in the BAZZ Movies modularization.

🤝 How to Contribute

Please read this page

📜 Licenses and Usage

This application is released under the Apache Version 2.0 License.

Copyright (C) 2024 Waffiq Aziz

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Note

• BAZZ Movies uses third-party API to function.
• Developers must secure their own API key and adhere to the API's terms of service.

Third-Party Libraries

1. TMDB API: Provides movie and TV data. See TMDB Terms.
2. OMDb API: RESTful service for movie info. See OMDb Terms.
3. GLide: Image loading library - GitHub.
4. ExpandableTextView: An expandable Android TextView - GitHub.
5. Shimmer Android: Library shimmering effects - GitHub
6. Country Picker Android: (Apache 2.0) - GitHub.
7. okhttp, retrofit, moshi: (Apache 2.0) - GitHub.
8. country: IP-to-country geolocation API - Github.

Fonts

Licensed under Open Font License:

• Nunito Sans
• Exo Font