Skip to content

Bit-Camp-IO/TMDA-Android

Repository files navigation

📱 TMDA Android App

GitHub license GitHub last commit GitHub issues

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

🚀: Features

  • Search for movies by title, genre, or keywords
  • View movie details including synopsis, release date, and average rating
  • Read and submit reviews for movies
  • Watch movie trailers
  • Mark movies as favorites for quick access
  • Explore popular movies and upcoming releases

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)
  • TMDB API key (Sign up for an account and obtain an API key)

Getting Started

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

  1. Clone this repository to your local machine using the following command:
git clone https://github.com/Bit-Camp-IO/TMDA-Android.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 TMDB 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.

API Usage

The TMDA Android app utilizes the TMDB API to fetch movie data. To use the app with the TMDB API, make sure to obtain an API key as mentioned in the prerequisites.

The API key is stored in the secrets.xml file as described in the "Getting Started" section. This key is used by the app to authenticate requests to the TMDB API. Please make sure to keep your API key confidential and avoid exposing it publicly.

Contributing

Contributions to the TMDA 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.

License

This project is licensed under the MIT License. Feel free to use, modify, and distribute the code as per the terms of the license.

Acknowledgments

The TMDA Android app is built using the TMDB API, which provides movie data to power the app's features

. We would like to express our gratitude to the TMDB team for their efforts in providing this valuable resource.

Contact

If you have any questions, suggestions, or feedback, please contact the project maintainer:

Email: your-email@example.com
GitHub: Bit-Camp-IO

Releases

No releases published

Packages

No packages published

Languages