MovieBox-TUI

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: Direct 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).

Installation

macOS & Linux

If you have Homebrew on macOS:

brew tap mesamirh/moviebox-tui https://github.com/mesamirh/MovieBox-Tui
brew install moviebox-tui

Note: If Homebrew prompts for tap verification on initial install, run brew trust mesamirh/moviebox-tui.

Direct install via Terminal (macOS & Linux, no package manager needed):

curl -fsSL https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.sh | bash

Windows

If you have Scoop (recommended):

scoop bucket add moviebox https://github.com/mesamirh/MovieBox-Tui
scoop install moviebox-tui

Direct install via PowerShell (no package manager needed):

irm https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.ps1 | iex

SmartScreen prompt: If Windows displays "Windows protected your PC", click More info → Run anyway.

Android (Termux)

pkg update && pkg install -y curl tar termux-tools termux-am
curl -fsSL https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.sh | bash
termux-setup-storage

cargo install moviebox-tui --locked

git clone https://github.com/mesamirh/MovieBox-Tui.git
cd MovieBox-Tui
cargo build --release --locked

sha256sum -c SHA256SUMS --ignore-missing
gh attestation verify <archive-file> -R mesamirh/MovieBox-Tui

brew uninstall moviebox-tui     # Homebrew
scoop uninstall moviebox-tui    # Scoop
cargo uninstall moviebox-tui    # Cargo

Quick Start

moviebox-tui

• Type to search, press Enter to play.
• Press ? for shortcuts, or type /settings for preferences.

Documentation

Full documentation at mesamirh.github.io/MovieBox-Tui or docs/:

Contributing

Review CONTRIBUTING.md before submitting pull requests. Report bugs via GitHub Issues.

Privacy

Zero telemetry, analytics, or user tracking. History, favorites, and config remain local.

License

Dual-licensed under MIT or Apache-2.0.

Disclaimer

MovieBox-TUI does not host or store media. It plays publicly available streams. Users must comply with local laws.