CinefinTV

A native Android TV client for Jellyfin, built with Kotlin, Jetpack Compose for TV, Media3, Hilt, Retrofit, and OkHttp.

Designed for a true 10-foot TV experience with D-pad-first navigation, focus-aware UI, and playback controls that feel native on remote devices.

Project status

Beta. Past MVP, with the full end-to-end user journey working: server connection and authentication, home feed, library browsing, search, detail pages, video and audio playback, and settings persistence.

Current focus areas include reliability hardening, dependency stabilisation, navigation and focus refinements across TV surfaces, playback and update-flow quality, and expanded automated coverage.

Features

Authentication

- Server connection with validation and testing. - Username and password login. - Quick Connect polling flow. - Session persistence and secure restore.

Browsing and discovery

- Home sections: continue watching, recently added, and libraries. - Dedicated library browsing for movies, TV, and collections. - Debounced search with grid results. - Music browsing with albums, artists, and album detail track lists. - Detail screens with cast and similar metadata.

Playback

- Media3-powered fullscreen player. - Custom TV control overlay. - Seek, progress, and timestamp controls. - Resume, chapter-aware skip actions, and next-item flows. - Audio and subtitle track selection with quality switching.

Settings and security

- Persisted playback, subtitle, and appearance preferences. - Android Keystore-backed encryption. - Sensitive logging and header redaction safeguards.

Requirements

- Android TV device - A reachable Jellyfin server account

Disclaimer

CinefinTV is an independent, open-source project. It is not affiliated with Jellyfin or any third-party service. All trademarks belong to their respective owners.

License

MIT