Watch and download movies, TV shows, anime, and live TV right in your terminal — without opening a browser.
moviebox-tui.webm
Searching and watching media through web browsers often means dealing with heavy memory usage from multiple open tabs, intrusive popups, tracking scripts, and clunky web players.
MovieBox-TUI replaces the web browser workflow with a lightweight terminal interface. It extracts stream links directly and launches them in your preferred local media player (mpv, VLC, or IINA), with no ads or popups inside the application.
| Feature | Streaming in a Web Browser | MovieBox-TUI in Your Terminal |
|---|---|---|
| Resource Usage | Heavy browser process overhead | ~5 MB RAM (no web engine required) |
| In-App Experience | Popups, redirects, and tracking scripts | No ads or popups inside the application |
| Video Player | Browser web player | Direct playback in mpv, VLC, or IINA |
| Account & Login | Forced account creation & signups | No account or login required |
| Subtitles | Manual search and file renaming | Automatic subtitle downloads in your language |
| Downloads | Manual single-file downloads | 1-click full season batch downloads |
| File Organization | Cluttered downloads folder | Clean, organized Movies and Series folders |
- Search Everything: Find movies, TV shows, anime, and live TV channels across multiple sources (MovieBox, 4KHDHub, BDIX mirrors, community HTTP addons, and custom IPTV playlists).
- Addon Mode: Install community HTTP addon manifests for custom catalog metadata (Cinemeta, Anime Kitsu) and direct stream resolution.
- Smooth Video Playback: Plays directly in mpv, VLC, or IINA using your computer's hardware for smooth video.
- Easy Downloads: Download single episodes or entire seasons with one keypress. Completed episodes are skipped automatically.
- Simple Terminal Interface: Full keyboard and mouse support, beautiful color themes, and movie poster art.
A media player (mpv, VLC, or IINA) is recommended for video playback.
Using Homebrew:
brew tap mesamirh/moviebox-tui https://github.com/mesamirh/MovieBox-Tui
brew install mesamirh/moviebox-tui/moviebox-tuiOr using the automated installer:
curl -fsSL https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.sh -o install.sh && bash install.sh(Or download the prebuilt MovieBox_macOS_Universal.tar.gz from GitHub Releases)
Using the automated installer (installs prebuilt static binary to ~/.local/bin):
curl -fsSL https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.sh -o install.sh && bash install.shOr manual installation:
curl -LO https://github.com/mesamirh/MovieBox-Tui/releases/latest/download/MovieBox_Linux_x64.tar.gz
tar -xzf MovieBox_Linux_x64.tar.gz
mkdir -p ~/.local/bin && mv moviebox-tui ~/.local/bin/Using PowerShell:
irm https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.ps1 | iexOr manual installation:
- Download
MovieBox_Windows_x64.zip(orMovieBox_Windows_arm64.zip) from GitHub Releases. - Extract the archive and place
moviebox-tui.exein your PATH (e.g.%LOCALAPPDATA%\Programs\MovieBox-Tui\bin).
(Note: If Windows SmartScreen displays an "Unknown Publisher" prompt on first launch, click More info → Run anyway)
Using the automated installer (installs prebuilt static ARM64 binary into $PREFIX/bin):
curl -fsSL https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.sh -o install.sh && bash install.sh
termux-setup-storage(Or compile natively via Cargo: pkg install rust && cargo install moviebox-tui --locked)
From Source / Cargo (Developers)
cargo install moviebox-tui --lockedgit clone https://github.com/mesamirh/MovieBox-Tui.git
cd MovieBox-Tui
cargo build --release --lockedVerify Release Integrity & Provenance
sha256sum -c SHA256SUMS --ignore-missinggh attestation verify <archive-file> -R mesamirh/MovieBox-TuiStart the app:
moviebox-tui- Interactive Help: Press
?inside the app anytime to view all keyboard shortcuts and mouse actions. - Mouse & Keyboard: Full mouse navigation and keyboard controls are supported throughout the application.
- Full Reference: See Controls & Shortcuts for the complete list of keybindings and slash commands.
All in-depth guides and technical details are available in the docs/ directory:
- Controls & Shortcuts — Complete keyboard shortcuts, mouse actions, and slash commands
- Architecture & Data Flow — How the app works under the hood
- Media Players — Supported players, custom paths, and launch options
- Downloads & Organization — Folder layout, batch downloading, and subtitles
- Live TV & Playlists — How to add and manage custom M3U playlists
- Addon Mode & HTTP Addons — How to install and manage community HTTP addon manifests
- Configuration Reference — Config files and environment variables
- Providers — Supported content sources and protocols
- Troubleshooting & Debugging — Fixing common issues and reporting bugs
- Testing & QA Architecture — Testing philosophy, unit/integration suites, and QA guidelines
- Contributing Guide — How to contribute code and submit PRs
- Terminal UI (TUI): Interactive terminal application with mouse and keyboard navigation, stream playback, and batch downloading.
- Command-Line Interface (CLI): Direct command-line flags and arguments for headless searching, streaming, and scripted downloading.
- Desktop GUI Client: Dedicated graphical desktop application powered by the same backend stream engine.
If you find the project useful, here are a few simple ways to support it:
- Star the repository on GitHub to help others discover it.
- Report bugs or request features by opening an issue.
- Share the project with friends, colleagues, or terminal enthusiasts.
- Contribute improvements to scrapers, performance, or docs via pull requests.
Optional Support
If you would like to support ongoing development directly:
| Network / Asset | Address |
|---|---|
| USDT (TRC20) | TL4yW73qmbKZpBWwbEFgjBpwVkPDFTkJgV |
| Bitcoin (BTC) | 3MEAtqtRWrQBhnaMi3Zuf5nt2efNUS2LUQ |
| Ethereum / EVM | 0x7ea20d5fa29d87f33195f5a3b211ff94038d794c |
| Solana (SOL) | 6ctm5WFv73MNywoCKAz3xK72yizSspHa72rFNygooU6 |
Licensed under either MIT or Apache-2.0, at your option.
This project does not host or store any media. It is an independent client for playing publicly available streams. Users are responsible for complying with the laws of their country.