Cuando te gusta reproducir música desde tu servidor leyendo las letras, usas distintas aplicaciones como Jellyfin, Navidrome y Symfonium.
Entonces descubrís que no todo termina en configurar plugins que busquen y descarguen letras. Muchas no se encuentran, muchas estan desincronizadas
y muchas son versiones de estudio que no coinciden con la versión en vivo.
Pero cuando tu biblioteca es grande, ¡cómo saber cuantos temas corresponden a cada grupo!.
Y si además accedes al servidor desde maquinas remotas con distintos sistemas operativos, ¡cuántas aplicaciones necesitás para averiguar y mejorar esto!.
Solo ésta y desde cualquier navegador web.
Este contenedor Docker permite categorizar, crear, verificar y corregir letras sincronizadas en distintas bibliotecas musicales.
Genera un informe visual (lrc_report.html) con categorías de clasificación y herramientas completas de edición de archivos .lrc.
Hay varias formas:
.lrc con la duración real del audio, según una tolerancia configurable en el docker-compose.yml.
# Diferencia en segundos a partir de la cual se considera error real (no posible final musical)
- REVIEW_THRESHOLD_SEC=60.0
lrc_report.html.Para una representación visual clara, las categorías se muestran primero en rectángulos, con el número correspondiente de los archivos clasificados en ellas.
Pero la parte útil e interactiva está justo arriba de la tabla de los archivos clasificados. Donde cada categoría es ahora un link que permite “filtrar”, mostrando en la tabla solo una categoría concreta.
lrc_report.html)El informe organiza los archivos en las siguientes links a las categorías mostradas en la tabla:
.lrc existe, es válido y estaría sincronizado correctamente o ya fue verificado.).lrc para ese audio.).lrc existe pero no tiene contenido útil.).lrc no tiene marcas de tiempo.).lrc no se puede leer o tiene formato inválido.).lrc sin audio relacionado.)Categorías definidas por probabilidades estadísticas
Categorías definidas por acción del usuario
FIRMA para dejarlos identificables y posteriormente pasar a la categoría OK. La firma se define en el docker-compose.yml)
Ejemplo de configuración de la firma en docker-compose.yml:
```bash
environment:
Podemos disparar distintas acciones desde las filas de la tabla.
Desde las columnas AUDIO y .LRC de la tabla, haciendo click en sus archivos corresponientes, pueden descargarse esos archivos al disco local.
.lrc.Para mas detalles de como usar el editor puedes descargar el manual de uso.
## 📖 Manual de uso
Puedes descargar el manual completo aquí:
Descargar manual de uso
Edita con tus variables el docker-compose.yml
services:
lrc-checker:
image: oct4vyus/lrc-checker:latest
container_name: lrc-checker
restart: unless-stopped
# Variables de entorno configurables
environment:
# Define tu zona horaria
- TZ=America/Argentina/Cordoba
# Define las variables PUID/PGID. Pon el usuario / grupo que tendrá permisos para editar los LRC
- PUID=0
- PGID=0
# Directorio donde está tu música (dentro del contenedor)
- MUSIC_DIR=/music
# Directorio donde se guardarán los reportes
- OUTPUT_DIR=/reports
# Diferencia a partir de la cual se considera error real (no posible final musical)
- REVIEW_THRESHOLD_SEC=60.0
# Verificar archivos .lrc que no tengan audio correspondiente
- CHECK_ORPHANS=true
# Mostrar progreso detallado en los logs
- VERBOSE=true
- SERVER_URL=http://CAMBIAR-POR-IP-DE-TU-SERVIDOR:8080
# Lo que ingreses después del = sera la firma
- SIGNED_MARKER=Oct4vyus Kandle
# Opcional. Si no la ponés, se usa "Oct4vyus Kandle"
# Volúmenes: monta tu biblioteca de música y directorio de reportes
volumes:
# CAMBIA ESTA RUTA por la ruta real de tu biblioteca de música
- /ruta/a/tu/musica:/music:rw
# Directorio donde se guardarán los reportes (JSON y HTML)
- ./reports:/reports
ports:
- "8080:8080" # Cambiá el puerto si lo necesitás
# Opcional: limitar recursos
# deploy:
# resources:
# limits:
# cpus: '0.5'
# memory: 256M
docker-compose.yml las variables básicas:
# Levantar contenedor
docker-compose up -d
Luego abrir en el navegador:
http://IP-SERVIDOR:PUERTO/status Debe responder OK.
http://IP-SERVIDOR:PUERTO/escanear
En bibliotecas grandes puede tardar. Al finalizar muestra:
Escaneo completo: XX archivo(s) en estado REVISAR, XX OK de XX total.
lrc_report.html en la carpeta de informes para revisar y reparar.🤝 Contribuciones ¡Las contribuciones son bienvenidas! Abre un issue o un pull request para sugerir mejoras.
📜 Licencia MIT License
Para intercambiar archivos LRC, compartir experiencias y resolver dudas, podés sumarte a nuestros canales de Telegram:
El siguiente ejemplo muestra un reporte generado por LRC Checker v6.2.0, donde se resumen los resultados del escaneo de la biblioteca:

Si querés apoyar el proyecto, podés hacerlo a través de:
If you love listening to music from your own server and you actually care about the lyrics, you know the story. You install a few apps, add some plugins, and suddenly you’re dealing with missing lyrics, out-of-sync lines, weird versions, and tracks that don’t match the real song.
And when your library gets big, it becomes a mess pretty fast. How do you know which albums are clean, which ones need work, and how many tracks are actually off?
This tool was made to make that easier. It works from any browser, and lets you check, sort, fix, and clean up synced lyrics in your music collection without jumping between apps or doing all the work manually.
It scans your library and generates a visual report called lrc_report.html with categories and quick actions to edit .lrc files.
There are a few easy ways:
The app compares the last timestamp in the .lrc file with the real song duration, using a tolerance you can set in the Docker config.
# Difference in seconds before it counts as a real sync problem
- REVIEW_THRESHOLD_SEC=60.0
Then it sorts everything into categories inside lrc_report.html.
Most of the results are grouped automatically, and a couple of categories are added when you mark files yourself.
The nice part is that the categories are clickable. Instead of looking at a giant list, you can filter the report by type and focus on the songs that actually need attention.
lrc_report.html)The report groups files into categories like these:
.lrc file exists, is valid, and is synced or already checked.lrc file for that track.lrc files that don’t have a matching audio fileCategories based on timing differences
Categories based on what you do
Example of the signature setup in docker-compose.yml:
environment:
- SIGNED_MARKER=Oct4vyus Kandle
If you don’t set one, Oct4vyus Kandle is used by default.
You can do a few useful things directly from the table:
.lrc file.If you want to know more about the editor, you can download the user guide.
You can download the complete manual here: Download user guide
Edit the docker-compose.yml file with your own values:
services:
lrc-checker:
image: oct4vyus/lrc-checker:latest
container_name: lrc-checker
restart: unless-stopped
# Configurable environment variables
environment:
# Set your timezone
- TZ=America/Argentina/Cordoba
# Set the PUID/PGID values. Use the user/group that can edit the LRC files
- PUID=0
- PGID=0
# Folder where your music is located inside the container
- MUSIC_DIR=/music
# Folder where reports will be saved
- OUTPUT_DIR=/reports
# Difference in seconds before it counts as a real sync problem
- REVIEW_THRESHOLD_SEC=60.0
# Check for .lrc files that have no matching audio file
- CHECK_ORPHANS=true
# Show detailed progress in the logs
- VERBOSE=true
- SERVER_URL=http://CHANGE-THIS-TO-YOUR-SERVER-IP:8080
# Whatever comes after the = will be the signature
- SIGNED_MARKER=Oct4vyus Kandle
# Optional. If you do not set it, "Oct4vyus Kandle" is used
# Volumes: mount your music library and the reports folder
volumes:
# CHANGE THIS PATH to your real music library path
- /path/to/your/music:/music:rw
# Folder where reports will be saved (JSON and HTML)
- ./reports:/reports
ports:
- "8080:8080" # Change the port if needed
# Optional: limit resources
# deploy:
# resources:
# limits:
# cpus: '0.5'
# memory: 256M
docker-compose.yml:
docker-compose up -d
Then open this in your browser:
http://SERVER-IP:PORT/status It should say OK.
http://SERVER-IP:PORT/escanear
On big libraries, this can take a while. When it finishes, you’ll see something like: Full scan: XX file(s) in REVIEW, XX OK out of XX total.
lrc_report.html in the reports folder and start fixing the ones that need it.🤝 Contributions Contributions are welcome. If you have an idea, improvement, or bug report, feel free to open an issue or send a pull request.
📜 License MIT License
If you want to swap LRC files, share experiences, or ask for help, you can join the Telegram group:
This is an example of a report generated by LRC Checker v6.2.0:

If you want to help keep it going, you can support it here: