Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ivikashgorai/showspotter-the-movies-app

ShowSpotter is an Android application designed to help users discover and explore movies seamlessly.The TMDB API is not accessible in India. To run this application within India, please use a VPN service (e.g., Turbo VPN) to connect to a server outside of India.
https://github.com/ivikashgorai/showspotter-the-movies-app

android-application android-pro android-project compose jetpack project projects retorfit tmdbapi

Last synced: about 9 hours ago
JSON representation

Host: GitHub
URL: https://github.com/ivikashgorai/showspotter-the-movies-app
Owner: ivikashgorai
License: mit
Created: 2025-01-10T08:36:31.000Z (about 1 month ago)
Default Branch: master
Last Pushed: 2025-01-28T14:26:05.000Z (14 days ago)
Last Synced: 2025-02-10T19:18:16.401Z (about 9 hours ago)
Topics: android-application, android-pro, android-project, compose, jetpack, project, projects, retorfit, tmdbapi
Language: Kotlin
Homepage: https://drive.google.com/file/d/1cY8DYXSuvhC1dzMGeS09uiW8NSoz18Ef/view?usp=sharing
Size: 15.6 MB
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# ShowSpotter - The Movies App

**ShowSpotter** is a modern Android application designed to help users discover, explore, and keep track of their favorite movies and TV shows. Built with the latest Android technologies, this app provides a seamless user experience for movie enthusiasts.

---

## Features

- **Movie Discovery:**
- Browse a wide range of movies and web series fetched from the TMDB (The Movie Database) API.
- Discover trending, popular, and top-rated content effortlessly.

- **Search Functionality:**
- Find movies by entering keywords in the search bar.
- Enjoy quick, accurate results to discover your favorite titles.

- **Detailed Movie Information:**
- View details such as title, rating, release year, and more for each movie.
- View comprehensive details for each movie and web series, including:
- **Title**
- **Rating**
- **Release Year**
- **Synopsis**
- **Genre**

- **Favorite List and Watchlist:**
- Save your favorite movies and web series to revisit them anytime.
- Add movies and web series to your personalized watchlist to keep track of what to watch next.

---

## Designs
![Alt text](app/src/main/res/drawable/app_interface.png)

## App Workflow
![Alt text](app/src/main/res/drawable/app_workflow.png)

## Technical Details

- **Programming Language:** Kotlin
- **Framework:** Jetpack Compose
- **Networking:** Retrofit
- **Architecture:** MVVM (Model-View-ViewModel)
- **Authentication:** Firebase Authentication
- **Data Storage:** Firebase Realtime Database
- **SignUp Email Validation Check:** Maileroo
- **LiveData and ViewModel:** For managing UI-related data in a lifecycle-conscious way.

---

## Important Note

The TMDB API is not accessible in India. To run this application within India, please use a VPN service (e.g., Turbo VPN) to connect to a server outside of India.

---

## Installation

To run this application locally, follow these steps:

1. **Clone the Repository:**

```bash
git clone https://github.com/ivikashgorai/ShowSpotter-The-Movies-App.git
```

2. **Open in Android Studio:**
- Open Android Studio.
- Navigate to the cloned repository folder and select it.

3. **Build the Project:**
- Sync the Gradle files.
- Build the project using `Build > Make Project`.

4. **Run the App:**
- Connect an Android device or start an emulator.
- Click the `Run` button or use `Shift + F10`.

---

## API Key Setup

This app uses the TMDB API to fetch movie data. To access the API, you need to obtain an API key from TMDB.

1. **Obtain an API Key:**
- Register for an account at [TMDB](https://www.themoviedb.org/).
- Navigate to your account settings and generate a new API key.

2. **Configure the API Key in the App:**
- Locate the `Constants.kt` file in the project.
- Replace the placeholder with your actual API key:

```kotlin
const val API_KEY = "your_api_key_here"
```

---

## Contributing

Contributions are welcome! To contribute:

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Commit your changes.
4. Push your branch and create a Pull Request.

---

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

---

## Contact

For any queries or suggestions, feel free to reach out:

- **GitHub:** [ivikashgorai](https://github.com/ivikashgorai)
- **Email:** [[email protected]]

---

Thank you for checking out ShowSpotter! If you like this project, consider giving it a star! ⭐