documentation/GLOSSARY.md

Vyla Ecosystem Glossary

Authoritative reference glossary of terms, abbreviations, and architectural patterns used across the Vyla ecosystem.

• AES-128 Key Rewriting: The process in Stream API where HLS encryption key URIs (#EXT-X-KEY) are rewritten to route through the local proxy with permissive CORS headers.
• Cluster Primary: The master Node.js process in Stream API that manages inter-process IPC, shared LRU caching, and worker lifecycles.
• Cluster Worker: A child process in Stream API handling incoming HTTP requests and executing scraper resolution.
• ExoPlayer (Media3): Google's media playback library for Android, powering Vyla TV's native Leanback interface.
• Fallback Queue: A client-side array holding secondary video candidates emitted by Stream API to provide instant recovery if the primary stream fails.
• HLS (HTTP Live Streaming): Adaptive streaming protocol using M3U8 playlists and MPEG-TS / fragmented MP4 chunks.
• HLS.js: JavaScript library enabling HLS playback in standard HTML5 video elements via Media Source Extensions (MSE).
• Jitter Staggering: A randomized delay (0–800ms) injected into scraper requests to prevent concurrent burst requests against upstream CDNs.
• Manga Module: A module in @vyla-entertainment/sdk powered by atsu.moe and node-tls-client that bypasses TLS anti-bot protections via Chrome 131 fingerprinting.
• Server-Sent Events (SSE): Standardized persistent HTTP streaming protocol (text/event-stream) used by /movie and /tv to emit metadata and sources progressively.
• Sidecar Process: A companion Node.js background process bundled inside Vyla Home (Tauri v2) to supervise local services and file updates.
• TMDB ID: The numeric identifier assigned by The Movie Database (themoviedb.org) used across all Vyla movie and television endpoints.
• TS Segment De-Masking: The routine in Stream API that strips the first 120 bytes off obfuscated video chunks disguised as fake PNG or JPEG files.