5.7 KiB
Vyla Entertainment
A community-built, decentralized media ecosystem and developer platform focused on privacy, user sovereignty, and self-hosted streaming infrastructure.
What is Vyla?
Vyla is an open-source, modular media ecosystem built on a simple foundation: users and developers should have absolute sovereignty over their media experience.
Unlike centralized streaming platforms that lock users into closed walled gardens, proprietary codecs, and telemetry tracking, Vyla separates the entire media stack into distinct, reusable layers:
- Client Frontends: Native applications for Desktop (Windows, macOS, Linux), Mobile (Android), and Television (Android TV / Google TV).
- Scraper & Resolver SDK: A high-performance Node.js scraping engine (
@vyla-entertainment/sdk) aggregating over 60 distributed upstream providers with automatic jitter buffering and HLS playback verification. - Stream API Gateway: A self-hostable HTTP and Server-Sent Events (SSE) microservice proxy delivering low-latency progressive playback manifests, subtitle tracks, and media downloads.
:::callout-note Core Policy: Vyla does not host, upload, store, or distribute video files or copyrighted media. The ecosystem provides client applications and self-hosted scraping tools that resolve publicly accessible links on demand. :::
Ecosystem Architecture at a Glance
The Vyla Ecosystem is designed around modularity. Each component functions autonomously or seamlessly interconnects with other components:
| Layer | Components | Core Capabilities |
|---|---|---|
| User Interfaces | Vyla Home, Vyla Go, Vyla TV | Desktop Tauri v2 with embedded sidecar, Android mobile client with WebGL shaders, and native Android TV (Jetpack Compose + ExoPlayer). |
| Distribution Gateway | Stream API | Node.js cluster gateway, SSE progressive source emitter, M3U8 playlist & key rewriting proxy, and 120-byte fake-image obfuscation stripper. |
| Resolver Engine | Vyla SDK (@vyla-entertainment/sdk) |
60+ modular source scrapers, two-phase stream verification (verifyStream / verifyPlayable), manga TLS-fingerprinted extraction, and subtitle normalization. |
The Vyla Component Matrix
| Component | Platform / Tech Stack | Primary Responsibility | Documentation |
|---|---|---|---|
| Vyla Home | Tauri v2, Node.js Sidecar, Rust | Full desktop control center, automatic updates, Discord RPC | Vyla Home Guide |
| Vyla Go | Tauri v2 Mobile, WebGL Shaders | Android mobile runtime, automated payload download, background playback | Vyla Go Guide |
| Vyla TV | Kotlin, Jetpack Compose, ExoPlayer | 10-foot Leanback television UI, D-pad navigation, 4K/HDR streaming | Vyla TV Guide |
| Stream API | Node.js, Cluster Workers, SSE | Self-hosted HTTP streaming gateway, M3U8 proxy, segment stripper | Stream API Overview |
| Vyla SDK | Node.js (ESM), TLS Client, Cheerio | Multi-provider video resolver, subtitle extractor, manga engine | SDK Overview |
| Custom Player | HLS.js, Video.js, HTML5 | Custom web and native playback integration layer | Build a Player |
Core Principles
- Zero Centralized Telemetry: Vyla frontends never require mandatory tracking, user account creation, or proprietary telemetry services.
- Failover by Design: Video resolution queries multiple providers concurrently with randomized jitter. If one upstream host goes down or throttles, the client seamlessly shifts to the next viable candidate.
- Progressive Delivery: Stream API delivers media metadata instantly, followed by source candidates streamed over Server-Sent Events (SSE) as each scraper resolves. Players start playback within 3 to 8 seconds without waiting for the slowest source.
- Local Sovereignty: Every part of Vyla can be self-hosted locally on your laptop, home server, NAS, or virtual private server (VPS).
Where to Begin
Select your path based on your role:
:::code-group
- On Desktop (Windows, macOS, Linux)? Download and run Vyla Home.
- On Android Phone or Tablet? Install the native Vyla Go APK.
- On Android TV, Google TV, or Fire TV? Install the Vyla TV APK.
- Need help with setup? Read the Troubleshooting Guide.
- Embedding scrapers in a Node.js project? Check out the SDK Quickstart and Complete API Reference.
- Want to author a new provider? Follow the Contributing a Source Guide.
- Integrating Manga discovery? Read the Manga SDK Documentation.
- Connecting a web or mobile player? Read Paths & Playback Events and the Client Integration Guide.
- Building fallback strategies? Study the Error Handling Guide.
- Self-hosting the streaming gateway? Read the Self-Hosting Guide.
Legal Notice & DMCA Compliance
Vyla is self-hosted software intended for personal educational and development use. All stream resolution and scraper logic interacts with publicly available web sources. Rights holders can review our takedown policies in the DMCA Policy.