# Vyla TV (Android TV)

The native 10-foot Leanback streaming experience for Android TV and Google TV, built with Jetpack Compose and ExoPlayer.

Vyla TV application Leanback interface on television display ## Overview **Vyla TV** is the living-room client in the Vyla ecosystem. Built entirely as a native Android application using modern **Jetpack Compose for TV** and Google's high-performance **ExoPlayer (Media3)** engine, Vyla TV brings the decentralized media experience to large displays. Every interface component in Vyla TV is designed specifically for remote control navigation, ensuring seamless D-pad focus management, rapid title browsing, and cinema-grade playback. --- ## Downloads Official TV APK builds are published to the [Vyla TV GitLab Releases](https://gitlab.com/vyla-entertainment/TV/-/releases): | Platform | Format | Recommended Target Devices | Download Link | | :--- | :--- | :--- | :--- | | **Android TV / Google TV** | `.apk` | Sony Bravia, Chromecast with Google TV, NVIDIA Shield TV, Xiaomi Mi Box | [Download Vyla TV APK](https://gitlab.com/vyla-entertainment/TV/-/releases) | | **Amazon Fire TV** | `.apk` | Fire TV Stick 4K / Max, Fire TV Cube | [Download Vyla TV APK](https://gitlab.com/vyla-entertainment/TV/-/releases) | --- ## TV Experience & Features - **D-Pad Directional Navigation**: Engineered from the ground up for directional remotes. No mouse pointers, virtual cursors, or awkward touch adaptations. - **ExoPlayer Media3 Engine**: Hardware-accelerated video decoding with direct support for adaptive HLS (m3u8), MP4, and MKV streams. - **Playback Control Matrix**: - Variable playback speeds (0.5x, 0.75x, 1.0x, 1.25x, 1.5x, 2.0x). - Multi-track subtitle selector with custom sync adjustment and font sizing. - Multi-stream source switcher to toggle between upstream providers without leaving the player. - **Catalog & Library**: - TMDB catalog integration with detailed cast, plot synopses, and genre filters. - "Watch Later" watchlist and persistent "Favorites" library stored locally on device. - Instant resume tracking with automatic timestamp memory. --- ## Sideloading on Android TV / Fire TV If your device does not have a direct browser installer: 1. Install **Downloader by AFTVnews** from the Google Play Store or Amazon Appstore. 2. In your TV's settings, navigate to **Settings > System > Developer Options** (or **Device & Software > Developer Options**) and enable **Install Unknown Apps** for Downloader. 3. Open Downloader and enter the direct APK URL from our releases: ```bash https://gitlab.com/vyla-entertainment/TV/-/releases ``` 4. Download the latest `.apk` and select **Install**. --- ## Building from Source ### Prerequisites - Node.js 20+ - Java Development Kit (JDK 17 or JDK 21) - Android SDK with Android TV API 26+ ### Build Steps ```bash # Clone the repository git clone https://gitlab.com/vyla-entertainment/TV.git vyla-tv cd vyla-tv # Install JavaScript asset bundling tools npm install # Build JS resolver bundle and compile debug APK via Gradle npm run dev ``` The resulting package will be generated at: ``` android/app/build/outputs/apk/debug/vyla.apk ``` ### Developing in Android Studio To inspect Kotlin source code or UI composables directly: 1. Launch Android Studio. 2. Choose **Open an Existing Project** and select the `android/` subfolder inside the TV repository. 3. Allow Gradle to sync and build targets.