Terminal interface to find, download, and stream movies, TV shows, and live TV using local media players.
English • বাংলা • हिन्दी • Español
moviebox-tui-walkthrough.webm
- On Demand Streaming: Stream movies, series, and anime across multiple providers and community Stremio addons.
- Live TV and IPTV: Import custom M3U playlist URLs to search channels, browse categories, and stream live television.
- Native Video Playback: Plays directly in your favorite player (
mpv,IINA,VLC, or Android video players) with smooth hardware acceleration. - Automatic Subtitles: Automatically searches and loads subtitles in your preferred language into your player.
- Fast Downloads: Save single episodes or entire seasons to your computer with pause and resume support.
- Visual Posters: Displays cover art and movie posters directly inside your terminal window.
- Library and History: Bookmark your favorite titles and pick up watching right where you left off.
- Custom Themes: Built in color themes and settings to match your personal terminal look and feel.
- Cross Platform: Works identically on macOS, Linux, Windows, and Android.
Requires at least one media player for streaming:
- mpv (recommended across Linux, macOS, and Windows)
- IINA (macOS)
- VLC (cross platform)
- Any Android Video Player via Termux (VLC, Just Player, MX Player)
Poster graphics: Image rendering requires a graphics capable terminal (Ghostty, Kitty, WezTerm, or iTerm2). Standard terminals display clean text layouts automatically.
Optional for MovieBox downloads: yt-dlp and ffmpeg are required only for downloading DASH streams from the MovieBox provider. All other providers download directly with the built in engine.
Automated install:
curl -fsSL https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.sh | bashHomebrew (macOS):
brew tap mesamirh/moviebox-tui https://github.com/mesamirh/MovieBox-Tui
brew install moviebox-tuiNote: If Homebrew prompts for tap verification, run brew trust mesamirh/moviebox-tui.
PowerShell:
irm https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.ps1 | iex- Install dependencies and run the installer:
pkg update && pkg install -y curl tar termux-tools termux-am
curl -fsSL https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.sh | bash- Grant storage permission (required for video players and downloads):
termux-setup-storageCargo and Source Build
From crates.io:
cargo install moviebox-tui --lockedFrom source:
git clone https://github.com/mesamirh/MovieBox-Tui.git
cd MovieBox-Tui
cargo build --release --lockedVerify Release Integrity
sha256sum -c SHA256SUMS --ignore-missing
gh attestation verify <archive-file> -R mesamirh/MovieBox-Tuimoviebox-tui- Type any title to search, press
Enterto play. - Press
?inside the TUI for shortcuts, or type/settingsfor preferences.
Comprehensive guides and architectural references are available at mesamirh.github.io/MovieBox-Tui or in the docs/ directory.
Contributions are welcome. Review CONTRIBUTING.md before submitting pull requests.
Report bugs or submit feature requests through GitHub Issues.
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 |
MovieBox-TUI contains zero telemetry, analytics, or user tracking. All search history, bookmarks, and configuration files remain strictly on your local filesystem.
Licensed under either MIT or Apache-2.0.
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.