BESTV is a Kotlin app for discovering movies and TV shows on Android TV and mobile devices, powered by TMDb.

The app has dedicated interfaces for both form factors: remote-friendly navigation on TV and touch-first layouts on mobile. The platforms share the same data, domain, and navigation layers.

TV and mobile showcase

The composite bellow pairs the TV and mobile experiences. Each platform adapts browsing and discovery to its screen and input method.

Features

• Browse popular, top-rated, upcoming, and genre-based movies and TV shows.
• Search movies and TV shows by title.
• View work details, cast, videos, streaming providers, similar works, and recommendations.
• View cast biographies and credits.
• Save favorites.
• Use a TV interface designed for remote control or mobile layouts designed for touch.

Technology

• Kotlin
• Jetpack Compose for TV and mobile
• Android Architecture Components, including ViewModel and Room
• Kotlin Coroutines and Flow
• Retrofit for networking
• Coil for image loading
• Koin for dependency injection
• Lottie for animations

Architecture

BESTV uses modular Clean Architecture with MVI presentation state and events.

• Clean Architecture
• MVI Architecture
• Koin dependency injection

TMDb API

BESTV uses version 3 of the TMDb API. It is not endorsed or certified by TMDb.

To run the app, create a TMDb API key and keep it out of tracked files. For local builds, add it to the root local.properties file (which is ignored by Git):

TMDB_API_KEY=your_tmdb_api_key

For CI builds, store the key in the CI secret manager and expose it to Gradle as the TMDB_API_KEY environment variable. The environment variable takes precedence over local.properties. If no key is configured, Gradle logs a warning and builds with an empty key; TMDb requests from the app will not authenticate.

The app sends this key directly to TMDb, so it can still be extracted from a distributed APK. Keeping it out of Git protects the repository, but a backend proxy is needed to keep the key out of client builds.

References

• Jetpack Compose for TV
• Android TV recommendations
• Kotlin Coroutines guide
• Koin documentation

License

Copyright (c) 2018 Marcus Pimenta

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

http://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.