Showly available on iOS 🍎

I am happy to announce that starting Jan 2025, Showly is available on iOS!

Check AppStore link below to jump straight into action.

Showly

Showly is a modern TV Shows and Movies tracking app.

The OSS version for Android 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.

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

Translations

Want to help translating Showly into your native language? Spotted a mistake?
Join the CrowdIn project which is used to manage translations:

Android: https://crowdin.com/project/showly-android-app
iOS: https://crowdin.com/project/showly-ios-app

Translations status for 20 Jan 2025:

iOS:

Android:

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 Indian 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: showlyapp@gmail.com