Skip to content

This is a simple Android application built with Kotlin to search and display movie details using The Movie Database (TMDB) API.

Notifications You must be signed in to change notification settings

mexikoedi/Simple-Movie-Details-Finder

Repository files navigation

Simple Movie Details Finder

What is this?

This is a simple Android application that helps you find details of movies.
You can search for a movie by its name and get details like the poster, score, genres, release date, runtime, and overview.

Is this useful to me?

If you are a movie enthusiast or someone who frequently looks up movie details, this app can be very useful.
It provides a quick and easy way to get comprehensive information about movies directly on your Android device.

Limitations?

  1. Only Android devices are supported from version 8.0 (API level 26) and above.
  2. No APK file is provided in this repository. You need to build the app yourself to use it. (See How to use section below.)

How to use?

An IDE like Android Studio or similar is required to open this project.
You can download the project by selecting the green button named "Code" then "Download ZIP".
After downloading, you can extract the files and open them with your IDE.
Or you can clone the project and open it directly in your IDE.
Afterwards, you need to have an API key from The Movie Database (TMDB) to use the app.
Be aware that you need to have an account there to get an API key.
After you get your API key, you need to put it in the local.properties file in the project.
The local.properties file needs to be located in the root directory of the project.
Add the API key like this to the file: TMDB_API_KEY=your_api_key_here
After that, you can run the app on an emulator or a real device.

How does it work?

The app was built with the "Recommended Architecture for Android Apps" in mind.
It uses many different modern technologies.
Here are some of the key technologies used in the app:

  • Kotlin: The primary programming language used for Android development.
  • Gradle: A build system used to automate building, testing, and deploying Android apps.
  • Jetpack Compose: A modern toolkit for building native Android UI.
  • Hilt: A dependency injection library for managing dependencies.
  • Room: A database library for storing and managing data locally.
  • Ktor: A networking library for making HTTP requests.
  • Coil: An image loading library for loading images from URLs.

The app uses the TMDB API to fetch movie details.
When you search for a movie, the app makes a request to the API with the movie name.
The API returns a list of twenty movies that match the search query.
You can load more movies by pressing the "Load More" button at the bottom of the list if there are more than twenty movies available.
If you want to view the movie details, just click on a movie to learn more about it.
The app also stores the data locally using the Room database.
This prevents the app from making unnecessary network requests when the same movie is searched again.

Examples

Dark Mode:
Movie Search
Movie Details

Light Mode:
Movie Search
Movie Details

Thanks to Colin Bankart for the help with some code parts.

© 2025 mexikoedi

All rights reserved.

About

This is a simple Android application built with Kotlin to search and display movie details using The Movie Database (TMDB) API.

Topics

Resources

Stars

Watchers

Forks

Languages