MovieDB

---

About The Project

ShowCase (formerly Movie DB) is a fully open-source Android application designed for enthusiasts to explore, discover, and organize their personal collection of films and television series.

It offers synchronization with your TMDB and Trakt accounts. Once logged in, you can sync your favorites, watchlist, rated movies, and more. It also integrates with a local database to keep track of your shows. You can assign various statuses to each title—such as ‘planned’, ‘watched’, or ‘dropped’—rate them, and note the dates you commenced and concluded each show.

The app allows you to filter shows based on genre, release dates, and more. Detailed information on each show, including the cast, crew, and recommendations for similar titles, is also available.

---

Key Features

• ✨ TMDB & Trakt Sync: Seamless synchronization for favorites, watchlist, ratings, and collections.
• 📝 List Management: Create and manage public/private lists on TMDB.
• 📊 External Ratings: View ratings from IMDb and other sources.
• 📱 Offline Support: Local database for tracking shows and personal progress.
• 🔄 Data Management: Import and export your local database.
• 🎨 Material You: Modern UI that adapts to your device's theme.
• 🔔 Release Notifications: Get notified about new movie and TV show releases.
• 🔄 External Data Import: Import data from other app (more on Wiki)
• ...and many more!

---

Screenshots

---

Installation

Release Channels

You can download and install ShowCase from the following sources:

Source	Link	Notes
GitHub Releases		Standard version & ShowCase Plus (with GDrive backup)
F-Droid		Standard version, no GDrive backup
Google Play		Ads supported version with IAP (supports the developer)

[!IMPORTANT] The ShowCase Plus version includes a feature for backing up your local database to Google Drive. This version is available exclusively from the GitHub Releases page and is not available on F-Droid due to its inclusion of proprietary Google services.

The Google Play version is a Ads supported version with IAP of the app. The same app is available for free on GitHub Release — purchasing it on Play Store is simply an additional way to support the developer.

Learn more about the different app versions on the project wiki.

---

Building from Source

ShowCase can be compiled using Android Studio or via the command line with Gradle.

1. Clone the repository

2. Set up API Keys:

   • Get a free API Key from TMDB.
   • Create a config.properties file in the root project directory. If a config.properties file exists,
   • Add your keys to config.properties:

     api_read_access_token="YOUR_TMDB_READ_ACCESS_TOKEN"
     api_key="YOUR_TMDB_API_KEY"
     

3. Build the application:

   • Using Android Studio:
     • Open Android Studio and select 'Open an existing Android Studio project' and use the cloned repository or directly clone the repository using VCS https://github.com/WirelessAlien/MovieDB.git.
     • Let Gradle sync and download dependencies.
     • Build the project using Build > or run it on an emulator/device using Run > Run 'app'.
   • Using Command Line (Gradle Wrapper):

     # For Linux/macOS
     ./gradlew assembleDebug  # For debug build
     ./gradlew assembleRelease # For release build (requires signing configuration)
     
     # For Windows
     gradlew.bat assembleDebug
     gradlew.bat assembleRelease
     

---

Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated!

Reporting Bugs & Requesting Features

If you encounter a bug or have a feature idea, please check the existing issues first. If your issue or idea isn't listed, feel free to open a new one:

• Report a Bug
• Request a Feature

Pull Requests

1. Fork the Project.
2. Create your Feature Branch (git checkout -b feature/AmazingFeature).
3. Commit your Changes (git commit -m 'Add some AmazingFeature').
4. Push to the Branch (git push origin feature/AmazingFeature).
5. Open a Pull Request against the master branch.

Please ensure your code adheres to the project's coding standards and that any new features are well-tested.

Translations

Help us make ShowCase accessible to more users by contributing translations! Visit our Weblate project page to get started.

---

License

Distributed under the GNU General Public License v3.0. See LICENSE file for the full text and GPL-3.0 Overview for more information.

---

Donate

If you find ShowCase useful and would like to support its development, please consider donating. Your support helps keep the project alive.