cuearr
Herramienta en Go para dividir álbumes lossless (imagen+CUE) en archivos por pista, optimizada para homelabs con Lidarr y Plex.
Ficha actualizada 22 sept 2026, 16:14 · upstream 11 sept 2026, 7:34 · release v0.5.0
Qué es cuearr
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Cuearr es un daemon especializado en el procesamiento de música lossless dentro de entornos *arr. Su función principal es detectar carpetas de entrada que contienen imágenes de álbumes junto con archivos CUE, y dividirlos automáticamente en archivos individuales por pista. Esto resuelve problemas comunes de importación en Lidarr y visualización en Plex Music, donde los formatos combinados suelen ser interpretados incorrectamente.
El proyecto está escrito en Go y utiliza herramientas como shntool para la división real, aunque contempla un motor nativo en el futuro. Ofrece una interfaz web integrada para gestionar colas de trabajo, ver historiales y configurar parámetros. Soporta autenticación mediante contraseña local, claves API y OIDC opcional, lo que facilita su integración segura en redes domésticas.
Es compatible con múltiples plataformas de despliegue, incluyendo Docker Compose, Unraid, Proxmox LXC, Kubernetes vía Helm y binarios nativos para Linux, macOS y Windows. La herramienta está diseñada para ser un complemento no intrusivo que actúa como puente entre la descarga de archivos y su ingestión en bibliotecas multimedia.
- Automatización de watch folders para detectar nuevos álbumes lossless sin intervención manual
- Integración con Lidarr mediante webhooks para disparar la división tras una descarga o importación
- Despliegue en entornos heterogéneos como homelabs, servidores Proxmox o contenedores Docker
- Gestión de colas de trabajo y verificación de integridad antes de publicar archivos a bibliotecas
- Soporte nativo para múltiples arquitecturas: amd64 y arm64 en binarios e imágenes Docker
- Interfaz web integrada con autenticación flexible (password, API key, OIDC)
- Integración directa con Lidarr vía webhook o scripts personalizados
- Persistencia de datos mediante SQLite para mantener estado de colas y configuraciones
- Dependencia de herramientas externas como shntool en despliegues nativos, no incluidas en binarios puros
- No realiza transcodificación ni conversión a formatos lossy
- No reemplaza las funciones de Lidarr para metadatos o búsqueda de álbumes
- El motor nativo en Go está programado como feature futuro y no es funcional actualmente
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.
Para despliegue rápido, use Docker Compose con la imagen ghcr.io/marcatos/cuearr. Asegúrese de configurar CUEARR_INITIAL_PASSWORD antes del primer inicio. En entornos nativos, instale shntool en el PATH o utilice la imagen Docker que lo incluye. Para Kubernetes, emplee el chart Helm disponible en deploy/helm/cuearr con persistencia adecuada.
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.