channel-vault-nas
Consola de operaciones para archivar canales de YouTube en un NAS. Reutiliza archivos existentes y archive.txt, descargando solo lo faltante con yt-dlp. Índice SQLite recuperable desde el disco.
Ficha actualizada 24 sept 2026, 15:08 · upstream 24 sept 2026, 14:57 · release v0.3.0
Qué es channel-vault-nas
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Channel Vault NAS es una herramienta de autogestión diseñada para convertir un canal de YouTube en un archivo persistente en un NAS. A diferencia de los descargadores tradicionales, prioriza la integridad del sistema de archivos como fuente de verdad, utilizando una base de datos SQLite solo como índice recuperable. El software escanea carpetas locales y archivos archive.txt para evitar descargas redundantes, permitiendo recuperar el estado de la biblioteca si la aplicación se reinicia o falla.
La arquitectura consta de dos contenedores separados: un backend en FastAPI/Python y una interfaz web en Next.js. Se despliega mediante Docker Compose sin necesidad de clonar el repositorio ni construir localmente, lo que facilita su integración en entornos NAS como Synology o QNAP. Incluye detección de cambios, gestión de colas de descarga con yt-dlp y auditoría de eventos operativos.
El proyecto está en desarrollo activo (versión 0.3.1) y se enfoca en la fiabilidad del archivo a largo plazo. Ofrece una interfaz para registrar canales, configurar intervalos de verificación y visualizar el estado de los archivos salvados. Es ideal para usuarios que ya poseen un NAS con carpetas de medios o archivos archive.txt y buscan una solución orientada al almacenamiento más que a la reproducción multimedia.
- Crear un archivo persistente de un canal de YouTube en un NAS reutilizando contenido existente.
- Auditar el estado de descargas previas mediante archive.txt sin redescargar archivos intactos.
- Recuperar el índice de la biblioteca desde los archivos del sistema de archivos si falla la base de datos.
- Configurar backups automáticos programados para canales específicos con control de colas.
- Reutiliza archive.txt y carpetas locales para evitar descargas innecesarias.
- Base de datos SQLite recuperable desde el sistema de archivos (filesystem is durable data).
- Interfaz web separada del backend con despliegue simplificado vía Docker Compose.
- Auditoría detallada de eventos de descarga, fallos y estado de la cola.
- Compatible con yt-dlp para descargas robustas y gestión de metadatos.
- No soporta autenticación multiusuario ni sesiones seguras para exposición pública.
- No incluye flujo de trabajo para cookies o videos privados sin estado del navegador.
- Requiere despliegue detrás de un proxy inverso confiable o VPN, no expuesto a internet público.
- La recuperación de archivos depende de la disponibilidad de los enlaces en yt-dlp.
- No gestiona copias de seguridad fuera del NAS (responsabilidad del usuario).
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
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.
Despliegue con Docker Compose usando compose.release.yml. Requiere dos imágenes: channel-vault-nas-api y channel-vault-nas-web. Portes por defecto: 5173 (web), 8000 (api). No exponer directamente a internet; usar proxy inverso o VPN. Verificar compatibilidad con el NAS antes de instalar. Copias de seguridad manuales de la base de datos SQLite y carpetas de medios son obligatorias.
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.