parthmax2/movie-box

movie-box is a Python command line tool for finding, downloading, and streaming movies and TV series from a single program. You install it with pip, then run a command called movie-box or moviebox, and it opens an interactive shell styled like a cyberpunk terminal, with colored text and an animated startup screen. From that shell you can search for a title, see a numbered list of matches, pick one, and either download it or stream it straight away through a media player like MPV or VLC instead of saving a file first. It also fetches matching subtitles in more than one language, and can grab TV episodes by season and episode number, not just full movies. The tool supports several backend API versions internally, and the newer top level commands add a cleaner search table and saved preferences, like a default video quality, language, and download folder, so repeat searches take less typing. Under the hood the project is built with Python, using async code with a synchronous fallback, so it can fetch and download without freezing the interface, and it uses Pydantic models for anyone who wants to call it directly as a Python library rather than through the shell. A built in doctor command checks that Python, the required packages, and any installed media player are set up correctly, which helps catch setup problems early. The interactive interface is organized into separate parts for its color theme, startup animation, command parsing, and an optional full screen dashboard built with Textual. The project states plainly that it is for educational purposes and should only be used with content the user is already allowed to access. It does not host any media files itself and does not claim any connection to MovieBox or similar services, it is simply a client that talks to existing APIs. Anyone considering using it should keep that legal boundary in mind rather than treating it as a free general purpose download service.