Introduction
Terminal interface to find, download, and stream movies, TV shows, and live TV using local media players.
English • বাংলা • हिन्दी • Español
Features
- On Demand Streaming: Stream movies, series, and anime across multiple providers and community Stremio addons.
- Live TV and IPTV: Import custom M3U playlist URLs to search channels, browse categories, and stream live television.
- Native Video Playback: Plays directly in your favorite player (
mpv,IINA,VLC, or Android video players) with smooth hardware acceleration. - Automatic Subtitles: Automatically searches and loads subtitles in your preferred language into your player.
- Fast Downloads: Save single episodes or entire seasons to your computer with pause and resume support.
- Visual Posters: Displays cover art and movie posters directly inside your terminal window.
- Library and History: Bookmark your favorite titles and pick up watching right where you left off.
- Custom Themes: Built in color themes and settings to match your personal terminal look and feel.
- Cross Platform: Works identically on macOS, Linux, Windows, and Android.
Prerequisites
Requires at least one media player for streaming:
- mpv (recommended across Linux, macOS, and Windows)
- IINA (macOS)
- VLC (cross platform)
- Any Android Video Player via Termux (VLC, Just Player, MX Player)
Poster graphics: Image rendering requires a graphics capable terminal (Ghostty, Kitty, WezTerm, or iTerm2). Standard terminals display clean text layouts automatically.
Optional for MovieBox downloads: yt-dlp and ffmpeg are required only for downloading DASH streams from the MovieBox provider. All other providers download directly with the built in engine.
Documentation Directory Map
Getting Started
| 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 |
Features & Modes
| 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 |
Architecture & Internals
| 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 |
Reference & Maintenance
| 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 |