Cómo instalar Podgrab en Docker - Gestor de podcasts en Docker

Podgrab | Podcasts | Docker

Podgrab: Gestor y descargador de podcasts self-hosted

Descarga automáticamente episodios de tus podcasts favoritos, organízalos con etiquetas y escúchalos con el reproductor integrado.

¿Qué es Podgrab?

Podgrab es una aplicación web de código abierto que funciona como un gestor, descargador y archivo de podcasts. Descarga automáticamente los episodios nuevos de tus podcasts favoritos, los organiza y te permite escucharlos directamente desde el navegador.

Es una solución self-hosted perfecta para quienes consumen podcasts regularmente y quieren tener su propia biblioteca de episodios guardada y organizada. Podgrab funciona las 24 horas vigilando nuevos episodios y descargándolos automáticamente.

Autodescarga inteligente: Podgrab monitoriza automáticamente tus podcasts suscritos y descarga los nuevos episodios tan pronto se publican. Nunca pierdas un episodio de tus shows favoritos.

Características principales

Descarga automática

Monitoriza tus feeds RSS y descarga episodios automáticamente cuando se publican nuevos.

Reproductor integrado

Escucha episodios descargados o transmite directamente desde la fuente original.

Etiquetas y grupos

Organiza tus podcasts en grupos con etiquetas personalizadas para mejor organización.

Búsqueda iTunes

Descubre nuevos podcasts buscando directamente en la base de datos de iTunes.

Importación OPML

Importa/exporta fácilmente tu colección de podcasts con archivos OPML estandar.

Detección de archivos

No redescarga episodios que ya existen, incluso después de reinstalar la aplicación.

Dark Mode

Interfaz moderna con modo oscuro incluido para sesiones de escucha nocturnas.

Nombres personalizables

Personaliza el formato de nombres de archivo de los episodios descargados.

Instalación rápida con Docker

Opción 1: Docker Run rápido

docker run -d -p 8080:8080 --name=podgrab akhilrex/podgrab

Accede a http://localhost:8080 y comienza a añadir podcasts.

Opción 2: Docker Run con volúmenes persistentes

docker run -d -p 8080:8080 --name=podgrab \ -v "/ruta/host/assets:/assets" \ -v "/ruta/host/config:/config" \ akhilrex/podgrab

Opción 3: Docker Compose (recomendado)

version: "2.1" services: podgrab: image: akhilrex/podgrab container_name: podgrab environment: - CHECK_FREQUENCY=240 # - PASSWORD=password ## Descomenta para activar autenticación básica volumes: - /ruta/host/config:/config - /ruta/host/data:/assets ports: - "8080:8080" restart: unless-stopped

Configuración avanzada

Variables de entorno

CHECK_FREQUENCY=240 # Intervalo en minutos para verificar nuevos episodios PASSWORD=password # Contraseña para autenticación básica (usuario: podgrab) PORT=8080 # Puerto interno de la aplicación (requiere ajustar Docker también)

Autenticación básica

Activa la autenticación estableciendo la variable PASSWORD:

docker run -d -p 8080:8080 --name=podgrab \ -e "PASSWORD=tu-contraseña-segura" \ -v "/ruta/config:/config" \ -v "/ruta/data:/assets" \ akhilrex/podgrab

El usuario es podgrab y la contraseña la que definas en la variable PASSWORD.

Tip: Es recomendable usar Watchtower para mantener Podgrab actualizado automáticamente. Podgrab recibe actualizaciones frecuentes.

Uso básico

Cuando abras Podgrab por primera vez

1. Accede a http://tu-servidor:8080
2. Ve a Settings para revisar la configuración del servidor
3. Configura la ruta de descarga, calidad de audio y otras preferencias
4. Añade tus podcasts mediante:
   • Buscar: Usa la búsqueda integrada de iTunes
   • RSS directo: Añade la URL del feed RSS del podcast
   • OPML: Importa tu colección desde un archivo OPML

Escuchar podcasts

1. Ve a tu biblioteca de podcasts
2. Haz clic en un podcast ver los episodios disponibles
3. Haz clic en el botón de play para iniciar la reproducción
4. Puedes reproducir:
   • Un solo episodio
   • Todos los episodes de un podcast
   • Podcasts por etiquetas/grupos

Gestión de etiquetas

Usa las etiquetas para organizar los podcasts. Por ejemplo:

• Tecnología: Podcasts de tech, programación, etc.
• Noticias: Podcasts de actualidad informativa
• Entretenimiento: Comedia, cultura pop, etc.
• Aprendizaje: Idiomas, ciencia, historia, etc.

Actualización automática con Watchtower

Dado que Podgrab recibe actualizaciones frecuentes, es recomendable usar Watchtower:

docker run -d \ --name watchtower \ -v /var/run/docker.sock:/var/run/docker.sock \ containrrr/watchtower \ podgrab --interval 3600

Watchtower monitoriza automáticamente el contenedor de Podgrab y lo actualiza cuando haya una nueva imagen. Revisa regularmente las releases para conocer nuevas funcionalidades.

Reverse Proxy con Nginx

server { listen 80; server_name podgrab.tu-dominio.com; location / { proxy_pass http://127.0.0.1:8080; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } }

Importante: Si usas reverse proxy, asegúrate de habilitar el soporte de WebSockets. Es necesario para la característica "Añadir a playlist" de Podgrab.

Backup y restore

Backup de datos

# Backup de config y assets docker run --rm \ -v podgrab_config:/source_config \ -v podgrab_assets:/source_assets \ -v $(pwd):/backup \ alpine sh -c "tar czf /backup/podgrab-backup-$(date +%Y%m%d).tar.gz -C /source_config . -C /source_assets ."

Restore

# Detener contenedor antes de restaurar docker stop podgrab # Restaurar backup docker run --rm \ -v podgrab_config:/target_config \ -v podgrab_assets:/target_assets \ -v $(pwd):/backup \ alpine sh -c "cd /target_config && tar xzf /backup/podgrab-backup-YYYYMMDD.tar.gz; cd /target_assets && tar xzf /backup/podgrab-backup-YYYYMMDD.tar.gz"

Gestión y mantenimiento

Ver logs

docker logs -f podgrab

Reiniciar Podgrab

docker restart podgrab

Actualizar manualmente

docker pull akhilrex/podgrab:latest docker stop podgrab docker rm podgrab docker run -d -p 8080:8080 --name=podgrab \ -v "/ruta/config:/config" \ -v "/ruta/data:/assets" \ akhilrex/podgrab:latest

Espacio en disco

Los archivos MP3 descargados pueden consumir mucho espacio. Monitorea regularmente:

du -sh /ruta/podgrab/assets

Consejo de almacenamiento: Configura la frecuencia de verificación y límites de retención en la configuración de Podgrab para evitar llenar el disco.

Casos de uso

• Audiófilos: Archiva todos tus podcasts favoritos localmente para acceso hors-línea
• Comunidades: Comparte un servidor de podcasts con amigos o comunidad con todos tus shows
• Smartwatch/BT: Transfiere episodios descargados a smartwatches o dispositivos Bluetooth
• Centros de media: Integra con Plex, Jellyfin o Emby usando la carpeta de assets como biblioteca de audio
• Viajeros: Descarga episodios antes de viajes para escuchar sin conexión a internet
• Curadores: Mantiene un archivo ordenado y etiquetado de podcasts educativos o profesionales

---

Referencias oficiales

• Repositorio oficial de Podgrab - GitHub
• Imagen Docker oficial - Docker Hub
• Galería de screenshots
• Hammond (otro proyecto del autor)

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