MovieBox-Tui

What is this?

MovieBox-Tui is a terminal-based streaming client. It interfaces with the MovieBox to search catalogs, resolve stream URLs, and open them in your local video player (mpv, IINA, or VLC).

No browser or configuration is required. Search for a title, select a video quality, and press enter to play or download the stream.

Disclaimer: This project is a third-party client. It does not host, store, or redistribute any media. It strictly resolves links provided by the upstream API. It is intended for educational and personal use only. You are responsible for complying with copyright law in your jurisdiction.

Screenshots

Features

• Search & discover easily: Just start typing to find what you want, or use commands like /movies and /anime to see what's trending.
• All the details you need: Select a title to see its poster, IMDb rating, release year, genre, and a quick summary.
• Play instantly: The app grabs different stream qualities (like 1080p and 720p) behind the scenes. Pick your resolution and subtitles, and it starts playing immediately.
• Built-in fast downloader:
  • Download videos straight to your disk using multiple connections to max out your internet speed. You get live speed and ETA updates while you wait.
  • Subtitles included: It automatically grabs the .srt subtitle files to match your video.
  • Download entire seasons: Queue up a whole season at once. Just tell it what language you want for the subtitles, and it handles the rest automatically.
• Live TV Mode: Press Ctrl+T to switch to TV mode and watch thousands of live IPTV channels from around the world straight from your terminal.
• Works on your terminal: Whether you're on macOS, Linux, or Windows, it just works. If your terminal supports it, you'll get actual image posters; otherwise, it falls back nicely to text.

What you'll need

1. A Terminal: Any terminal works! Just make sure your window is at least 85×24 characters. If you use a modern terminal, you'll even get high quality native image posters automatically.
2. A Video Player: You'll need mpv, IINA (for macOS), or VLC installed. The app will automatically find whichever one you have and use it.

# macOS
brew install mpv
# or
brew install --cask iina

# Debian / Ubuntu
sudo apt install mpv

# Arch Linux
sudo pacman -S mpv

# Windows
choco install mpv

Installation

The easiest way to get started is by using the quick install scripts below. If you're a Rust developer, you can also just grab it from Cargo.

macOS & Linux

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

Windows

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

Cargo (Rust)

cargo install moviebox-tui

Getting Started

Just open your terminal and type moviebox-tui to jump in.

Here's how to get around:

• Search: Just start typing! It searches instantly.
• Navigate: Use the Up / Down / Left / Right arrow keys.
• Select: Press Enter to view details, pick episodes, or start playing a video.
• Switch Player: Press o on a stream if you want to open it in a different video player.
• Download: Press d on any episode or season to save it to your disk (you'll get to pick your subtitles first).
• Live TV: Press Ctrl+T to toggle Live TV mode and browse IPTV channels.
• Refresh: Press r if a stream link expires and needs to be re-fetched.
• Help: Need a quick reminder? Press ? anywhere to see the cheat sheet.
• Quit: Press q to exit (use Esc to go back or clear search).

Handy Slash Commands

You can type these special commands straight into the search bar:

General commands:

• /clear-cache - Free up disk space by wiping downloaded images and cache.
• /update - Check to see if there's a new version of the app.
• /toggle-update - Turn automatic background update checking on or off.

Streaming Mode commands:

• /discover or /home - See what's trending right now.
• /movies, /shows, /anime - Jump straight to a specific category.

Live TV Mode commands:

• /list - Show the list of available live channels.
• /config - Open the TV configuration menu to add your own m3u playlists.

Contributing

I'd love your help making this even better! If you've got a big feature in mind, it's usually best to open an issue first so we can chat about it.

git clone https://github.com/<your-username>/MovieBox-Tui.git
cd MovieBox-Tui
cargo build

Just try to follow Conventional Commits and make sure cargo fmt and cargo clippy are happy before you open a PR. You can check out CONTRIBUTING.md for the full rundown.

Credits

Live TV channel playlists are graciously provided by iptv-org/iptv.

Support

If this TUI makes your movie nights better and you want to support its development, crypto tips are always super appreciated:

• EVM (ETH, BNB, Polygon, etc): 0x7ea20d5fa29d87f33195f5a3b211ff94038d794c
• BTC: 3MEAtqtRWrQBhnaMi3Zuf5nt2efNUS2LUQ
• LTC: ltc1qhjkq2n6tsayxj56n3c53uqv23v8vqhvc9g3vxl