Popular Movies is an assignment project of the Android Fast Track program designed by udacity and co-created by Google. This project is currently in Stage - II where the public api offered by The Movie Database website has been used. This api exposes the metadata about movies and tv-shows in JSON format.
Movies are categorized into Popular and Top-Rated categories. Categories are separated by Tabs. Swipe behavior is not yet available. Hence Tabs have to be touched to interact. Upon tapping on Movie poster a detail page will be opened which will display generic information about the Movie along with Trailers and available Reviews, again separated by Tabs.
A material "favorite icon" has been incorporated at the Detail screen to set a Movie as favorite. A collection of All such favorite movies are available in the Favorite page which can be toggled from the Main screen using the overflow menu button. In the Favorite page, favorite movie posters are available, again in grid. Details of a favorite Movie can also be Viewed from tapping on Movie poster in the Favorite screen. Movie posters can be swiped out of the favorite movie collection left or right, if they are no longer "so favorite".
In order to request for the movies data using the movie database api we need an API Key which is unique to every user account registered with the movie database. The user need to register with the movie database.
Post registration and successful email verification, user will be able to request for a free api key.
User needs to state that the usage will be for educational/non-commercial use. The user will also need to provide some personal information to complete the request. Once the request is submitted, the user should receive the key via email shortly after. While sending the request for the movie data to the appropriate endpoint the api-key must be included as a query parameter to the uri.
- Clone the public repository
: git clone https://github.com/sarkarchandan/PopularMovies.git
- Import the project in the Android Studio and go to the gradle.properties (Project Properties) file.
- Place the obtained api-key to the field TMDB_API_KEY.
:TMDB_API_KEY="Your API Key Goes Here"
- Sync The Project.
- Build in Android Studio and run the App in the Android Emulator or any android device.
This project is being actively worked upon, to incorporate fresh design features to conform with Material Design Guidelines. Along with that the implementation of other useful libraries and design paradigms, such as
are being incorporated to ensure a richer user experience.