MovieBox

A fast, keyboard-first terminal app for discovering, streaming, and downloading movies, TV shows, anime, and live TV.

MovieBox keeps discovery, playback, downloads, history, and configuration inside a focused terminal workflow.

English • বাংলা • हिन्दी • Español

Demo

moviebox-tui-walkthrough.webm

Language	Rust	Platforms	Linux · macOS · Windows · Android/Termux
Interface	TUI	Players	mpv · IINA · VLC · Android players
Privacy	Local-first	Telemetry	None

Why MovieBox

MovieBox is designed around a simple idea: make media discovery feel as quick as using the terminal itself. You search, choose a result, launch your player, and keep your library local.

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.

Downloads: MovieBox uses its built-in Rust downloader for progressive files and automatically bootstraps the official yt-dlp binary when adaptive MPEG-DASH downloading needs it. VLC/mpv remains available as a seamless fallback when local FFmpeg support is unavailable.

Installation

Choose the path that fits your setup. Prebuilt installers use the project's published release artifacts when available; building from source is always supported.

macOS and Linux

Open Terminal and run:

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

Or via Homebrew (macOS):

brew tap Mrminecope/moviebox https://github.com/Mrminecope/MovieBox
brew install moviebox

Note: If Homebrew prompts for tap verification, run brew trust Mrminecope/moviebox.

Windows

Open PowerShell and run:

irm https://raw.githubusercontent.com/Mrminecope/MovieBox/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/Mrminecope/MovieBox/main/install.sh | bash
termux-setup-storage

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

Cargo and Source Build

From crates.io:

cargo install moviebox --locked

From source:

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

Uninstallation

Automated Installer (macOS, Linux, Windows, Android)

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

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

Package Managers

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

Quick Start

moviebox

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

Documentation

Start with the MovieBox website or browse the docs/ directory for installation, controls, configuration, providers, architecture, downloads, testing, and troubleshooting.

Project

• Repository: https://github.com/Mrminecope/MovieBox
• Releases: https://github.com/Mrminecope/MovieBox/releases
• Website: https://mrminecope.github.io/MovieBox/
• Changelog: CHANGELOG.md
• Issues: https://github.com/Mrminecope/MovieBox/issues

Releases

Tagged releases are built automatically for the supported platforms. See RELEASING.md for the maintainer release process.

Contributing

Contributions are welcome. Review CONTRIBUTING.md before submitting pull requests.

Report bugs or submit feature requests through GitHub Issues.

Privacy

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

Author

Created and maintained by Mrminecope. See AUTHORS.md.