lrc-checker-dockerhub

LRC CHECKER Logo

LRC Checker Herramienta Completa

Versión en Docker Hub Descargas Docker Hub Tamaño de imagen Último release Licencia

Español

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.


✨ Como escanear tus carpetas musicales.

Hay varias formas:

✨ Como categoriza

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.


📊 Informe generado (lrc_report.html)

El informe organiza los archivos en las siguientes links a las categorías mostradas en la tabla:

Categorías definidas por probabilidades estadísticas

Categorías definidas por acción del usuario

✨ Interactuar con la tabla de resultados

Podemos disparar distintas acciones desde las filas de la tabla.

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


🔧 Puesta en marcha

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

⚡ Quick Start

  1. Configurar en docker-compose.yml las variables básicas:
    • Ruta de tu biblioteca de música.
    • Carpeta donde se generan los informes.
    • Puerto e IP del servidor.
  2. Levantar el contenedor.


# Levantar contenedor
docker-compose up -d


Luego abrir en el navegador:

  1. Verificar la conexión:

http://IP-SERVIDOR:PUERTO/status Debe responder OK.

  1. Generar primer informe:

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.

  1. Abrir el archivo 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

🌐 Comunidad y colaboración

Para intercambiar archivos LRC, compartir experiencias y resolver dudas, podés sumarte a nuestros canales de Telegram:

Captura de pantalla del informe

El siguiente ejemplo muestra un reporte generado por LRC Checker v6.2.0, donde se resumen los resultados del escaneo de la biblioteca:

Captura de pantalla del informe

Versión que incorpora IA para generar LRCs

💖 Financiamiento

Si querés apoyar el proyecto, podés hacerlo a través de:


English

LRC CHECKER Logo

LRC Checker

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.


✨ How to scan your music folders

There are a few easy ways:

✨ How it works

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.


📊 The report (lrc_report.html)

The report groups files into categories like these:

Categories 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.

✨ Working with the results table

You can do a few useful things directly from the table:

If you want to know more about the editor, you can download the user guide.

📖 User guide

You can download the complete manual here: Download user guide


🔧 Getting started

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

⚡ Quick start

  1. Set the basics in docker-compose.yml:
    • your music folder
    • where reports will be saved
    • the server IP/port
  2. Start the container.
docker-compose up -d

Then open this in your browser:

  1. Check the service:

http://SERVER-IP:PORT/status It should say OK.

  1. Run the first scan:

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.

  1. Open 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

🌐 Community

If you want to swap LRC files, share experiences, or ask for help, you can join the Telegram group:

Screenshot of the report

This is an example of a report generated by LRC Checker v6.2.0:

Screenshot of the report

Version that incorporates AI to generate LRCs

💖 Support the project

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