3.5 KiB
Vyla TV (Android TV)
The native 10-foot Leanback streaming experience for Android TV and Google TV, built with Jetpack Compose and ExoPlayer.
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:
| 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 |
| Amazon Fire TV | .apk |
Fire TV Stick 4K / Max, Fire TV Cube | Download Vyla TV APK |
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:
- Install Downloader by AFTVnews from the Google Play Store or Amazon Appstore.
- In your TV's settings, navigate to Settings > System > Developer Options (or Device & Software > Developer Options) and enable Install Unknown Apps for Downloader.
- Open Downloader and enter the direct APK URL from our releases:
https://gitlab.com/vyla-entertainment/TV/-/releases
- Download the latest
.apkand 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
# 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:
- Launch Android Studio.
- Choose Open an Existing Project and select the
android/subfolder inside the TV repository. - Allow Gradle to sync and build targets.