MovieBox-Tui

moviebox-tui-walkthrough.webm

Features

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

Prerequisites

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.

Installation

macOS and Linux

Automated install:

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

Homebrew (macOS):

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

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

Windows

PowerShell:

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

Android (Termux)

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

1. Grant storage permission (required for video players and downloads):

termux-setup-storage

Cargo and Source Build

From crates.io:

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  -R mesamirh/MovieBox-Tui

Uninstallation

Automated Installer (macOS, Linux, Windows, Android)

Simply re-run your original install command (curl ... | bash or irm ... | iex). When MovieBox-TUI is already installed, the installer automatically detects it and displays an interactive menu:

MovieBox-TUI is already installed.
What would you like to do?
  1) Reinstall / Update to latest version
  2) Uninstall
  3) Cancel

Enter 2 to completely remove MovieBox-TUI.

Package Managers

brew uninstall moviebox-tui     # Homebrew (macOS)
cargo uninstall moviebox-tui    # Cargo

Quick Start

moviebox-tui

• Type any title to search, press Enter to play.
• Press ? inside the TUI for shortcuts, or type /settings for preferences.

Documentation

Comprehensive guides and architectural references are available at mesamirh.github.io/MovieBox-Tui or in the docs/ directory.

Contributing

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:

Privacy

MovieBox-TUI contains zero telemetry, analytics, or user tracking. All search history, bookmarks, and configuration files remain strictly on your local filesystem.

License

Licensed under either MIT or Apache-2.0.

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.