mirror of
https://gitlab.com/vyla-entertainment/documentation.git
synced 2026-11-15 06:57:21 -05:00
87 lines
3.5 KiB
Markdown
87 lines
3.5 KiB
Markdown
# Vyla TV (Android TV)
|
|
|
|
<p class="page-description">The native 10-foot Leanback streaming experience for Android TV and Google TV, built with Jetpack Compose and ExoPlayer.</p>
|
|
|
|
<img class="vyla-banner" src="/src/assets/images/android-tv/site-preview.webp" alt="Vyla TV application Leanback interface on television display" loading="lazy" decoding="async" fetchpriority="low" />
|
|
|
|
## 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.
|