🎬 Moviebox Enhanced

Ultimate Python wrapper for moviebox.ph with Enhanced Interactive TUI

Search • Download • Stream movies and TV series with a beautiful terminal interface

Features • Installation • Quick Start • Documentation

✨ What's New in Enhanced Edition

🚀 Streamlined TV Series UX - Direct episode access, skip menus!
🎨 Animation Search - Dedicated tab for anime & animated content
📊 Smart Pagination - Total counts & estimated pages
🎭 Enhanced Quality Selection - 4 quality levels, 10+ subtitle languages
🌐 Mirror Servers - 7 server options for reliability
💻 Cross-Platform Installers - One-click install for Linux/Mac/Windows/Android

🎯 Features

🎬 Enhanced Interactive TUI

📺 Streamlined TV Series

Direct Episode Access - Skip action menus, go straight to episodes
Full Season Browser - See all seasons and episodes instantly
Binge-Watching Friendly - Optimized for marathon viewing
Episode Counts - Know exactly how many episodes available

🎨 Animation Search

Dedicated Search Tab - Menu option [3] for anime/animated content
Specialized Results - Filtered for animation content
Same Features - All TUI enhancements work for anime

📊 Smart Pagination

Total Item Counts - See total results across all pages
Page Estimates - "Page 2 of ~9+" display
Better Navigation - Previous/Next with context

⚙️ Quality & Subtitles

Quality Options:

🎬 BEST - Highest available (Recommended)
📺 1080P - Full HD
💿 720P - HD
📱 480P - SD

Subtitle Languages: 🇮🇩 Indonesian • 🇬🇧 English • 🇪🇸 Spanish • 🇫🇷 French
🇨🇳 Chinese • 🇯🇵 Japanese • 🇰🇷 Korean • 🇸🇦 Arabic
🇵🇹 Portuguese • 🇷🇺 Russian • + Custom

📥 Core Features

⚡ Super Fast Downloads - 5x faster than standard downloads
🎥 Stream with MPV/VLC - Watch without downloading
📝 Smart Subtitles - Auto-download in your language
🔄 Async Support - Fully asynchronous operations
🐍 Clean Python API - Easy integration with Pydantic models
🔍 Search & Discovery - Find trending and popular content

📦 Installation

🚀 Quick Install (Recommended)

Choose your platform:

🐧 Linux / 🍎 macOS

git clone https://github.com/orionbyte-85/moviebox-api.git
cd moviebox-api
chmod +x install.sh
./install.sh

Then activate and run:

source .venv/bin/activate
moviebox interactive

🪟 Windows (PowerShell)

git clone https://github.com/orionbyte-85/moviebox-api.git
cd moviebox-api
.\install.ps1

Then activate and run:

.\.venv\Scripts\Activate.ps1
moviebox interactive

🪟 Windows (CMD)

git clone https://github.com/orionbyte-85/moviebox-api.git
cd moviebox-api
install.bat

Then activate and run:

.venv\Scripts\activate.bat
moviebox interactive

📱 Android (Termux)

pkg install git -y
git clone https://github.com/orionbyte-85/moviebox-api.git
cd moviebox-api
chmod +x install-termux.sh
./install-termux.sh
source ~/.bashrc
moviebox-interactive

Note: Use Termux from F-Droid, not Play Store!

📚 Detailed Installation

See INSTALL.md for:

Manual installation steps
Troubleshooting guide
Platform-specific tips
Media player setup

🎯 Install from PyPI (Original)

For the original package (without enhancements):

pip install "moviebox-api[cli]"

Why install from source instead?

✅ Get latest enhanced features
✅ Streamlined TV series UX
✅ Animation search tab
✅ Direct episode access
✅ Your custom modifications

🚀 Quick Start

Interactive Menu (Easiest)

moviebox interactive

╔══════════════════════════════════════════╗
║                                          ║
║  🎬 MOVIEBOX - Stream & Download         ║
║                                          ║
╚══════════════════════════════════════════╝

[1] 🎬 Search Movies
[2] 📺 Search TV Series
[3] 🎨 Search Animation     ← NEW!
[4] 📚 Search All Content
[5] ⭐ Trending
[0] 🚪 Exit

Enhanced Workflow:

Select [3] Animation for anime
Search: "Demon King Academy"
Instantly see episodes (no action menu!)
Pick episode → Stream or Download
Select quality → Choose subtitles
Watch! 🍿

Command Line Examples

# Download movie
moviebox download-movie "Avatar"

# Download TV series episode
moviebox download-series "Game of Thrones" -s 1 -e 1

# Stream with MPV (requires mpv player)
moviebox download-movie "Avatar" --stream-via mpv

# Download with specific quality
moviebox download-movie "Avatar" --quality 1080p

# Download with subtitles
moviebox download-series "Breaking Bad" -s 1 -e 1 --language Indonesian

Python API

from moviebox_api import MovieAuto
import asyncio

async def main():
    auto = MovieAuto()
    movie_file, subtitle_file = await auto.run("Avatar")
    print(f"Downloaded: {movie_file.saved_to}")

asyncio.run(main())

📖 Documentation

📚 Guides

Installation Guide - Detailed setup for all platforms
API Documentation - Full API reference
Examples - Code examples and use cases

⚡ Quick Reference

Download Commands

Movies:

moviebox download-movie "Title" [OPTIONS]
  -y, --year YEAR           Filter by year
  -q, --quality QUALITY     Video quality
  -x, --language LANGUAGE   Subtitle language
  -Y, --yes                 Auto-confirm
  -X, --stream-via PLAYER   Stream instead of download

TV Series:

moviebox download-series "Title" -s SEASON -e EPISODE [OPTIONS]
  -l, --limit NUMBER        Episodes to download
  -A, --auto-mode          Download all seasons
  --format group           Organize by season folders

Mirror Servers

If default server is slow or blocked:

# Show available mirrors
moviebox mirror-hosts

# Set environment variable
export MOVIEBOX_API_HOST="h5.aoneroom.com"  # Linux/Mac
set MOVIEBOX_API_HOST=h5.aoneroom.com       # Windows

Available mirrors:

h5.aoneroom.com
movieboxapp.in
moviebox.pk
moviebox.ph
moviebox.id
v.moviebox.ph
netnaija.video

Media Players

Install MPV (Recommended):

# Ubuntu/Debian
sudo apt install mpv

# macOS
brew install mpv

# Windows
# Download from https://mpv.io/installation/

# Termux
pkg install mpv

Stream Example:

moviebox download-movie "Avatar" --stream-via mpv --quality 720p

🎨 Features Showcase

Before vs After

Before (Original):

TV Series → Actions Menu → [3] View Episodes → Episodes
3 clicks, slow navigation

After (Enhanced):

TV Series → Episodes Immediately! ✨
1 click, instant access

Enhanced Features

Feature	Original	Enhanced	Benefit
TV Series Access	3 clicks	1 click	⚡ Faster
Animation Search	No	Yes	🎨 Dedicated
Pagination Info	Basic	Smart	📊 Detailed
Subtitle Languages	Manual	10+ options	🌍 Global
Episode Data	Limited	Complete	📺 Full info
Installation	Pip only	4 platforms	💻 Universal

🛠️ Advanced Usage

Batch Downloads

Download entire series:

moviebox download-series "Breaking Bad" -s 1 -e 1 --auto-mode

Organize by folders:

moviebox download-series "Game of Thrones" -s 1 -e 1 \
  --auto-mode --format group

Custom Configuration

from moviebox_api import MovieAuto

auto = MovieAuto(
    caption_language="Spanish",
    quality="720p",
    download_dir="~/Movies"
)

Progress Tracking

async def progress_callback(progress):
    percent = (progress.downloaded_size / progress.expected_size) * 100
    print(f"[{percent:.1f}%] {progress.saved_to.name}")

await auto.run("Avatar", progress_hook=progress_callback)

🔧 Troubleshooting

Virtual Environment Issues

"externally-managed-environment" error:

The installer automatically handles this by using venv pip directly.

Manual fix:

.venv/bin/pip install -e ".[cli]"  # Use venv pip explicitly

Windows PowerShell Security

"Cannot load script" error:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Termux Installation

Package errors:

pkg update && pkg upgrade
pkg install python build-essential

Use F-Droid version for best compatibility.

🤝 Contributing

Contributions welcome! This is an enhanced fork focused on TUI improvements.

Original Repository: Simatwa/moviebox-api

Development Setup

git clone https://github.com/orionbyte-85/moviebox-api.git
cd moviebox-api
python -m venv .venv
source .venv/bin/activate
pip install -e ".[cli]"

📜 License

This is free and unencumbered software released into the public domain (Unlicense).

See LICENSE for details.

⚠️ Disclaimer

"All videos and pictures on MovieBox are from the Internet, and their copyrights belong to the original creators. We only provide webpage services and do not store, record, or upload any content."
— moviebox.ph

This tool is for educational purposes. Respect copyright laws in your jurisdiction.

🌟 Acknowledgments

Original Author: Simatwa for the amazing base project
Contributors: See contributors page
You: For using and improving this project!

🎬 Ready to Watch?

git clone https://github.com/orionbyte-85/moviebox-api.git
cd moviebox-api
./install.sh
source .venv/bin/activate
moviebox interactive

Made with ❤️ for the community

⬆ Back to Top

Name		Name	Last commit message	Last commit date
Latest commit History 5 Commits
assets		assets
docs		docs
src/moviebox_api		src/moviebox_api
tests		tests
.gitignore		.gitignore
.python-version		.python-version
INSTALL.md		INSTALL.md
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
install-termux.sh		install-termux.sh
install.bat		install.bat
install.ps1		install.ps1
install.sh		install.sh
pyproject.toml		pyproject.toml
test-install-scripts.sh		test-install-scripts.sh
test-windows-scripts.ps1		test-windows-scripts.ps1
uv.lock		uv.lock

Folders and files

Latest commit

History

Repository files navigation

🎬 Moviebox Enhanced

✨ What's New in Enhanced Edition

🎯 Features

🎬 Enhanced Interactive TUI

📥 Core Features

📦 Installation

🚀 Quick Install (Recommended)

📚 Detailed Installation

🎯 Install from PyPI (Original)

🚀 Quick Start

Interactive Menu (Easiest)

Command Line Examples

Python API

📖 Documentation

📚 Guides

⚡ Quick Reference

🎨 Features Showcase

Before vs After

Enhanced Features

🛠️ Advanced Usage

Batch Downloads

Custom Configuration

Progress Tracking

🔧 Troubleshooting

🤝 Contributing

Development Setup

📜 License

⚠️ Disclaimer

🌟 Acknowledgments

🎬 Ready to Watch?

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages