LRC-CheckEdGen

Español English

LRC CheckEdGen Logo

Docker Hub version Docker Hub pulls Latest release License

Español

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:

Funciones principales

Novedades de v1.2.0 y v1.3.0

Despliegue con Docker Compose

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
  1. Crea la red externa una sola vez: docker network create lrc_network.
  2. Guarda el ejemplo como docker-compose.yml y reemplaza las rutas de ejemplo por rutas reales.
  3. Cambia TU_IP_SERVIDOR por la IP o el nombre del servidor accesible desde tu navegador.
  4. Inicia los servicios: docker compose up -d.
  5. Abre http://TU_IP_SERVIDOR:9080.

Variables de entorno

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

Guía rápida de uso

  1. Abre la interfaz en el navegador y revisa el informe de la biblioteca.
  2. Las pistas marcadas como missing no tienen letra.
  3. Pulsa GENERAR LRC en el álbum y selecciona el idioma en el cuadro de diálogo.
  4. Al terminar, el archivo .lrc se guardará junto al audio.

Solución de problemas / Troubleshooting

Captura de pantalla del informe

Agradecimientos

Este proyecto integra funcionalidades del proyecto LRCGen. Muchas gracias a Hakan D. (@final-wav) por su excelente trabajo y por compartirlo con la comunidad.

💖 Financiamiento

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


English

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.

Key features

v1.2.0 and v1.3.0 highlights

Docker Compose and quick start

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.

  1. Create the external network once: docker network create lrc_network.
  2. Save and customize the Compose example as docker-compose.yml.
  3. Start the services with docker compose up -d.
  4. Open http://YOUR_SERVER_IP:9080, review tracks marked missing, and click GENERAR LRC on an album.
  5. Choose the album language in the dialog. The generated .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.

Acknowledgements

This project integrates and builds upon ideas from LRCGen. Many thanks to Hakan D. (@final-wav) for creating and maintaining it.

💖 Support the project

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