parthmax2

parthmax2 / movie-box

Public

Python CLI to search, download & stream movies/TV series — cyberpunk interactive shell, async API, subtitles, MPV/VLC streaming. pip install "movie-box-dl[cli]"

15
3
50% credibility
Found May 17, 2026 at 15 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

movie-box is a Python command-line tool and programming library that lets you search, stream, and download movies and TV series from MovieBox services. It offers an interactive terminal interface with a cyberpunk visual style, supports multiple quality options, includes subtitle downloading, and can stream content directly through media players like MPV or VLC. The project is published on PyPI and maintained by a single developer who includes an educational disclaimer.

How It Works

1
🔍 You discover a movie-watching tool

You hear about movie-box from a friend or online - a command-line tool that lets you search and download movies right from your terminal.

2
💻 You install the tool

You install movie-box on your computer using a simple installation command, and it sets itself up with a colorful cyberpunk-style interface.

3
🎬 You search for a movie

You type in the name of a movie or TV show you want to watch, and movie-box shows you a beautiful table of search results with ratings and details.

4
You choose what to do next
📥
Download the movie

The movie downloads to your computer in your chosen quality, with subtitles automatically included.

▶️
Stream instantly

The movie plays immediately in your media player without taking up space on your hard drive.

5
🎉 You enjoy your movie

Whether downloaded or streamed, you watch your movie with subtitles in your preferred language, all from one simple command.

Sign up to see the full architecture

3 more

Sign Up Free

Star Growth

See how this repo grew from 15 to 15 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is movie-box?

movie-box is a Python CLI tool that lets you search, download, and stream movies and TV series from your terminal. It provides an async Python API alongside a rich command-line interface with a cyberpunk-themed startup animation, interactive shell, and optional Textual dashboard. You can fetch subtitles in multiple languages, choose video quality, and stream directly through MPV or VLC without downloading. Configuration persists across sessions, and a `doctor` command validates your setup.

Why is it gaining traction?

The developer pitch is clear: a scriptable movie downloader with a polished terminal experience. Unlike basic download tools, this offers multiple API versions (v1, v2, v3), resumable downloads, and direct media player streaming. The CLI is designed to feel modern with colored output, numbered selection prompts, and optional ASCII art at startup. If you want to automate media fetching from Python, the Pydantic-validated models and async patterns make it feel like a proper API client rather than a hacky scraper.

Who should use this?

Python developers who want to integrate media discovery into their own tools will find the async API useful. Terminal power users who prefer command-line workflows over GUI apps might appreciate the interactive shell and streaming support. Media enthusiasts comfortable with command-line interfaces and seeking subtitle downloads with quality control could get value from this. Researchers studying API client patterns may find the multi-version architecture worth examining.

Verdict

This is an early-stage project with 15 stars and a 0.5% credibility score, so expect limited documentation and no guarantee of long-term maintenance. The educational disclaimer and reliance on a third-party service mean it could break if upstream changes. Approach with caution: useful for learning Python CLI patterns and async programming, but not production-ready for automated workflows.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.