Terminal interface to find, download, and stream movies, TV shows, and live TV using local media players.
4.7 KB Raw Blame
moviebox-tui-walkthrough.webm
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.
Prerequisites
- 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).
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 |