MovieBox-TUI: a Rust terminal client for searching, streaming and downloading movies, series and IPTV

The gap MovieBox-TUI fills between a browser tab and a media player

Most people who watch movies and series from a computer end up with a browser tab for discovery and a separate player for playback. That split costs you keyboard control: you alt-tab, you fight autoplay, you lose your place. MovieBox-TUI collapses discovery and launch into one terminal window. It searches titles, shows poster art inline, and then hands the actual stream URL to a local player such as mpv, IINA, VLC, or an Android video player under Termux. The audience is narrow and specific: people who already run mpv from the command line, who keep a terminal open all day, and who would rather type a title than click through a web interface. It also targets a second group, IPTV users who maintain M3U playlist URLs and want to search channels and categories without a separate IPTV app. The README is explicit that the project hosts nothing: it describes itself as an independent client for playing publicly available streams, and it puts the compliance question on the user.

How the TUI, providers and local players fit together

The Cargo.toml makes the architecture legible. ratatui and crossterm drive the interface, ratatui-image with the crossterm feature renders posters, and reqwest with rustls handles network calls. hickory-resolver is present for DNS resolution, which matters for provider endpoints that may not resolve through a default system resolver. Playback is not implemented in-process: the open crate is a dependency, and the README states that playback happens in your favorite player with hardware acceleration. So the data flow is search, select, resolve a stream URL, then spawn an external process. Downloads are a separate path. The README says single episodes or entire seasons can be saved with pause and resume, and that most providers download through a built-in engine, while DASH streams from the MovieBox provider specifically require yt-dlp and ffmpeg. That split is the most important operational detail on the page: the same button behaves differently depending on which provider answered the search. State is local. The README states there is zero telemetry and that search history, bookmarks and configuration stay on the local filesystem, which is consistent with the dirs dependency and the absence of any account or sync layer.

Installing MovieBox-TUI and running a first search

On macOS and Linux the README gives a one-line installer, and Homebrew is offered as an alternative for macOS. The installer is idempotent in a useful way: re-running it when the tool is already present shows an interactive menu with reinstall, uninstall and cancel options, so the same command is your update path and your removal path.

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

After it finishes, confirm the binary is on your PATH by launching it with no arguments. The README's quick start is a single command, and the TUI opens with a search field.

moviebox-tui

Type any title, press Enter to play. Inside the TUI, `?` lists shortcuts and `/settings` opens preferences. If you prefer a package manager, the README documents a Cargo install that compiles with the lockfile pinned.

cargo install moviebox-tui --locked

Windows users get a PowerShell equivalent, and Termux users on Android install curl, tar, termux-tools and termux-am before running the same shell installer, then grant storage with `termux-setup-storage` so the player and downloads can reach shared storage. Before any of this, install at least one supported player: mpv is the recommended choice across Linux, macOS and Windows, IINA is macOS only, and VLC works everywhere. If you want poster art rather than text layouts, you need a graphics-capable terminal such as Ghostty, Kitty, WezTerm or iTerm2; the README says standard terminals fall back to clean text automatically, so this is a cosmetic dependency rather than a hard one.

Where MovieBox-TUI stops being the right tool

The external-player design is the project's biggest constraint, not a footnote. MovieBox-TUI does not decode video. If mpv, IINA or VLC is missing or misconfigured, you get a search interface that cannot play anything. There is no fallback player and no bundled decoder, so troubleshooting playback means troubleshooting a different program. The second limitation is provider-shaped. Because streams come from third-party providers and community Stremio addons, the quality, availability and subtitle coverage of any given title depend on what those sources return at that moment. The README does not document a retry or fallback policy when a provider fails, and it does not describe what happens to a download in progress when the underlying stream disappears. Third, the DASH path is heavier than the rest: MovieBox downloads need yt-dlp and ffmpeg present, which the README flags as optional but which stops being optional the moment you want those specific downloads. Fourth, the licensing and legality question is handled by a disclaimer, not by a technical control. The README says the project hosts no media and that users are responsible for complying with the laws of their country. If you need something you can deploy inside a corporate network with a clear content provenance story, this is the wrong category of tool entirely.

How it compares with a web front end for the same sources

The closest alternative in practice is a browser-based front end such as Stremio itself, since MovieBox-TUI explicitly consumes community Stremio addons as one of its sources. The difference is where the work happens. A browser front end renders its own video and manages its own playback session; MovieBox-TUI delegates that to mpv or VLC and keeps only search, metadata, subtitles and download control. That delegation is what buys hardware acceleration and your existing player configuration, including keybindings, shaders and audio output, without the project reimplementing any of it. The cost is a second process to manage and a dependency the project cannot verify. A second alternative is a plain IPTV client for the M3U half of the feature set. If live channels are all you want, a dedicated IPTV player will be simpler, because MovieBox-TUI carries the on-demand provider code and the download engine whether or not you use them. Pick MovieBox-TUI when you want both halves in one keyboard-driven window and you already have a player you trust.

Maintenance, licensing and the cost of upgrading

The repository is not archived, and the last push was on 2026-09-16. Releases have been frequent and small: v0.1.18 on 2026-09-06, v0.1.19 on 2026-09-13, and v0.1.20 on 2026-09-14, with the Cargo.toml version sitting at 0.1.20. That cadence means upgrades arrive often, and the installer's reinstall option is the documented way to take them. The practical upgrade risk is not the binary but the moving parts around it: provider endpoints, Stremio addon responses and M3U playlists are outside the project's control, so a version bump can change behaviour without the code changing at all. Budget time for that rather than assuming a quiet upgrade. On licensing, the README states the project is dual-licensed under MIT or Apache-2.0, matching the `license = "MIT OR Apache-2.0"` field in Cargo.toml and the LICENSE-MIT and LICENSE-APACHE files at the repository root. The Apache-2.0 option includes an explicit patent grant, which matters if you redistribute a modified build. Note that this covers the client only; the streams it resolves carry their own rights, and the README's disclaimer places that responsibility on the user. Nothing here is legal advice, and the disclaimer is the project's own statement of its position.

Editorial conclusion

Adopt MovieBox-TUI if you already live in a terminal, already have mpv or VLC installed, and want search, subtitles, downloads and M3U channel browsing in one window without a browser. Skip it if you need a self-contained player, if your terminal cannot render graphics and poster art matters to you, or if you are unwilling to install yt-dlp and ffmpeg for MovieBox DASH downloads. Before committing, run the installer once, check that moviebox-tui starts and that your chosen player is detected, and confirm the project's own disclaimer position on stream legality for your country.

Frequently asked questions

Official sources

1. License: Apache-2.0
2. mesamirh/MovieBox-Tui on GitHub
3. Project website
4. README
5. Releases