Why MovieBox-TUI?

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.

Quick Comparison

Features at a Glance

• Search Everything: Find movies, TV shows, anime, and live TV channels across multiple sources (MovieBox, 4KHDHub, BDIX mirrors, and custom IPTV playlists).
• 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.

Installation

Cargo

cargo install moviebox-tui --locked

Homebrew (macOS & Linux)

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

Install Script (macOS & Linux)

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

Windows

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

Android (Termux)

pkg install rust
cargo install moviebox-tui --locked
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
termux-setup-storage

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

Usage

Start 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.

Documentation

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
• Configuration Reference — Config files and environment variables
• Providers — Supported content sources and protocols
• Troubleshooting & Debugging — Fixing common issues and reporting bugs
• Contributing Guide — How to contribute code and submit PRs

Roadmap

• 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.

Feedback & Support

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.

License

Licensed under either MIT or Apache-2.0, at your option.

Disclaimer

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.