Cómo instalar YTZero en Docker - Agregador YouTube autohospedado sin login, descargador videos, yt-dlp

YTZero | YouTube Agregador | Sin Login | yt-dlp

YTZero en Docker: Agregador YouTube autohospedado sin login, descargador videos yt-dlp, feed local con algoritmo propio (alternativa YouTube puro) 📺

Agregador YouTube autohospedado. Sin login ni sincronización API privada. Observa feeds públicos canales seguidos. Construye biblioteca local. Feed limpio, algoritmo propio (no YouTube). yt-dlp plugin: descarga automática videos (cola prioritaria, selección calidad, smart retention). Watch history + progress sync. Búsqueda YouTube temporales. Progressive Web App. Unraid template + Proxmox LXC. MIT open source. Node.js backend.

¿Qué es YTZero?

YTZero es un agregador de YouTube autohospedado que observa feeds públicos de canales que sigues, construye una biblioteca local con metadatos, y te proporciona una interfaz limpia sin el algoritmo de YouTube, permitiendo descargar videos opcionalmente vía yt-dlp, con sincronización de historial de visualización y reproducción entre dispositivos, todo sin iniciar sesión ni acceder a APIs privadas. Es la solución privacy-first para fans de YouTube.

Propuesta clave: Agregador YouTube autohospedado. Sin login (cero scraping API privada). Observa feeds públicos canales. Biblioteca local metadatos. Interfaz limpia personal. yt-dlp plugin (descarga videos, cola automática, retención inteligente con cap almacenamiento). Watch history persistente (resume parcialmente visualizado). Progressive Web App (PWA funciona offline parcialmente). Búsqueda temporales (YouTube search, guardar después). Fullscreen mobile landscape (excepto Safari iOS). Settings UI. Multi-dispositivo sync. Unraid Community App listo. Proxmox LXC installer. Docker nativo. MIT open source. Node.js backend.

Características principales: Feed agregado: todos videos canales seguidos, nada más. Metadata fetching: títulos, descripciones, thumbnails, duraciones. yt-dlp integration: descarga automática scheduled + fresh uploads. Priority queue: "wait for download" mode. Quality selection: 1080p/720p/480p/audio-only. Smart retention: storage cap automático, elimina viejos intelligently. Downloads tab: seguimiento descargas, progress bars. Watch history: grabar visualizados + resume position. Temporary videos: YouTube search results sin suscripción (review/clear después). Fullscreen mobile: landscape auto-fullscreen (excepto iOS). Settings UI: mostrar logs, controles display. PWA: instalar home screen, funciona offline limitado. Multi-device: sincroniza watch history. Unraid ready. Proxmox LXC deploy. Docker straightforward. MIT open source.

Para YouTubers: Controla feed. Sin algoritmo YouTube. Descarga archivos. Privacidad total. Biblioteca local.

Características principales

Agregador feed público

Observa canales seguidos. Feeds públicos, cero login.

Algoritmo propio local

Feed limpio tuyo. Sin recomendaciones YouTube.

yt-dlp integración (plugin)

Descargar videos automático. Cola prioritaria. Quality select.

Watch history + progress

Grabar visualizados. Resume posición. Multi-dispositivo sync.

Smart retention storage

Cap automático. Elimina viejos intelligently. Control espacio.

Downloads tab + progress

Seguimiento descargas. Progress bars real-time. Estado Cola.

Búsqueda temporales

YouTube search results. Guardar favoritos después.

Progressive Web App (PWA)

Instalar home screen. Funciona offline parcial.

Fullscreen mobile landscape

Auto-fullscreen landscape. Excepto iOS (Apple limita).

Unraid + Proxmox ready

Community App. LXC Proxmox installer included.

Docker native

ghcr.io/pelski/ytzero:latest. Docker Compose simple.

MIT open source

Código abierto. Community-driven. Privacy-first approach.

Requisitos del sistema

  • Docker & Docker Compose v2+
  • 500 MB - 2 GB RAM mínimo (depende carga feeds)
  • 1 GB - 500+ GB espacio disco (según descargas videos)
  • Puerto 3001 TCP (web UI)
  • Acceso internet persistente (fetch feeds públicos canales)
  • yt-dlp binary (si descargas habilitadas, auto-instala)
  • Opcional: FFmpeg (para processing videos descargados)
Nota almacenamiento: Videos descargados ocupan mucho espacio. Configura cap retención (ej: 100GB) o descarga manual selectivo.
Recomendado: SSD para cache/DB, HDD para almacén videos descargados (separar paths).

Instalación con Docker Compose

Opción 1: Docker Compose embebido simple (recomendado)

mkdir -p ytzero && cd ytzero cat > docker-compose.yml << 'EOF' version: '3.8' services: ytzero: image: ghcr.io/pelski/ytzero:latest container_name: ytzero restart: unless-stopped ports: - "3001:3001" volumes: # Persistencia: DB, config, cache - ./data:/data environment: TZ=Europe/Madrid # yt-dlp plugin (descarga videos, disabled by default) - PLUGINS_YTDLP_ENABLED=false # Si habilitas yt-dlp, configura: # - PLUGINS_YTDLP_DOWNLOADS_PATH=/data/videos # - PLUGINS_YTDLP_QUALITY=720p healthcheck: test: ["CMD", "curl", "-f", "http://localhost:3001"] interval: 30s timeout: 5s retries: 3 EOF mkdir -p data docker compose up -d

Opción 2: Con yt-dlp plugin habilitado (descarga automática)

cat > docker-compose.yml << 'EOF' version: '3.8' services: ytzero: image: ghcr.io/pelski/ytzero:latest container_name: ytzero restart: unless-stopped ports: - "3001:3001" volumes: - ./data:/data - ./videos:/videos # Almacén videos descargados environment: TZ=Europe/Madrid # Habilitar yt-dlp plugin - PLUGINS_YTDLP_ENABLED=true # Path descargas (obligatorio si enabled) - PLUGINS_YTDLP_DOWNLOADS_PATH=/videos # Calidad máxima (720p, 1080p, 480p, audio-only) - PLUGINS_YTDLP_QUALITY=720p # Smart retention (cap en GB, 0 = unlimited) - PLUGINS_YTDLP_STORAGE_CAP_GB=200 # Auto-delete oldest si cap excedido - PLUGINS_YTDLP_AUTO_DELETE=true EOF mkdir -p data videos docker compose up -d

Opción 3: Con Caddy reverse proxy HTTPS

cat >> docker-compose.yml << 'EOF' caddy: image: caddy:latest container_name: ytzero-caddy restart: unless-stopped ports: - "80:80" - "443:443" volumes: - ./Caddyfile:/etc/caddy/Caddyfile - caddy_data:/data - caddy_config:/config depends_on: - ytzero volumes: caddy_data: caddy_config: EOF cat > Caddyfile << 'EOF' yt.tudominio.com { reverse_proxy ytzero:3001 } EOF

Acceder a YTZero

http://localhost:3001 - Web UI local

https://yt.tudominio.com - HTTPS remoto (si Caddy)

Primeros pasos

1. Acceder web UI

  1. Abre http://localhost:3001
  2. Interface aparece: no login needed
  3. Sidebar: Channels, Downloads, Settings

2. Agregar canales a seguir

  1. Click "+ Add Channel" (sidebar)
  2. Ingresa nombre canal o URL:
  3. Ej: "GENBYTE", "Fireship", "Mr. Beast", etc
  4. YTZero busca, agrega a seguimiento
  5. Feed automáticamente observa videos nuevos

3. Ver feed agregado

  1. Dashboard principal: todos videos seguidos recientes
  2. Scroll: carga más videos (infinite scroll)
  3. Click video: reproduce directamente
  4. Watch history se graba automático

4. Habilitar descargas (yt-dlp plugin)

  1. Settings → "yt-dlp Plugin"
  2. Enable toggle
  3. Configure: Quality (720p/1080p/480p), Storage Cap (100GB, 200GB, etc)
  4. Save
  5. YTZero ahora descarga videos automático al aparecer

5. Gestionar descargas

  1. Tab "Downloads": lista descargas en progreso/completadas
  2. Priority queue: dragdrop para reordenar
  3. "Wait for download" mode: reproduce mientras descarga
  4. Progress bars en thumbnails

6. Ver watch history + resumir

  1. Click video→ inicia reproducción
  2. Pausa en minuto 10:30
  3. Otro dispositivo: video muestra "Resume at 10:30"
  4. Click resume: continúa exacto punto

7. Búsqueda temporales (YouTube search)

  1. Search box: "How to Docker"
  2. Resultados YouTube (no de seguidos)
  3. Click → reproduce temporal
  4. Settings → Review/Clear temporales después

8. Configurar smart retention (limpieza automática)

  1. Settings → "Storage Management"
  2. Storage Cap: 200GB
  3. YTZero automáticamente elimina viejos si se excede
  4. Preserva recientes, favoritos primero

9. Instalar como PWA (home screen)

  1. Navegador (Chrome/Firefox): "Add to home screen" o 3-dots → "Install app"
  2. YTZero aparece como app nativa
  3. Funciona offline parcialmente (cached videos)

10. Ver logs + troubleshoot

docker logs -f ytzero # Settings UI también muestra logs recientes

Casos de uso

  • YouTube puro local: Feed limpio, sin algoritmo YouTube.
  • Archivado videos: Descarga automática canales favoritos. Biblioteca local.
  • Privacy-focused: Cero login. Feeds públicos. Datos propios locales.
  • Offline viewing: Descarga, PWA, ver sin internet.
  • Familia: Feed multi-dispositivo sync. Historial compartido.
  • DevOps homelabs: Mismo servidor infra que otras apps. Unraid/Proxmox integrado.

Gestión y mantenimiento

Ver logs en tiempo real

docker logs -f ytzero

Restart container

docker compose restart ytzero

Actualizar a versión reciente

docker pull ghcr.io/pelski/ytzero:latest docker compose up -d

Monitorear consumo

docker stats ytzero # Típicamente: 100-300MB RAM (sin descargas) # Picos durante yt-dlp descargas (depende calidad)

Backup datos (importante)

docker cp ytzero:/data ./backup-ytzero-$(date +%Y%m%d)

Limpiar descargas antiguas (manual)

docker exec ytzero rm -rf /videos/oldest_* # O Settings → Storage Management → Clean

Resetear a defaults (si problemas)

docker compose down rm -rf data/ docker compose up -d

Comparativa con alternativas

vs YouTube ReVanced (app modificada)

YTZero gana: Autohospedado, descarga integrada, servidor compartido. ReVanced gana: App móvil nativa, features YouTube intactas.

vs Tube Archivist

YTZero gana: Setup simple, PWA, yt-dlp nativo. Tube Archivist gana: Más features avanzadas, full-text search, integración Plex.

vs Invidious (YouTube proxy)

YTZero gana: Agregador local, sin proxy YouTube. Invidious gana: Acceso YouTube sin JS/ads, multi-servidor.

Mejor para: YouTubers locales. Descarga automática. Privacy total. Feed personal. Homelabs.

Referencias oficiales

Apoya el canal GENBYTE

Suscríbete al canal de YouTube Suscríbete a la newsletter semanal Invítame a un Ko-fi genbyte@proton.me

Sígueme en mis redes sociales

Telegram Discord YouTube GitHub Blog Twitter

Comentarios

Publicar un comentario

Entradas populares de este blog

Cómo Instalar y configurar SERVIDOR VPN WIREGUARD en MIKROTIK 🔐 #VPN #Wireguard #Mikrotik #RouterOS

Imagen
Wireguard en Mikrotik Breve Explicación de Wireguard ¿Qué es WireGuard VPN? WireGuard es un nuevo protocolo de VPN. No se trata de un software, sino de un conjunto de instrucciones que permite crear VPNs de forma muy sencilla. Ha sido desarrollada como una alternativa a IPsec, OpenVPN y similares VPNs, pero más rápida y sencilla de usar. En esencia, WireGuard está basado en ideas del protocolo IPsec. WireGuard es una VPN extremadamente simple, pero rápida y moderna que utiliza criptografía de última generación. Su objetivo es ser más rápido, más simple, y más versátil que IPSec, evitando al mismo tiempo el enorme dolor de cabeza (sobre todo en redes con NAT). Pretende ser considerablemente más eficaz que OpenVPN. WireGuard está diseñado como una VPN de propósito general para ejecutarse en interfaces embebidas, apto para muchas circunstancias diferentes. Se ejecuta sobre el protocolo UDP, por lo tanto es considerado un túnel de capa 3. ¿Cómo funciona Wireguard VPN? WireGuard es un proto...
Read more »

Cómo instalar y configurar DSM SYNOLOGY 7.2.2 en PC | Guía completa, instalación, RAID 1, SMB

Imagen
Instalación y puesta en marcha de Synology DSM 7.2.2 en PC Vídeo ACTUALIZADO, NUEVA VERSIÓN DEL ARC LOADER:  https://youtu.be/LgghogL-UCA https://genbyte.blogspot.com/2025/08/como-convertir-pc-en-synlogy-con-6-tb.html ----- Proceso de instalación y puesta en marcha de sistema operativo DSM Synology versión 7.2.2 en un PC, concretamente un HP 800 G1 EliteDesk. El PC tendrá 3 discos SSD, uno de 120 GB para el S.O. DSM, y otros dos de 240GB cada en RAID 1 para los Datos. Los 3 dicos duros conectados al PC mediante cables SATA. Lo primero que necesitamos es descargar la imagen bootloader ARC, desde el siguiente repositorio de Gothub, también necesitamos Rufus, en este momento, es la versión 4.6. Imagen ARC:  https://github.com/AuxXxilium/arc Imagen usado en el vídeo 1.1.29:  https://github.com/AuxXxilium/arc/releases/tag/1.1.29 Rufus:  https://rufus.ie/es/ Después de descargar la imagen ARC.img, conectamos nuestro primer disco SSD de 120GB por cable o conector SATA-USB y...
Read more »

Cómo INSTALAR y CONFIGURAR OpenVPN en MIKROTIK. Guía completa paso a paso.

Imagen
Cómo INSTALAR y CONFIGURAR OpenVPN en MIKROTIK. Guía completa paso a paso. Vídeo tutorial paso a paso en Youtube Desarrollo Ilustración: Diagrama RED Creación de Redes (Address) ----------------------------------------------- WAN 192.168.1.0/24 LAN 192.168.88.0/24 VPN 192.168.100.0/24 Creación del Rango VPN ------------------------ 192.168.100.1 - 192.168.100.100 Creación de los Certificados ------------------------------- Los certificados que vamos a crear a continuación tendrán una validez de 10 años; days-valid=3650 Crear certificado CA ---------------------- /certificate add name=CA-tpl country="" state="" locality="" organization="" unit="" common-name="CA" key-size=4096 days-valid=3650 key-usage=crl-sign,key-cert-sign /certificate sign CA-tpl ca-crl-host=127.0.0.1 name="CA" Crear certificado Server -------------------------- /certificate add name=SERVER-tpl country="" state="" locality=...
Read more »