If you use and enjoy Showly OSS, consider buying me a coffee as a support for my work. Thanks!

Showly

Showly is a modern Android TV Shows Tracker.

The OSS version available in this repo is completely free of all Google services.

Screenshots

Project Setup

1. Clone repository and open project in the latest version of Android Studio.
2. Create a keystore.properties file and put it in the /app folder.
3. Add the following properties into the keystore.properties file (values are not important at this moment):

keyAlias=github
keyPassword=github
storePassword=github

4. Add your Trakt.tv, TMDB, OMDB API keys as following properties into your local.properties file located in the root directory of the project:

traktClientId="your trakt client id"
traktClientSecret="your trakt client secret"
tmdbApiKey="your tmdb api key (v4)"
omdbApiKey="your omdb api key"

5. Rebuild and start the app.

Issues & Contributions

Feel free to post problems with the app as Github Issues.

Features ideas should be posted as new GIthub Discussion.

Pull requests are welcome. Remember about leaving a comment in the relevant issue if you are working on something.

Translations

Want to help translating Showly into your native language? Spotted a mistake?
Join the CrowdIn project which is used to manage translations:
https://crwd.in/showly-android-app

Translations status for 5 Aug 2024:

Dev Notes

The codebase has been around for a few years now and it grew a bit rusty. A few things surely could be addressed:

• Overall architecture should be simplified and refactored into a more strict feature-based one
• The single responsibility principle is broken and should be refactored in a few places like some of the Use Cases
• Retrofit could be replaced in favor of Ktor Client
• Jetpack Compose migration (although there is no real benefit of it currently from end-user point of view)
• Add more unit tests to complete the suite and increase coverage

FAQ

1. Can I watch/stream/download shows and movies with the Showly app?

No, that is not possible. Showly is a progress tracking type of app - not a streaming service.

2. I'm a user from India. I can't see any images and also encounter errors!

There is a known issue with TMDB API being blocked by India gov. For more details and a possible solution please see the thread here: https://www.themoviedb.org/talk/65d226e5c433ea0187b5b958#65d2dd5128d7fe017c34e9b5

3. The Show/Episode/Movie I'm looking for seems to be missing. What can I do?

Showly uses Trakt.tv as its main data source. If something is missing please use "Import Show" / "Import Movie" option located at the bottom of Trakt.tv website. It's also possible to contact Trakt.tv support about any related issue.

Contact

Twitter: https://twitter.com/AppShowly

Landing Page: www.showlyapp.com

Email: [email protected]