Skip to content

Latest commit

 

History

History
110 lines (73 loc) · 4.45 KB

README.md

File metadata and controls

110 lines (73 loc) · 4.45 KB
Raw

Version Build Twitter

Buy Me A Coffee

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.

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