# MovieBox-TUI
**Terminal interface to find, download, and stream movies, TV shows, and live TV using local media players.**
[ English ](https://github.com/mesamirh/MovieBox-Tui/blob/HEAD/README.md) • [ বাংলা ](https://github.com/mesamirh/MovieBox-Tui/blob/HEAD/README_BN.md) • [ हिन्दी ](https://github.com/mesamirh/MovieBox-Tui/blob/HEAD/README_HI.md) • [ Español ](https://github.com/mesamirh/MovieBox-Tui/blob/HEAD/README_ES.md)
[](https://github.com/mesamirh/MovieBox-Tui/actions/workflows/ci.yml)
[](https://crates.io/crates/moviebox-tui)
[](#license)
[](https://t.me/getfromme)
[](#optional-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: 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 & Source Build
cargo install moviebox-tui --locked
From source:
git clone https://github.com/mesamirh/MovieBox-Tui.git
cd MovieBox-Tui
cargo build --release --locked
Verify Release Integrity
sha256sum -c SHA256SUMS --ignore-missing
gh attestation verify <archive-file> -R mesamirh/MovieBox-Tui
Uninstall
Re-run install command (`curl ... | bash` or `irm ... | iex`) and select `2) Uninstall`.
Or via package manager:
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/:
| Guide |
Description |
| Keyboard & Controls |
Keybindings, vim navigation, and shortcuts |
| Configuration |
Settings, themes, and environment variables |
| Content Providers |
Native scrapers (MovieBox, 4KHDHub, Dramachi, BDIX) |
| Stremio Addons |
Community addon configuration and streaming |
| Hardware Players |
Player detection, launch options, and flags |
| Live TV & IPTV |
M3U playlist import and channel streaming |
| Batch Downloads |
HTTP range engine, pause, and resume |
Contributing
Review CONTRIBUTING.md before submitting pull requests. Report bugs via GitHub Issues.
Support
| Asset | Address |
| :--- | :--- |
| **USDT (TRC20)** | `TL4yW73qmbKZpBWwbEFgjBpwVkPDFTkJgV` |
| **Bitcoin (BTC)** | `3MEAtqtRWrQBhnaMi3Zuf5nt2efNUS2LUQ` |
| **Ethereum (EVM)** | `0x7ea20d5fa29d87f33195f5a3b211ff94038d794c` |
| **Solana (SOL)** | `6ctm5WFv73MNywoCKAz3xK72yizSspHa72rFNygooU6` |
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.