Skip to content

chrisbanes/tivi

main
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

* Add Circuit Retained to all UI modules

* Use collectAsRetainedState where useful

* Fix rebase
acb3ae8

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
September 20, 2023 13:53
July 26, 2023 09:49
September 20, 2023 13:53
art
May 17, 2021 10:30
September 20, 2023 13:53
September 11, 2023 10:20
July 3, 2023 21:30
August 13, 2022 09:57
September 20, 2023 13:53
July 2, 2023 16:10
September 21, 2023 07:59
April 14, 2022 12:08
September 20, 2023 13:53
September 20, 2023 13:53

Tivi

Tivi ๐Ÿ“บ (work-in-progress ๐Ÿ‘ท๐Ÿ”ง๏ธ๐Ÿ‘ทโ€โ™€๏ธโ›)

This is not an official Google product

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

Download

Android development

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

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:

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]

Show Details demo

Episode details

[source]

Show Details demo

Account

[source]

Show Details demo

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.

License

Copyright 2016-2021 Google LLC
Copyright 2023 Christopher Banes

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.