ytptube
YTPTube es un gestor de descargas y interfaz de automatización para yt-dlp. Permite descargar contenido desde YouTube, gestionar tareas recurrentes, crear plantillas de descarga y organizar archivos en una biblioteca de medios.
Ficha actualizada 23 sept 2026, 7:32 · upstream 23 sept 2026, 7:10 · release v2.7.4
Qué es ytptube
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
YTPTube es una herramienta self-hosted que funciona como gestor de descargas, interfaz de automatización y capa de preparación de biblioteca de medios para yt-dlp. Su arquitectura permite manejar descargas individuales, fuentes recurrentes, reglas basadas en metadatos, colas concurrentes y archivos organizados desde la misma interfaz web.
La herramienta se divide en tres componentes principales: Tasks, que verifican canales, playlists, feeds y fuentes personalizadas; Presets, que almacenan opciones reutilizables de yt-dlp como plantillas de salida, rutas, cookies y configuraciones post-procesamiento; y Conditions, que inspeccionan metadatos extraídos por yt-dlp para aplicar opciones correspondientes.
La interfaz web incluye modo simple para usuarios no técnicos y una versión estándar con controles avanzados. Se soporta múltiples idiomas (inglés, árabe, francés, chino y japonés) a través de un sistema de traducciones localizadas.
YTPTube ofrece integración nativa con Kodi mediante NFO Maker, que genera archivos .nfo para TV shows o películas, limpia descripciones para uso en la biblioteca y crea IDs estables. También soporta creación automática de metadatos de colección (como tvshow.nfo) cuando las fuentes proporcionan información estructurada.
La herramienta incluye un navegador extraíble integrado, que permite extraer contenido directamente desde el navegador sin necesidad de instalar yt-dlp. Además, ofrece una API HTTP para acceso programático y soporte para extensiones como la extensión Firefox Add-on.
En cuanto a almacenamiento, YTPTube soporta Docker, Podman, Unraid y builds nativas para Windows, macOS y Linux. La configuración incluye opciones para aceleración por hardware, almacenamiento NFS o SMB, así como rutas temporales personalizadas.
- Descargar contenido de YouTube individualmente o en grupos (playlists)
- Automatizar tareas recurrentes como descargar canales o series específicas
- Crear plantillas de descarga reutilizables con opciones predefinidas
- Organizar archivos descargados en una biblioteca de medios estructurada
- Generar archivos NFO para Kodi sin necesidad de editar manualmente los metadatos
- Extraer contenido directamente desde el navegador mediante extensiones o bookmarklets
- Configurar fuentes recurrentes sin necesidad de RSS feeds
- Monitorear y controlar descargas concurrentes con límites por extractor
- Soporta múltiples idiomas en su interfaz web y permite personalización total del idioma.
- Ofrece una API HTTP completa para acceso programático desde cualquier aplicación externa.
- Incluye un navegador extraíble integrado que funciona sin necesidad de instalar yt-dlp.
- Permite la creación automática de archivos NFO compatibles con Kodi a partir de metadatos de YouTube.
- Soporta múltiples plataformas de ejecución: Docker, Podman, Unraid y builds nativas para Windows, macOS y Linux.
- Proporciona un sistema de condiciones que permite aplicar opciones dinámicas basadas en el metadato extraído.
- No soporta descargas simultáneas masivas (más de 10-20 por minuto) sin configurar límites manualmente.
- La extracción de contenido desde el navegador requiere que el sitio web permita la extracción o use un proxy externo como FlareSolverr.
- Las fuentes con metadatos limitados no generan automáticamente archivos NFO completos, requiriendo configuración manual.
- No incluye soporte nativo para descargas en dispositivos móviles (Android/iOS) sin extensiones adicionales.
- La integración con Kodi depende de que el sitio web proporcione información estructurada compatible con su formato de NFO.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para ejecutar YTPTube, se recomienda usar Docker Compose. Se debe crear un directorio .config para guardar las variables de entorno y una carpeta downloads con subcarpetas files y tmp. El comando docker compose up -d inicia el contenedor en modo de ejecución continua. Para usuarios de Podman, se puede reemplazar la línea --user por userns_mode: keep-id. Se recomienda configurar un firewall para restringir el acceso a puertos 8081 (web) y 9222 (API). En entornos locales, se pueden usar variables de entorno como YTP_TEMP_PATH o YTP_DOWNLOAD_PATH para definir rutas temporales personalizadas. Para producción, se debe implementar autenticación mediante un servicio externo (OAuth2, JWT) y restringir el acceso a través de una red privada.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.