| Español | English |
LRC-CheckEdGen ayuda a usuarios y administradores de servidores multimedia como Jellyfin, Plex y Navidrome a auditar su biblioteca musical, encontrar canciones sin letras sincronizadas y generar o editar archivos .lrc con inteligencia artificial local.
Imágenes disponibles en Docker Hub:
oct4vyus/lrc-checkedgen:latest (actualmente 1.3.0)oct4vyus/lrcgen-container:1.0.0.lrc existentes: no los sobrescribe.no_lyrics en lugar de tratarse como fallos; el resumen final distingue letras guardadas, errores, omisiones por idioma y pistas instrumentales./archivo transmite audio por bloques y la regeneración de informes puede agruparse con REPORT_REFRESH_DELAY_SEC.Este ejemplo despliega la interfaz y el backend de IA. Adapta las rutas del host, la zona horaria, el idioma predeterminado y la URL del servidor a tu instalación.
version: "3.8"
services:
lrc-checkedgen:
image: oct4vyus/lrc-checkedgen:latest
container_name: lrc-checkedgen
restart: unless-stopped
networks:
- lrc_network
environment:
- PUID=1000
- PGID=100
- TZ=America/Argentina/Cordoba
- MUSIC_DIR=/music
- OUTPUT_DIR=/reports
- CHECK_ORPHANS=true
- VERBOSE=true
- REVIEW_THRESHOLD_SEC=40.0
- REPORT_REFRESH_DELAY_SEC=1.0
- SERVER_URL=http://TU_IP_SERVIDOR:9080
- LRCGEN_URL=http://lrcgen-whisper:8000
- LRCGEN_QUEUE_DB=/reports/lrcgen_queue.sqlite3
- LRCGEN_UPLOADS_DIR=/lrcgen-uploads
volumes:
- /ruta/a/tu/musica:/music:rw
- /ruta/a/tus/reportes:/reports:rw
- /ruta/a/tus/cargas_temporales:/lrcgen-uploads:rw
ports:
- "9080:8080"
lrcgen:
image: oct4vyus/lrcgen-container:1.0.0
container_name: lrcgen-whisper
restart: unless-stopped
networks:
- lrc_network
environment:
- PUID=1000
- PGID=100
- TZ=America/Argentina/Cordoba
- WHISPER_MODEL=medium
- DEFAULT_LANGUAGE=es
- UVR_ENABLED=true
volumes:
- /ruta/a/tu/musica:/music:rw
- /ruta/a/tus/reportes:/reports:rw
- /ruta/a/tu/cache/whisper:/cache/whisper
- /ruta/a/tu/cache/uvr5:/cache/audio-separator
- /ruta/a/tus/cargas_temporales:/app/uploads:rw
networks:
lrc_network:
external: true
name: lrc_network
docker network create lrc_network.docker-compose.yml y reemplaza las rutas de ejemplo por rutas reales.TU_IP_SERVIDOR por la IP o el nombre del servidor accesible desde tu navegador.docker compose up -d.http://TU_IP_SERVIDOR:9080.| Variable | Descripción / Description | Ejemplo / Example |
|---|---|---|
SERVER_URL |
URL de acceso a la interfaz desde el navegador. / Browser-accessible URL for the interface. | http://TU_IP_SERVIDOR:9080 |
LRCGEN_URL |
Dirección privada de Docker para LRCGen. / Private Docker URL for LRCGen. | http://lrcgen-whisper:8000 |
LRCGEN_QUEUE_DB |
Ruta persistente de la cola SQLite. / Persistent path to the SQLite queue. | /reports/lrcgen_queue.sqlite3 |
LRCGEN_UPLOADS_DIR |
Directorio compartido para archivos temporales. / Shared directory for temporary files. | /lrcgen-uploads |
REPORT_REFRESH_DELAY_SEC |
Espera para agrupar actualizaciones de informes. / Delay for batching report updates. | 1.0 segundos / seconds |
REVIEW_THRESHOLD_SEC |
Umbral de revisión en segundos. / Review threshold in seconds. | 40.0 |
WHISPER_MODEL |
Modelo de Whisper: tiny, base, small, medium o large. / Whisper model size. |
medium |
DEFAULT_LANGUAGE |
Idioma predeterminado para la transcripción. / Default transcription language. | es |
Por las características de mi servidor la imagen que yo construí de LRCGen (oct4vyus/lrcgen-container:1.0.0), funciona solo con CPU, sin GPU dedicada. Aun así los resultados son bastante buenos a nivel medio, si la voz del tema es nítida. Si tenés otras condiciones de hardware puedes consultar como adaptar y construir tu imagen en https://github.com/final-wav/LRCGen
missing no tienen letra..lrc se guardará junto al audio.lrc_network y que LRCGEN_URL apunte a http://lrcgen-whisper:8000 / check that both containers are on lrc_network and LRCGEN_URL points to http://lrcgen-whisper:8000..lrc / Cannot save .lrc files: verifica los permisos de lectura y escritura para PUID y PGID / check read/write permissions for PUID and PGID.
Este proyecto integra funcionalidades del proyecto LRCGen. Muchas gracias a Hakan D. (@final-wav) por su excelente trabajo y por compartirlo con la comunidad.
Si querés apoyar el proyecto, podés hacerlo a través de:
LRC-CheckEdGen helps music lovers and home media server administrators (Jellyfin, Plex, and Navidrome) audit their music libraries, find tracks without synchronized lyrics, and generate or edit .lrc files with local AI.
Docker Hub images: oct4vyus/lrc-checkedgen:latest and oct4vyus/lrcgen-container:1.0.0.
.lrc files instead of overwriting them.no_lyrics rather than treated as failures; completion summaries distinguish saved lyrics, errors, language skips, and instrumental tracks./archivo endpoint streams audio in chunks, and report regeneration can be batched with REPORT_REFRESH_DELAY_SEC.Use the single Compose example in the Spanish deployment section; it configures both the frontend and AI backend and avoids maintaining duplicate configuration blocks. Replace the sample host paths and server URL with your own. For an English-first setup, you may also change TZ to your timezone and DEFAULT_LANGUAGE to en.
docker network create lrc_network.docker-compose.yml.docker compose up -d.http://YOUR_SERVER_IP:9080, review tracks marked missing, and click GENERAR LRC on an album..lrc file is saved next to its audio file.The bilingual environment variable reference and troubleshooting guide above apply to both languages. Ensure the Docker network and read/write volume permissions are correct if the backend is unavailable or lyrics cannot be saved.
Due to my server’s specifications, the image I built from LRCGen (oct4vyus/lrcgen-container:1.0.0) runs only on the CPU, without a dedicated GPU. Even so, the results are quite good at a medium level, provided the vocals in the track are clear. If you have different hardware configurations, you can find out how to adapt and build your own image at https://github.com/final-wav/LRCGen
Créditos / Credits: LRC-CheckEdGen integrates the LRC-Checker auditing project with the LRCGen AI engine, based on OpenAI Whisper and UVR5.
This project integrates and builds upon ideas from LRCGen. Many thanks to Hakan D. (@final-wav) for creating and maintaining it.
If you want to help keep it going, you can support it here: