CinefinTV

CinefinTV is a native Android TV client for Jellyfin, built with modern Android tooling (Kotlin, Jetpack Compose for TV, Media3, Hilt, Retrofit/OkHttp).

It targets a 10-foot experience (D-pad navigation, focused controls, large UI primitives) and currently delivers an MVP end-to-end flow: connect to a Jellyfin server, sign in, browse media, and play content.

Installation

1. On your Android TV device, enable Unknown sources (Settings → Device Preferences → Security & Restrictions). 2. Download the APK to your device (via a browser, USB, or adb sideload). 3. Open the APK file to install.

Features

Auth

- Server connection screen with URL validation/testing - Username/password login - Session persistence and restore

Browsing

- Home sections: - Continue Watching - Recently Added Movies - Recently Added TV - Recently Added Videos - Libraries - Library categories via shared library screen - Search with lazy grid UI - Music mode (Albums/Artists + album detail track listing)

Playback

- Media3-powered fullscreen player - Custom TV overlay controls: - Back - Play/Pause - Seek ±10 seconds - Progress + timestamps - Auto-hide controls and periodic playback state polling - OkHttp-backed data source so authenticated streams work consistently

License

MIT