Files
documentation/start-here/introduction.md

2.5 KiB

Vyla

An open-source, modular media ecosystem. Native apps for desktop, mobile, and TV backed by a scraper SDK and self-hosted streaming gateway.

Vyla across devices

What is Vyla?

Vyla is an open-source media stack built for privacy and user control:

  • Client Apps: Native frontends for Desktop (Windows, macOS, Linux), Android Mobile, and Android TV.
  • Vyla SDK (@vyla-entertainment/sdk): A Node.js scraping engine querying 60+ upstream sources with jitter buffering and stream validation.
  • Stream API: A self-hostable HTTP and Server-Sent Events (SSE) gateway delivering live stream manifests, subtitles, and downloads.

:::callout-note Vyla does not host, upload, or store video files. It resolves publicly accessible web links on demand. :::


Ecosystem Components

  • Vyla Home — Desktop app built with Tauri v2 and Rust. Includes auto-updates, Discord RPC, and offline fallbacks.
  • Vyla Go — Android mobile client with shader animations and background playback.
  • Vyla TV — Android TV and Fire TV app with D-pad navigation and ExoPlayer playback.
  • Stream API — High-concurrency Node.js streaming gateway with cluster caching and M3U8 reverse proxying.
  • Vyla SDK — Core resolver module for Node.js backends and scrapers.
  • Web Player — Lightweight HLS integration for custom web players.

Design Principles

  • No Telemetry: No mandatory accounts, analytics, or tracking.
  • Automatic Failover: Queries multiple providers with randomized jitter. If a provider fails, the player moves to the next candidate instantly.
  • Progressive Delivery: Stream API emits metadata and video candidates over Server-Sent Events (SSE) so playback starts in 3 to 8 seconds.
  • Self-Hostable: Run every service locally or deploy to your own VPS.

Quick Navigation