Introduction

Terminal interface to find, download, and stream movies, TV shows, and live TV using local media players.

Features

Streaming: Movies, TV series, anime, Asian dramas, and community Stremio addons across multiple native providers.
Live TV: M3U playlist import with channel categories, EPG support, and search.
Resolution Picker: Direct stream quality selection (4K, 1080p, 720p, 480p, Auto) before playback.
Hardware Players: Seamless launch in mpv, VLC, or IINA with custom auth header and cookie forwarding.
Batch Downloader: Multi-segment concurrent downloader with HTTP range pause and resume for episodes and full seasons.
Subtitle Picker: Multi-language subtitle tracks extracted and selectable via an interactive picker before playback or download.
Terminal UI: Vim navigation, mouse interaction, slash command palette (/help, /settings), and 9 built-in themes.
Cover Art: Native Kitty, Sixel, and iTerm2 poster rendering with automatic text fallback.
Resume & Library: Home deck with continue-watching timestamps, watch history, and favorites stored strictly on local disk. Zero telemetry.

Media Player: mpv, VLC, or IINA (macOS) / any external video player (Android).
Posters: Terminal with Sixel, Kitty, or iTerm2 support (Ghostty, Kitty, WezTerm, iTerm2, foot, Windows Terminal v1.22+).
DASH Downloads: yt-dlp and ffmpeg (required only for MovieBox DASH downloads).

Guide	Description
Installation	Platform installation instructions, package managers, and binary verification
Keyboard & Controls	Complete keybindings, vim navigation, text editing, and slash commands
Configuration Guide	`config.json` schema, settings hub options, and environment variables

Guide	Description
Content Providers	Built-in providers, scrapers, stream extractors, and authentication headers
Hardware Players	Media player detection, launch flags, stream headers, and watch tracking
Batch Downloads	Multi-segment download engine, range resume, and folder layout
Stremio Addons	Addon manifest installation, catalog browsing, and stream resolution
Live TV & IPTV	M3U playlist manager, channel parsing, and live stream playback

Guide	Description
System Architecture	Subsystem diagrams, async event loop, and task cancellation
Module Breakdown	Crate structure, module responsibilities, and call boundaries
Caching Strategy	Binary disk caching, TTL policies, and LRU memory management
Logging System	File logging, log rotation, and tracing diagnostics
Cross-Platform Operations	Platform compatibility matrix across macOS, Linux, Windows, and Termux

Guide	Description
Testing Suite	Unit tests, integration tests, and verification gates
Debugging Guide	Troubleshooting common issues, terminal rendering, and player errors
Release Checklist	Pre-release validation, binary packaging, and deployment workflow
Known Issues	Tracked limitations, terminal quirks, and workarounds
Contributing Guide	Contribution guidelines, code standards, and PR process
Changelog	Complete release history and unreleased changes