Terminal interface to find, download, and stream movies, TV shows, and live TV using local media players.
MovieBox-TUI
Interfaz de terminal para buscar, descargar y transmitir películas, series y TV en vivo mediante reproductores locales.
Características
- Streaming: Películas, series, anime, dramas asiáticos y complementos comunitarios de Stremio en múltiples proveedores nativos.
- TV en vivo: Importación de listas M3U con categorías de canales, soporte EPG y búsqueda.
- Selector de resolución: Selección directa de calidad de stream (
4K,1080p,720p,480p,Auto) antes de reproducir. - Reproductores por hardware: Inicio directo en
mpv,VLCoIINAcon reenvío de cabeceras de autenticación y cookies. - Descargador por lotes: Descargador concurrente multisegmento con pausa y reanudación por rangos HTTP para episodios y temporadas completas.
- Selector de subtítulos: Pistas de subtítulos en múltiples idiomas extraídas y seleccionables mediante un selector interactivo antes de reproducir o descargar.
- Interfaz de terminal: Navegación Vim, soporte de ratón, paleta de comandos (
/help,/settings) y 9 temas integrados. - Carátulas: Renderizado nativo de pósters con Kitty, Sixel e iTerm2 con alternativa automática en texto.
- Reanudación y biblioteca: Marcas de tiempo de continuar viendo, historial y favoritos almacenados localmente en disco. Cero telemetría.
Requisitos previos
- Reproductor multimedia:
mpv,VLCoIINA(macOS) / cualquier reproductor de video externo (Android). - Pósters: Terminal con soporte Sixel, Kitty o iTerm2 (Ghostty, Kitty, WezTerm, iTerm2, foot, Windows Terminal v1.22+).
- Descargas DASH:
yt-dlpyffmpeg(requeridos solo para descargas DASH de MovieBox).
Instalación
macOS y Linux
Si tienes Homebrew en macOS:
brew tap mesamirh/moviebox-tui https://github.com/mesamirh/MovieBox-Tui
brew install moviebox-tui
Nota: Si Homebrew solicita verificación de tap en la instalación inicial, ejecuta
brew trust mesamirh/moviebox-tui.
Instalación directa mediante Terminal (macOS y Linux, sin necesidad de gestor de paquetes):
curl -fsSL https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.sh | bash
Windows
Si tienes Scoop (recomendado):
scoop bucket add moviebox https://github.com/mesamirh/MovieBox-Tui
scoop install moviebox-tui
Instalación directa mediante PowerShell (sin necesidad de gestor de paquetes):
irm https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.ps1 | iex
Aviso de SmartScreen: Si Windows muestra "Windows protegió su PC", haz clic en Más información → Ejecutar de todas formas.
Android (Termux)
Abre Termux y ejecuta:
pkg update && pkg install -y curl tar termux-tools termux-am
curl -fsSL https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.sh | bash
termux-setup-storage
[!IMPORTANT] La reproducción de video en Android se abre mediante tu reproductor externo instalado (como VLC, Just Player, o MX Player).
Instalación con Cargo o compilación desde el código fuente
Desde crates.io:
cargo install moviebox-tui --locked
Compilar desde el código fuente:
git clone https://github.com/mesamirh/MovieBox-Tui.git
cd MovieBox-Tui
cargo build --release --locked
Verificación de integridad de la versión
sha256sum -c SHA256SUMS --ignore-missing
gh attestation verify <archive-file> -R mesamirh/MovieBox-Tui
Desinstalar
Vuelve a ejecutar el comando de instalación (curl ... | bash o irm ... | iex) y selecciona 2) Uninstall.
O mediante gestor de paquetes:
brew uninstall moviebox-tui # Homebrew
scoop uninstall moviebox-tui # Scoop
cargo uninstall moviebox-tui # Cargo
Inicio rápido
moviebox-tui
- Escribe cualquier título para buscar, presiona
Enterpara reproducir. - Presiona
?dentro de la interfaz para ver los atajos, o escribe/settingspara abrir las preferencias.
Documentación
Las guías completas y referencias de arquitectura están disponibles en mesamirh.github.io/MovieBox-Tui o en el directorio docs/:
| Guía | Descripción |
|---|---|
| Teclado y Controles | Atajos de teclado, navegación vim, búsqueda y comandos |
| Configuración | Opciones de configuración, personalización de temas y variables de entorno |
| Proveedores de Contenido | Scrapers nativos (MovieBox, 4KHDHub, Dramachi, BDIX) |
| Complementos de Stremio | Instalación de addons comunitarios, URLs de manifiestos y resolución de streams |
| Reproductores Multimedia | Detección de reproductores, opciones de inicio y aceleración por hardware |
| TV en vivo e IPTV | Importación de listas M3U, búsqueda de canales y streaming en vivo |
| Descargas por Lotes | Descargas multisegmento por rangos HTTP con soporte de pausa y reanudación |
Contribuir
Cualquier contribución es bienvenida. Revisa CONTRIBUTING.md antes de enviar pull requests.
Reporta errores o sugiere nuevas funciones a través de GitHub Issues.
Apoyo opcional
Si deseas apoyar el desarrollo continuo directamente:
| Red / Criptomoneda | Dirección |
|---|---|
| USDT (TRC20) | TL4yW73qmbKZpBWwbEFgjBpwVkPDFTkJgV |
| Bitcoin (BTC) | 3MEAtqtRWrQBhnaMi3Zuf5nt2efNUS2LUQ |
| Ethereum / EVM | 0x7ea20d5fa29d87f33195f5a3b211ff94038d794c |
| Solana (SOL) | 6ctm5WFv73MNywoCKAz3xK72yizSspHa72rFNygooU6 |
Privacidad
MovieBox-TUI contiene cero telemetría, análisis o seguimiento de usuarios. Todo el historial de búsqueda, marcadores y archivos de configuración permanecen estrictamente en tu sistema de archivos local.
Licencia
Distribuido bajo licencias MIT o Apache-2.0.
Descargo de responsabilidad
Este proyecto no aloja ni almacena ningún contenido multimedia. Es un cliente independiente para reproducir transmisiones de video disponibles públicamente. Los usuarios son responsables de cumplir con las leyes de sus respectivos países.