🌐 Selecciona tu idioma / Select your language:
🇪🇸 Español | 🇬🇧 English
Aplicación de escritorio en Python + CustomTkinter para descargar y convertir video y audio de más de 1800 sitios, usando el motor de código abierto yt-dlp. Incluye una versión de consola para Termux (Android).
Nota de licencia: proyecto Open Source bajo licencia MIT. Todo el código fuente está en este repositorio. Los binarios compilados, si se publican, se ofrecen solo por comodidad del usuario final.
- Vista previa
- Descargo de responsabilidad
- Características
- Instalación
- Ejecución
- Guía de uso
- Archivos que crea la aplicación
- Solución de problemas
- Licencia y apoyo
⚠️ IMPORTANTE: MediaFlow Utility Pro existe exclusivamente para gestionar y descargar contenido al que el usuario ya tiene derecho de acceso legal, o que está en dominio público o bajo licencias Creative Commons.
- Responsabilidad del usuario: el usuario es el único responsable de que su uso cumpla las leyes locales, los derechos de autor y los términos de servicio de cada plataforma.
- Uso no promovido: los desarrolladores NO avalan ni promueven el uso de esta herramienta para infringir la propiedad intelectual.
- Cualquier uso indebido es responsabilidad exclusiva del usuario final.
Descargas
- 📋 Cola de descargas: pega varias URLs (una por línea), usa el botón Pegar o importa un
.txt. Un contador muestra cuántas hay en cola. - 🎯 El formato que eliges es el que obtienes: si el sitio no ofrece ese formato, el archivo se convierte al final. En mp4 y mkv solo se copian los streams (remux), así que tarda segundos y no pierde calidad.
- 🎞️ Video: MP4, MKV o WebM, con resolución máxima de 480p a 4K (2160p).
- 🎵 Audio: MP3, M4A o WAV a 192 kbps.
- ⏹️ Cancelar en cualquier momento: detiene la cola y borra los archivos a medias (
.part, streams sin unir, miniaturas). Nunca borra un archivo ya terminado. - 📊 Progreso detallado: título, porcentaje, velocidad, tiempo restante y posición en la cola (
Cola 2/5). Al terminar, un resumen indica cuántas descargas funcionaron y cuáles fallaron.
Metadatos
- 🏷️ Etiquetas limpias para música: de un título como
Artista - Canción (Official Video) [4K]obtiene el artistaArtistay el títuloCanción. También escribe fecha, género, descripción, URL de origen y capítulos. - 🖼️ Carátula incrustada: cuadrada en MP3 y M4A (como en los reproductores de música) y con la miniatura original en MP4 y MKV. WAV y WebM no admiten carátula; en ellos solo se escriben las etiquetas.
Red y autenticación
- 🔑 Cookies: desde un archivo
cookies.txt(formato Netscape) o leídas directamente de tu navegador (Firefox, Chrome, Edge, Brave, Opera). Permiten descargar contenido que requiere iniciar sesión en una cuenta válida. - 🔒 Proxies HTTP / SOCKS5: se obtienen de listas públicas o de tus propias APIs, se editan a mano y se prueba cuáles funcionan.
Otros
- 🎨 Interfaz moderna en tema oscuro, que se adapta a pantallas pequeñas.
- ✅ Detección de FFmpeg: la app avisa si no lo encuentra.
- 🔔 Notificaciones de Windows al terminar la cola (opcional, ver instalación).
- 🚀 Lanzadores
start.bat(Windows) ystart.sh(Linux/macOS): instalan dependencias, actualizan yt-dlp y abren la app. - 📱 Versión de consola para Termux: un script aparte en
termux_version/, con menú interactivo.
Requisitos: Python 3.10+ y FFmpeg. Sin FFmpeg no se pueden unir audio y video, convertir formatos ni incrustar metadatos.
git clone https://github.com/FaydevOps/MediaFlow-Utility-Pro
cd MediaFlow-Utility-Pro| Sistema | Comando |
|---|---|
| Windows | winget install Gyan.FFmpeg (o descarga los binarios de ffmpeg.org y añade su carpeta bin al PATH) |
| Debian / Ubuntu | sudo apt install ffmpeg python3 python3-pip python3-venv python3-tk |
| Arch | sudo pacman -S ffmpeg python python-pip tk |
| Fedora | sudo dnf install ffmpeg python3 python3-pip python3-tkinter |
| macOS | brew install ffmpeg python python-tk (requiere Homebrew) |
| Termux (Android) | pkg update && pkg install ffmpeg python |
En Linux, el paquete tk (
python3-tk/tk/python3-tkinter) es necesario para la interfaz gráfica.
Si usas los lanzadores
start.batostart.sh, puedes saltarte este paso: lo hacen ellos.
python3 -m venv venv
source venv/bin/activate # Windows: .\venv\Scripts\activate
pip install --upgrade pip
pip install -r requirements.txtOpcional: para recibir notificaciones de Windows al terminar la cola, instala también pip install win10toast.
Instalan o actualizan las dependencias y yt-dlp, y luego abren la interfaz.
- Windows 10 / 11: doble clic en
start.bat. - Linux / macOS: también instala los paquetes del sistema y crea un entorno virtual
env_downloader.chmod +x start.sh ./start.sh
Con las dependencias ya instaladas (y el entorno virtual activado, si lo usas):
python MultiDownloaderv.pytermux-setup-storage # permite guardar en ~/storage/downloads
pip install yt-dlp rich requests
cd termux_version
bash termuxupdate.sh # actualiza yt-dlp y abre el menúLa versión de consola descarga una URL a la vez: video + audio, solo audio o solo video, con elección de calidad, formato y proxy.
-
Añade las URLs: pégalas en la caja (una por línea), usa 📋 Pegar o 📂 Importar .txt.
-
Elige el destino: botón Buscar. Por defecto es tu carpeta
Descargas. -
Elige formato y calidad:
Quiero… Formato Video Formato Audio Botón Video tal como lo da el sitio OriginalOriginal⬇️ DESCARGAR COLA Video en un formato concreto mp4/mkv/webm— ⬇️ DESCARGAR COLA o 🎬 Solo Video Solo el audio — mp3/m4a/wav🎵 Solo Audio - Resolución Video es un máximo: con
1080pse baja la mejor calidad disponible hasta 1080p. - 🎵 Solo Audio y 🎬 Solo Video usan el formato elegido en el menú; si está en
Original, usan MP3 y MP4.
- Resolución Video es un máximo: con
-
Metadatos: deja marcada "Incrustar carátula y metadatos" para que el archivo lleve título, artista y carátula.
-
Descarga: sigue el progreso en la barra inferior. Pulsa ⏹ Cancelar para detener la cola.
Activa "Usar autenticación (cookies)" y elige el método:
- archivo (el más fiable): exporta las cookies con una extensión como Get cookies.txt LOCALLY y cárgalas con Seleccionar cookies.txt. El botón Ayuda explica el formato.
- navegador: la app lee las cookies del navegador elegido. Con Firefox funciona bien. Chrome, Edge, Brave y Opera cifran sus cookies en Windows y pueden fallar; en ese caso usa el método archivo.
Activa Habilitar Proxy y elige http o socks5. Botones:
- Obtener: descarga listas de proxies públicos.
- Gestionar: edita la lista a mano.
- APIs: añade tus propias URLs de listas de proxies.
- Probar: comprueba cuáles de los 5 primeros de cada tipo funcionan.
En cada descarga se usa un proxy al azar de la lista.
Se guardan junto a MultiDownloaderv.py:
| Archivo | Contenido |
|---|---|
cookies.txt |
Copia de tus cookies. Contiene tus sesiones iniciadas: no lo compartas ni lo subas a GitHub. |
proxies.json |
Lista de proxies HTTP y SOCKS5. |
custom_apis.json |
Tus URLs de listas de proxies. |
| Problema | Solución |
|---|---|
| Instálalo (ver instalación) y reinicia la app, o indica el ejecutable con Seleccionar en la fila FFmpeg. | |
En Linux la app no abre: No module named 'tkinter' |
Instala python3-tk (Debian/Ubuntu), tk (Arch) o python3-tkinter (Fedora). |
| Falla una descarga de YouTube o faltan calidades | Actualiza yt-dlp con pip install -U yt-dlp (los lanzadores lo hacen solos). Si yt-dlp avisa de que falta un JavaScript runtime, instala Deno. |
| La conversión a WebM tarda | Solo ocurre si el sitio no ofrece WebM y hay que recodificar. MP4 y MKV no recodifican. |
| Las cookies de Chrome o Edge no funcionan | Usa el método archivo o Firefox (ver cookies). |
| Un video muestra error | El resumen final lista las URLs que fallaron. Suelen ser videos privados, con restricción de edad (usa cookies) o bloqueados por región (usa un proxy). |
Distribuido bajo licencia MIT. Desarrollado por FayDev.
Si te resulta útil, puedes apoyar el proyecto desde el botón 💖 Apoyar de la aplicación.
