beets-web-manager
Gestor web auto-alojado para bibliotecas de música Beets. Proporciona interfaz gráfica completa para revisión de importes, reparación de playlists, verificación de metadatos (MusicBrainz/AcoustID), limpieza de biblioteca y sincronización con Plex.
Ficha actualizada 22 sept 2026, 17:54 · upstream 22 sept 2026, 15:36 · release v0.1.22
Qué es beets-web-manager
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Beets Web Manager es una aplicación web auto-alojada diseñada para gestionar bibliotecas de música Beets sin reemplazar el motor principal. Utiliza una arquitectura de contenedores Docker Compose que ejecuta tanto el backend en Flask como el frontend estático en React/Next.js, compartiendo volúmenes con el servicio Beets nativo. El objetivo es ofrecer una interfaz unificada para operadores que controlan la biblioteca localmente, evitando la instalación de dependencias Python o Beets en el host.
- Revisión manual de importes antes de confirmar la adición a la biblioteca con evidencia de metadatos.
- Reparación automática de playlists rotas o incompletas mediante manifestos y estados de sincronización.
- Adquisición de pistas faltantes desde redes P2P como Soulseek (SLSKD) integradas en el flujo de trabajo.
- Limpieza de la biblioteca eliminando duplicados, archivos huérfanos y carpetas vacías seguras.
- Sincronización bidireccional del estado de la biblioteca con Plex Media Server.
- Auditoría de metadatos utilizando AcoustID para verificación de identidad de pistas.
- Arquitectura desacoplada en Docker Compose que separa el backend Flask del frontend Next.js.
- Validación determinista de metadatos mediante MusicBrainz y AcoustID antes de cualquier acción destructiva.
- Sistema de colas de trabajo con soporte para logs, reintentos automáticos y cancelación segura.
- Soporte nativo para integración con SLSKD para adquisición de música desde fuentes externas.
- Autenticación robusta con tokens API independientes y gestión de sesiones web con CSRF.
- Compatibilidad con stacks externos (TrueNAS) mediante conexión de red sin compartir volúmenes.
- Dependencia crítica del servicio Beets instalado previamente en el mismo stack o externo conectado.
- Funcionalidad de IA opcional y no requerida para el funcionamiento base del gestor.
- Puerto 8337 expuesto por defecto, requiriendo configuración de firewall o restricción de red.
- Requiere gestión manual de volúmenes compartidos entre contenedores Beets y Web Manager.
- La interfaz es específica para flujos de trabajo de música, no generalista.
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.
Utilizar la imagen estable de ghcr.io/iranman/beets-web-manager:stable. Configurar variables de entorno para autenticación (BEETS_WEB_PASSWORD) y permisos de volúmenes (PUID/PGID). Verificar que el servicio Beets esté corriendo antes de iniciar el Web Manager. Ajustar WEBCONTROL_PORT si se requiere acceso local solo.
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.