https://github.com/trakt/showly
Showly is a modern and slick Movies and TV Shows manager.
https://github.com/trakt/showly
Last synced: 2 months ago
JSON representation
Showly is a modern and slick Movies and TV Shows manager.
- Host: GitHub
- URL: https://github.com/trakt/showly
- Owner: trakt
- License: gpl-3.0
- Created: 2019-08-21T13:26:06.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2026-03-12T02:46:47.000Z (3 months ago)
- Last Synced: 2026-03-27T23:48:36.252Z (3 months ago)
- Language: Kotlin
- Homepage: http://www.showlyapp.com
- Size: 34.4 MB
- Stars: 1,360
- Watchers: 17
- Forks: 81
- Open Issues: 132
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-android-kotlin-apps - showly-2.0 - sourced Android TV Shows Tracker.</br></br> <b>Tech Stack</b> : Dagger, Coroutines, Testing, Retrofit, Room, Firebase Messaging, WorkManager, Navigation, Dynamicanimation, LiveData, ViewModel </br></br> <i> Last commit: 10 minutes ago</i> | 🌟 611 </br> 🍴 41 </br> 👁️ 14 | (:art: Pattern / MVVM)
README
[](https://shields.rbtlog.dev/com.michaldrabik.showly2)
[](https://crowdin.com/project/showly-android-app)
[](https://crowdin.com/project/showly-ios-app)
[](https://twitter.com/AppShowly)
# 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):
```ini
keyAlias=github
keyPassword=github
storePassword=github
```
4. Add your [Trakt.tv](https://trakt.tv/oauth/applications), [TMDB](https://developers.themoviedb.org/3/), [OMDB](http://www.omdbapi.com) API keys as
following properties into your `local.properties` file located in the root directory of the project:
```ini
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](https://github.com/michaldrabik/showly-2.0/issues).
Features ideas should be posted as new GIthub [Discussion](https://github.com/michaldrabik/showly-2.0/discussions).
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](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](https://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