/TrailersMovies

Primary LanguageKotlin

📱 Trailer Android App

This repository contains the source code for the Trailer Android app, which allows users to browse and search for movies using the Trailer API. The app provides information such as movie details, and trailers.

Video

🚀: Features

  • Search for movies by title
  • View movie details including synopsis, release date, and average rating
  • Watch movie trailers
  • Mark movies as favorites for quick access
  • Explore popular, Top rated, and upcoming movies
  • Show images for Actors and movies and you can download them to your gallery

Screenshot

⚒️: Tech Stack.

  1. Kotlin
  2. Retrofit
  3. Dagger Hilt
  4. Logging Interceptor
  5. Coroutines
  6. Kotlin Flow
  7. Room Database
  8. Paging 3
  9. Shimmer

Prerequisites

Before running the app, ensure that you have the following:

  • Android Studio (version 2022.2.1 or higher)
  • Java Development Kit (JDK) (version 1.8 or higher)
  • Trailer API key (Sign up for an account and obtain an API key)

Getting Started

To get started with the Trailer Android app, follow these steps:

  1. Clone this repository to your local machine using the following command:
https://github.com/Sajadio/TrailersMovies.git
  1. Open Android Studio and select "Open an Existing Project."
  2. Navigate to the cloned project directory and select it.
  3. Android Studio will build and sync the project automatically.
  4. Once the project is synced, navigate to the app directory in the project structure.
  5. Open local.properties and add the following code, replacing YOUR_API_KEY with your Trailers API key:
apiKey =  YOUR_API_KEY
  1. Save the file.
  2. Run the app on an emulator or physical device by clicking the "Run" button in Android Studio.

Contributing

Contributions to the Trailers Android app are welcome! If you find any issues or want to add new features, please submit an issue or pull request on the GitHub repository.

When contributing, please adhere to the following guidelines:

  • Fork the repository and create a new branch for your feature or bug fix.
  • Ensure that your code follows the project's code style and conventions.
  • Write clear and concise commit messages and provide a detailed description of your changes.
  • Test your changes thoroughly before submitting a pull request.

Support

If you found this repository helpful and learned even a little something from it, then consider supporting me by giving this repo a Star ⭐️