audio-transcode-watcher
Servicio de transcodificación automática de audio con detección de cambios en tiempo real, soportando múltiples formatos simultáneamente y sincronización de letras.
Ficha actualizada 26 sept 2026, 17:55 · upstream 26 sept 2026, 17:45 · release v0.5.2
Qué es audio-transcode-watcher
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
audio-transcode-watcher es un servicio automatizado diseñado para mantener bibliotecas musicales en múltiples formatos sin intervención manual. Detecta archivos nuevos o modificados en una carpeta fuente y los transcodifica automáticamente a todos los formatos configurados, como ALAC, MP3, AAC, Opus, FLAC o WAV. El sistema respeta la estructura de directorios recursiva del origen, replicando carpetas de artista y álbum en cada destino.
El servicio incluye funcionalidades avanzadas como sincronización automática de letras (archivos .lrc) con soporte para Whisper como fallback local cuando no se encuentran online. Implementa escritura atómica mediante archivos temporales para evitar corrupción por fallos, y elimina automáticamente los archivos huérfanos que ya no tienen fuente correspondiente. Incluye guardias de seguridad que previenen borrados accidentales si las carpetas aparecen vacías.
El proyecto está optimizado para contenedores Docker con una imagen basada en Python 3.14-slim y FFmpeg, manteniendo un footprint bajo en reposo mediante watchers eficientes (inotify/FSEvents). Soporta configuración vía archivo YAML o JSON, y ofrece herramientas de verificación para asegurar la sincronización entre fuentes y salidas.
- Mantenimiento automático de bibliotecas musicales en múltiples formatos (pérdida vs sin pérdida) para diferentes dispositivos
- Transcodificación en tiempo real al añadir nuevos archivos a una carpeta fuente sin intervención manual
- Sincronización de letras con archivos .lrc y transcripción Whisper como fallback cuando no hay datos online
- Preservación de estructura de directorios recursiva (artista/álbum) en todos los formatos de salida
- Detección de cambios en tiempo real mediante watchdog con soporte para nuevos, modificados, renombrados y eliminados
- Escritura atómica que evita archivos corruptos o parciales en caso de fallo durante la codificación
- Soporte nativo para seis codecs: ALAC, AAC, MP3, Opus, FLAC y WAV con bitrates configurables
- Limpieza automática de archivos huérfanos y directorios vacíos tras eliminaciones del origen
- Guardias de seguridad que bloquean borrados si las carpetas fuente o destino aparecen vacías
- Dependencia crítica de FFmpeg instalado externamente en el contenedor o sistema anfitrión
- El modelo Whisper consume recursos significativos (CPU/RAM) cuando se activa como fallback para letras
- No incluye docker-compose nativo en el repositorio, requiriendo configuración manual del archivo
- La sincronización de letras online puede fallar si no hay conexión a internet o APIs bloqueadas
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.
Recomendado ejecutar con Docker usando la imagen drumsergio/audio-transcoder:0.5.1. Configurar CONFIG_FILE apuntando a un archivo YAML local con rutas absolutas para carpetas de entrada y salida. Asegurar que los volúmenes montados tengan permisos de lectura/escritura adecuados (ej. chmod 755). Si se usa Whisper, considerar reducir el modelo a 'tiny' o 'base' en entornos con recursos limitados. Monitorear el uso de CPU cuando haya actividad de transcodificación masiva.
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.