Skip to content

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

4.7 KB
Raw Blame

Introduction

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

English • বাংলা • हिन्दी • Español

CI crates.io License Telegram Support

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