Tivi – TV show tracking Android app

Tivi is a work-in-progress TV show tracking Android app, which connects to Trakt.tv.

Android development

Tivi is an app that attempts to use the latest libraries and tools. As a summary:

• Entirely written in Kotlin.
• UI completely written in Jetpack Compose (see below).
• Uses Kotlin Coroutines throughout.
• Uses many of the Architecture Components, including: Room, Lifecycle, Navigation.
• Uses Hilt for dependency injection

Development setup

First off, you require the latest Android Studio Flamingo (or newer) to be able to build the app.

Code style

This project uses ktlint, provided via the spotless gradle plugin, and the bundled project IntelliJ codestyle.

If you find that one of your pull reviews does not pass the CI server check due to a code style conflict, you can easily fix it by running: ./gradlew spotlessApply.

API keys

You need to supply API / client keys for the various services the app uses:

• Trakt.tv
• TMDb

You can find information about how to gain access via the relevant links.

When creating a Trakt API project, you need to set the OAuth redirect uri to app.tivi.debug://auth/oauth2callback for debug build types, or app.tivi://auth/oauth2callback for release build types.

Once you obtain the keys, you can set them in your ~/.gradle/gradle.properties:

# Get these from Trakt.tv
TIVI_TRAKT_CLIENT_ID=<insert>
TIVI_TRAKT_CLIENT_SECRET=<insert>

# Get this from TMDb
TIVI_TMDB_API_KEY=<insert>

Jetpack Compose

As mentioned above, this app’s UI is completely written in Jetpack Compose. Some screens highlighted are:

Show details

[source]

Episode details

[source]

Account

[source]

Contributions

If you’ve found an error in this sample, please file an issue.

Patches are encouraged and may be submitted by forking this project and submitting a pull request. Since this project is still in its very early stages, if your change is substantial, please raise an issue first to discuss it.

Tivi on GitHub: https://github.com/chrisbanes/tivi
Platform: Android
⭐️: 6.2K