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

Open Terminal and run:

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

Or via 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

Open PowerShell and run:

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

Android (Termux)

Open Termux and run:

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

Note: Requires an external video player installed on Android (e.g. VLC or any supported player).

cargo install moviebox-tui --locked

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

sha256sum -c SHA256SUMS --ignore-missing
gh attestation verify <archive-file> -R mesamirh/MovieBox-Tui

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

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.

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.