If you use and enjoy Showly OSS, consider buying me a coffee as a support for my work. Thanks!
Showly is a modern Android TV Shows Tracker.
The OSS version available in this repo is completely free of all Google services.
- Clone repository and open project in the latest version of Android Studio.
- Create a
keystore.propertiesfile and put it in the/appfolder. - Add the following properties into the
keystore.propertiesfile (values are not important at this moment):
keyAlias=github
keyPassword=github
storePassword=github
- Add your Trakt.tv, TMDB, OMDB API keys as
following properties into your
local.propertiesfile 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"
- Rebuild and start the app.
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.
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:
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
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.
Twitter: https://twitter.com/AppShowly
Landing Page: www.showlyapp.com
Email: showlyapp@gmail.com