3.6 KiB
Ecosystem Glossary
Authoritative definitions for technical terms, protocols, and architectural concepts across the Vyla ecosystem.
A
AES-128 Encryption
A symmetric key cipher frequently used in HLS streaming. The playlist references an encryption key endpoint (#EXT-X-KEY:METHOD=AES-128,URI="..."). Stream API proxies and rewrites these key URIs to ensure playback permissions and headers match the viewer's session.
C
Cluster Primary & Worker
Node.js architecture utilized by Stream API. The Primary master process allocates CPU affinity, coordinates IPC messaging, and supervises workers. Workers handle inbound HTTP client requests, parse streams, and query upstream hosts concurrently.
E
ExoPlayer (Media3)
Google's high-performance, customizable media player library for Android. Used by Vyla TV to render adaptive 4K/HDR HLS streams with hardware acceleration.
F
Fallback Priority Queue
A client-side architecture where candidate video streams emitted by Stream API are queued in memory. If the currently playing stream crashes or drops offline, the player immediately mounts the next candidate in the queue without interrupting the viewer.
H
HLS (HTTP Live Streaming)
An adaptive bitrate streaming communications protocol developed by Apple. Video is divided into a sequence of small HTTP-based file chunks (.ts or .m4s) indexed by a master .m3u8 playlist.
HLS.js
A JavaScript library that implements an HLS client using HTML5 video and Media Source Extensions (MSE). Used by custom web players to play Vyla HLS streams in browsers lacking native HLS support.
J
Jitter Staggering
A randomized delay (0 to 800ms) injected before scraper network requests fire. Prevents dozens of concurrent scrapers from triggering upstream Cloudflare or DDoS rate limits at the same millisecond.
M
M3U8 Playlist
A UTF-8 encoded text file representing an HLS playlist. Stream API intercepts and rewrites master and media M3U8 playlists so that chunk and encryption key URLs route through the proxy with valid CORS headers.
P
Progressive Streaming
A delivery pattern where metadata and media candidates are emitted to client players in real time over Server-Sent Events (SSE) as each scraper finishes, rather than waiting for all scrapers to complete.
Provider / Scraper
A self-contained JavaScript module in @vyla-entertainment/sdk (src/sources/) that queries an upstream video host, extracts stream URLs, and formats headers.
S
Server-Sent Events (SSE)
A standardized HTML5 server-to-client streaming technology over a persistent HTTP connection (Content-Type: text/event-stream). Used by Stream API /movie and /tv routes to emit meta, source, and done events.
Sidecar Process
An architectural pattern used in Vyla Home where a secondary runtime process (Node.js) is bundled adjacent to the primary native application shell (Tauri Rust binary) to manage local services.
T
Tauri v2
A framework for building tiny, ultra-fast native applications for all major desktop and mobile platforms using web frontends and Rust backends. Vyla Home and Vyla Go are built on Tauri v2.
TMDB (The Movie Database)
A community-built movie and television database. Vyla standardizes all movie and TV series queries on numeric TMDB IDs.
TS Segment De-Masking (120-Byte Stripping)
A de-obfuscation routine implemented in Stream API. Certain CDNs disguise video chunks by prepending a 120-byte fake image header (PNG, JPEG, TikTok CDN). Stream API removes these 120 bytes, restoring valid MPEG-TS video for media players.