Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/michaldrabik/showly
Showly is a modern and slick Movies and TV Shows manager.
https://github.com/michaldrabik/showly
Last synced: 2 days ago
JSON representation
Showly is a modern and slick Movies and TV Shows manager.
- Host: GitHub
- URL: https://github.com/michaldrabik/showly
- Owner: michaldrabik
- License: gpl-3.0
- Created: 2019-08-21T13:26:06.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-11-04T09:51:57.000Z (9 days ago)
- Last Synced: 2024-11-06T03:04:02.472Z (8 days ago)
- Language: Kotlin
- Homepage: http://www.showlyapp.com
- Size: 33.9 MB
- Stars: 901
- Watchers: 19
- Forks: 59
- Open Issues: 82
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
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.
## 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](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:
```
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.
## 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:
## 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](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: [email protected]