{"id":13407031,"url":"https://github.com/chrisbanes/tivi","last_synced_at":"2025-08-16T18:33:37.944Z","repository":{"id":37444742,"uuid":"100624553","full_name":"chrisbanes/tivi","owner":"chrisbanes","description":"Tivi is a TV show tracking Android app, which connects to trakt.tv","archived":true,"fork":false,"pushed_at":"2024-11-12T18:56:00.000Z","size":71722,"stargazers_count":6707,"open_issues_count":0,"forks_count":890,"subscribers_count":161,"default_branch":"main","last_synced_at":"2025-08-11T14:48:19.915Z","etag":null,"topics":["android-application","jetpack-compose","kotlin","kotlin-coroutines","kotlin-multiplatform-mobile","trakt"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chrisbanes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-08-17T16:35:58.000Z","updated_at":"2025-08-10T16:23:08.000Z","dependencies_parsed_at":"2024-01-01T18:21:54.917Z","dependency_job_id":"3e7048a7-d1d0-4275-b1e1-aa38d23390e3","html_url":"https://github.com/chrisbanes/tivi","commit_stats":{"total_commits":3946,"total_committers":58,"mean_commits":68.03448275862068,"dds":"0.41028890015205266","last_synced_commit":"00e4e605fc37ba504923dd4040897f214e310f2a"},"previous_names":[],"tags_count":66,"template":false,"template_full_name":null,"purl":"pkg:github/chrisbanes/tivi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrisbanes%2Ftivi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrisbanes%2Ftivi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrisbanes%2Ftivi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrisbanes%2Ftivi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chrisbanes","download_url":"https://codeload.github.com/chrisbanes/tivi/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrisbanes%2Ftivi/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270131653,"owners_count":24532650,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-12T02:00:09.011Z","response_time":80,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android-application","jetpack-compose","kotlin","kotlin-coroutines","kotlin-multiplatform-mobile","trakt"],"created_at":"2024-07-30T20:00:18.141Z","updated_at":"2025-08-16T18:33:35.900Z","avatar_url":"https://github.com/chrisbanes.png","language":"Kotlin","funding_links":[],"categories":["Kotlin","Libraries","Applications","样例项目","完整 app","🎬 Media \u0026 Entertainment","App Projects","🤖 Android Architecture","[Archived] Android Apps (Search Results)"],"sub_categories":["推荐书籍","测试","📑 Tracking Services","Modern Android Architectures"],"readme":"# Tivi has now deprecated\n\nAfter roughly 9 years of development, I've decided that now (12th November 2024) is the time for Tivi to be 'complete'. After releasing 1.0.0 recently, I unfortunately just don't have the time or inclination to keep developing the app.\n\nAnother reason which has prompted this change is that I have no intention of allowing Google Play to publish my home address (through it's '[verification](https://support.google.com/googleplay/android-developer/answer/14177239?hl=en)' process), therefore my developer account has been restricted and locked. C'est la vie. \n\nI've also delisted the app on the iOS App Store.\n\nThanks to everyone who has used and tested the app. I hope that it's been useful to learn from.\n\n🫡\n\n---\n\n![Tivi](art/banner.png)\n\n\nTivi is a TV show tracking application which connects to [Trakt.tv](https://www.trakt.tv). It has been updated over the years to target a number of platforms, built upon Kotlin Multiplatform and Compose Multiplatform.\n\n## Download\n\n\u003ca href=\"https://play.google.com/store/apps/details?id=app.tivi\" target=\"_blank\"\u003e\n\u003cimg src=\"https://play.google.com/intl/en_gb/badges/static/images/badges/en_badge_web_generic.png\" width=240 /\u003e\n\u003c/a\u003e\n\n## Platforms\n\n### Android\n\nTivi started out as an open source Android app, showcasing cutting technologies through its development. The codebase was transformed in late-2022 to be built upon [Kotlin Multiplatform](https://kotlinlang.org/docs/multiplatform.html), allowing us to re-use a large proportion of the code across different platforms.\n\n### iOS\n\nThe iOS app is well maintained (the main developers uses it daily). To aid development time, most of the UIs are shared with the Android app, enabled through [Compose Multiplatform](https://www.jetbrains.com/lp/compose-multiplatform/).\n\n### Desktop JVM\n\nTivi is built for Desktop running as a Java app. Unfortunately we don’t have feature parity on the desktop target due to either missing APIs, or lack of priority by the maintainer to implement them. However the basics of the app do work.\n\n## Development Setup\n\n### Android and Desktop\n\nTivi is a standard Gradle project which can be opened in recent versions of Android Studio or IntelliJ.\n\n- The Android application module is located at [android-app/app/](android-app/app) (`:android-app:app`).\n- The Desktop application module is located at [desktop-app/](desktop-app) (`:desktop-app`).\n\n### iOS\n\nThe iOS project is setup as a typical Xcode project. It currently uses [CocoaPods](https://cocoapods.org/) to manage dependencies, and therefore you’ll need to install this before opening the Xcode project.\n\nLet's step through it:\n\n#### Setup Ruby\n\nWe need Ruby for various dependencies, therefore we need a Ruby environment. I recommend using [rbenv](https://github.com/rbenv/rbenv), but that's just a suggestion:\n\n```shell\nbrew install rbenv\n\nrbenv init\n\n# Download Ruby 3.3.4 and set it as the global version\nrbenv install 3.3.4\nrbenv global 3.3.4\n\n# Install bundler\ngem install bundler\n```\n\n#### Xcode\n\nWe use the latest version of Xcode supported by Kotlin Multiplatform, which is defined in the [.xcode-version](.xcode-version) file.\n\nWe enforce the Xcode version on CI, but locally you can use whatever version you want. The [Xcodes.app](https://www.xcodes.app/) application is a great way to install different versions.\n\n#### Nearly there\n\nAfter you have installed the dependencies, you can now pull down the dependencies:\n\n``` shell\ncd /path/to/tivi/checkout\n\n# Install all of the Ruby dependencies\nbundle install\n\n# Install pods\npod install --project-directory=ios-app/Tivi\n```\n\n#### Open the project in Xcode\n\nFinally, we can open the project in Xcode. Open Xcode and then point it to the workspace file at: [`ios-app/Tivi/Tivi.xcworkspace`](ios-app/Tivi/Tivi.xcworkspace).\n\nPress Run and it should build!\n\n### Code style\n\nThis project uses [ktlint](https://github.com/pinterest/ktlint), provided via\nthe [spotless](https://github.com/diffplug/spotless) gradle plugin, and the bundled project IntelliJ codestyle.\n\nIf you find that one of your pull reviews does not pass the CI server check due to a code style conflict, you can fix it by running: `./gradlew spotlessApply`.\n\n### API keys\n\nYou need to supply API / client keys for the various services the\napp uses:\n\n- [Trakt.tv](https://trakt.docs.apiary.io)\n- [TMDb](https://developers.themoviedb.org)\n\nYou can find information about how to gain access via the relevant links.\n\nWhen 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.\n\nOnce you obtain the keys, you can set them in your `~/.gradle/gradle.properties`:\n\n```\n# Get these from Trakt.tv\nTIVI_TRAKT_CLIENT_ID=\u003cinsert\u003e\nTIVI_TRAKT_CLIENT_SECRET=\u003cinsert\u003e\n\n# Get this from TMDb\nTIVI_TMDB_API_KEY=\u003cinsert\u003e\n```\n\n## Contributions\n\nIf you've found an error in this sample, please file an issue.\n\nPatches are encouraged and may be submitted by forking this project and\nsubmitting a pull request. Since this project is still in its very early stages,\nif your change is substantial, please raise an issue first to discuss it.\n\n## License\n\n```\nCopyright 2016-2021 Google LLC\nCopyright 2023 Christopher Banes\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    https://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchrisbanes%2Ftivi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchrisbanes%2Ftivi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchrisbanes%2Ftivi/lists"}