Instalar HomeTube con Docker: descarga vídeos de +1800 plataformas

el

 

Instalar HomeTube con Docker: descarga vídeos de +1800 plataformas y ordénalos en tu biblioteca

¿Otra app para bajar vídeos de YouTube? Sí… pero en realidad no solo de YouTube.
HomeTube es un descargador web self-hosted que soporta más de 1800 plataformas (YouTube, TikTok, Twitch, Reddit, Vimeo, Instagram, etc.) y está pensado para algo muy concreto: descargar vídeos sueltos (no playlists) y dejarlos bien organizados para tu biblioteca multimedia casera. 

Además, incluye funciones “premium” sin serlo: bloqueo automático de sponsors/publicidad, recorte de clips, subtítulos embebidos, control fino de calidad y soporte de cookies para contenido restringido.

En este artículo verás qué puede hacer y cómo desplegarlo con Docker en minutos.



¿Qué es HomeTube?

HomeTube es una interfaz web (basada en yt-dlp + Streamlit) para descargar vídeos online con un flujo ultradirecto:

  1. pegas una URL,

  2. eliges opciones,

  3. descargas el archivo ya organizado.

Ahora mismo el formato de salida habitual es .mkv, aunque en GitHub ya se plantea poder elegir otros formatos desde la UI. 

Características principales

HomeTube trae más chicha de lo que parece a simple vista:

  • Descarga en un clic: pegas URL → te genera el vídeo en carpeta organizada. 

  • Contenido sin anuncios: integración con SponsorBlock para saltar sponsors, promos, intros/outros, etc. 

  • Procesado avanzado: recorte de clips, subtítulos, conversión/normalización de salida. 

  • Vídeos restringidos: soporte de cookies (edad, membresías, geo-bloqueos). 

  • Control de calidad: mejor calidad automática o selección manual de resoluciones detectadas. 

  • Catálogo enorme de fuentes: más de 1800 sitios compatibles. 

Instalación con Docker

Prerrequisitos

Necesitas lo típico:

  • Linux (Ubuntu, Debian, etc.).

  • Docker + Docker Compose.

  • Terminal.

  • Internet.

Paso 1: crear el compose.yml

En tu carpeta de instalación:

nano compose.yml

Pega esto (ajusta rutas/puerto si quieres):

services:
  hometube:
    image: ghcr.io/egalitarianmonkey/hometube:latest
    ports:
      - "8501:8501"
    environment:
      - TZ=Europe/Paris      # Zona horaria
      - PORT=8501            # Puerto web
      - VIDEOS_FOLDER=/data/Videos
      - TMP_DOWNLOAD_FOLDER=/data/tmp
      - YOUTUBE_COOKIES_FILE_PATH=/config/youtube_cookies.txt
    volumes:
      - ./downloads:/data/Videos    # Carpeta descargas
      - ./cookies:/config           # Carpeta cookies
    restart: unless-stopped

Variables importantes:

  • VIDEOS_FOLDER → destino final de los vídeos.

  • TMP_DOWNLOAD_FOLDER → temporales durante la descarga.

  • YOUTUBE_COOKIES_FILE_PATH → ruta al archivo de cookies (si lo usas).

  • TZ → tu zona horaria para horarios/etiquetado.

La propia documentación recomienda cookies para evitar fallos y desbloquear contenido. 

Paso 2: levantar el servicio

docker compose up -d

Paso 3: abrir HomeTube

  • Local: http://IP_DEL_SERVIDOR:8501/

  • Dominio: https://hometube.tudominio.com

Descargar (extraer) un vídeo paso a paso

En la UI verás un formulario por secciones.

1) Datos básicos

  • URL: pega el enlace.

  • Nombre: opcional; si lo dejas vacío usa el título original.

  • Carpeta destino: si tienes subcarpetas.

  • Subtítulos: activar extracción si los quieres.

2) Bloqueo de anuncios/sponsors

Selecciona el nivel de bloqueo (SponsorBlock):

  • sponsors,

  • promos,

  • intros,

  • outros,

  • o nada.

Se aplica automáticamente a YouTube con base comunitaria. 

3) Recorte de vídeo (opcional)

Puedes elegir descargar solo una parte:

  • Keyframes: recorte rápido sin re-encode.

  • Precise: recorte exacto con re-encode (más lento).

Luego marcas inicio/fin en minutos/segundos.

4) Calidad del vídeo

  • Por defecto baja la mejor calidad disponible.

  • Con Detect qualities te lista resoluciones/fps y eliges manualmente. 

5) Subtítulos y capítulos

  • Embed subtitles: incrustar subtítulos en el vídeo final.

  • Add chapters: añadir capítulos.

Ojo: estas opciones pueden interferir con recortes o conversión.

6) Cookies (muy recomendadas)

Si activas cookies:

  • podrás bajar vídeos con límite de edad,

  • exclusivos para miembros,

  • o con restricción geográfica. 

Si no las usas, esos casos suelen fallar.

7) Descargar

Cuando todo esté a tu gusto, pulsa el botón final de descarga.
Verás el proceso en marcha y al terminar una confirmación. El archivo aparecerá en tu carpeta downloads/.

Nota legal rápida

HomeTube es una herramienta neutra. Úsala respetando derechos de autor y términos de cada plataforma.
Para tu homelab es ideal para:

  • vídeos propios,

  • material con licencia libre,

  • backups personales,

  • contenido permitido por el sitio.

Conclusión

HomeTube es un descargador moderno para self-hosting:

  • soporta casi cualquier plataforma,

  • deja el contenido organizado para Plex/Jellyfin,

  • integra SponsorBlock sin configurar nada,

  • y con cookies evita el 90% de limitaciones típicas.

🔗 Enlaces de Interés y Apoyo al Canal 🔗

Comunidad GENBYTE

Redes

Comentarios

Publicar un comentario