Popcorn is a mobile application that uses The Movie Database API to present information about movies, people and TV Shows. You can search for specific title / person or check what is in lists of popular ones. Each movie and TV Show is presented really precisely - you can get to know what is it about, when and where it was produced, which languages are used in it, how long it lasts, which genres it represents, who plays in it, who produced it and what rating it has. You can also check when and where specific person was born, when he/she died, with which movies and TV shows is connected and read his/her biography. Another functionality offered by Popcorn is adding to favourites thanks to local database.
- Kotlin 1.4.30 - langauge in which the project has been written,
- Room 2.2.6 - library responsible for storing data in local database,
- Retrofit 2.9.0 - library responsible for communicating with API,
- Glide 4.11.0 - library responsible for displaying pictures with given url.
Popcorn uses REST API with API KEY. If you just want to test it on your mobile phone, you can download an .apk from Releases and install it. Otherwise, if you want to change something in the code and compile it by yourself, you'll have to generate your own API KEY as it is not contained in this repository. To do it, follow the steps from this instruction and replace the value of apiKey in the line 68 of model/api/ApiRequest.kt file with your key:
private const val apiKey: String = "YOUR_API_KEY" // PLACE YOUR API KEY HERE
Application consists of five tabs: Home, Movies, People, TV Shows and Favourite. In first tab, by default, there are displayed popular movies, popular people and popular TV Shows, but you can use search view placed at the top of the screen to browse items by their names. And of course there are usually a lot of results so you can scroll left or right. Using search view in this tab causes in searching in all three lists at the same time.
In second, third and fourth tabs there are almost the same lists as in first tab but shown in different way - you have to scroll up or down. In these tabs you can also add items to favourites and get to know about the specific movie's / TV Show's release year.
In last tab you can see a list of your favourite movies and TV Shows. There you can of course delete them from the list or search for specific one.
If you click a row or tile with specific movie / TV Show, you'll go to the screen presenting it's details. Information which is displayed here has been already mentioned in Project description. You can also click the name of company responsible for this title and check the details of the company.
And if you click a row or tile with specific person, you'll go to the screen with his/her details too.
The project is considered as finished.