BioScope is an Android application that allows users to discover popular and top-rated movies. It uses the The Movie Database (TMDb) API to fetch movie data.
- Discover popular and top-rated movies.
- View movie details, including synopsis, release date, and ratings.
- Watch movie trailers.
- Read movie reviews.
- Add movies to a favorites list for offline access.
To build and run this project, you will need to provide your own API key for The Movie Database.
-
Get an API key:
- Go to themoviedb.org.
- Create an account and request an API key.
-
Add the API key to the project:
-
Open the
gradle.propertiesfile in the root of the project. -
Add the following line, replacing
YOUR_API_KEYwith your actual API key:MovieDBApiKey="YOUR_API_KEY"
-
-
Build and run the app:
- Open the project in Android Studio.
- Build and run the app on an Android device or emulator.
- The main screen displays a grid of movies.
- Use the menu to sort the movies by "Most Popular" or "Top Rated".
- You can also view your "Favorites" from the menu.
- Tap on a movie poster to view its details.
- In the details screen, you can view the movie's synopsis, rating, trailers, and reviews.
- Tap the star icon to add a movie to your favorites.
The project is organized into the following packages under app/src/main/java/za/co/gundula/app/bioscope/:
adapter: Contains the RecyclerView adapters for displaying movies, reviews, and trailers.data: Contains the database helper, content provider, and contract class for managing the local data store.model: Contains the data model classes that represent movies, reviews, and trailers.rest: Contains the Retrofit API client and interface for communicating with The Movie Database API.utils: Contains utility classes and constants used throughout the application.