Skip to content

michaldrabik/showly-2.0

Repository files navigation

Version Build Twitter

Showly

Showly is a modern Android TV Shows Tracker.

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

Get it on Google Play

Screenshots

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4

Project Setup

  1. Clone repository and open project in the latest version of Android Studio.
  2. Create keystore.properties file and put it in the /app folder.
  3. Add following properties into keystore.properties file (values are not important at this moment):
keyAlias=github
keyPassword=github
storePassword=github
  1. 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"
  1. 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:

Screenshot 2024-08-05 at 11-32-21 Showly Android App dashboard in Crowdin

Dev Notes

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

  • Overall architecture should be simplified and refactored into more strict feature-based one
  • 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 suite and increase coverage

FAQ

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

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

2. 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]