# 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 as a native Android app using **Jetpack Compose for TV** and Google's **ExoPlayer (Media3)** engine, Vyla TV brings streaming to televisions and smart boxes with directional remote navigation.
---
## Downloads
#### Official TV APK builds are published on [GitLab Releases](https://gitlab.com/vyla-entertainment/TV):
- **[Download the latest Vyla TV APK for Android TV / Google TV](https://gitlab.com/vyla-entertainment/TV/-/releases)**
#### Vyla TV is compatible with the following systems:
- Sony BRAVIA
- Google TV
- NVIDIA Shield
- Xiaomi Mi Box
- Amazon Fire TV Stick 4K / Max and Fire TV Cube.
- Any other device running Anrdoid TV 7.0+
---
## Features
- **D-Pad Navigation**: Optimized exclusively for remote controls with focus management.
- **ExoPlayer Media3**: Hardware-accelerated decoding for HLS (`.m3u8`), MP4, and MKV streams up to 4K/HDR.
- **Playback Controls**: Variable playback speeds (0.5x to 2.0x), multi-track subtitle selector with sync offsets, and in-player source switching.
- **Local Library**: TMDB catalog integration, Watch Later watchlist, and automatic resume playback timestamps.
---
## Sideloading via Downloader
1. Install **Downloader by AFTVnews** from the Google Play Store or Amazon Appstore.
2. In TV settings, navigate to Developer Options and enable **Install Unknown Apps** for Downloader.
3. Open Downloader and enter the release link:
```
https://gitlab.com/vyla-entertainment/TV/-/releases
```
4. Download the latest `.apk` and click **Install**.
---
## Building from Source
### Prerequisites
- Node.js 20+
- JDK 17 or JDK 21
- Android SDK with Android TV API 26+
### Build Steps
```bash
git clone https://gitlab.com/vyla-entertainment/TV.git vyla-tv
cd vyla-tv
npm install
npm run dev
```
Output APK location:
```
android/app/build/outputs/apk/debug/vyla.apk
```
### Android Studio
Open the `android/` subfolder in Android Studio to inspect Kotlin source code and Jetpack Compose layouts.