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 2 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/ivikashgorai/showspotter-the-movies-app
- Owner: ivikashgorai
- License: mit
- Created: 2025-01-10T08:36:31.000Z (5 months ago)
- Default Branch: master
- Last Pushed: 2025-03-20T20:21:57.000Z (2 months ago)
- Last Synced: 2025-04-05T09:15:40.343Z (about 2 months ago)
- Topics: android-application, android-pro, android-project, compose, jetpack, project, projects, retorfit, tmdbapi
- Language: Kotlin
- Homepage:
- Size: 15.6 MB
- Stars: 4
- Watchers: 1
- Forks: 2
- Open Issues: 2
-
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
## App Workflow
## 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 and Maileroo Api for email verification. To access the API, you need to obtain an API key from TMDB and Maileroo Website.
1. **Obtain an API Key:**
- Register for an account at [TMDB](https://www.themoviedb.org/).
- Navigate to your account settings and generate a new TMDB API key.
- Register for an account at [Maileroo](https://app.maileroo.com/smtp-relay)
- Generate Maileroo Api Key
2. **Paste the Api key**
- Go to path app/src/main/java/com/example/showspotter/tmdbMVVM/Repository.kt
- Paste the api keys
---
## 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! ⭐