railsimulatornet/ugreen-nas-lyrics-downloader repository overview

⁠UGREEN NAS Lyrics Downloader

⁠Deutsch

Der UGREEN NAS Lyrics Downloader ist ein leichtgewichtiges Docker-Paket für UGREEN NAS Systeme mit UGOS.

Das Tool durchsucht eine Musikbibliothek automatisch nach unterstützten Audiodateien und lädt passende Lyrics herunter. Synchronisierte Liedtexte werden als .lrc-Dateien direkt neben den Musikdateien gespeichert. Dadurch können Musik-Apps, Medienserver oder andere Tools die Liedtexte leichter erkennen und anzeigen.

⁠Funktionen

• Automatischer Download synchronisierter Lyrics
• Speicherung als .lrc-Datei direkt neben der Musikdatei
• Docker-basiertes Setup für UGREEN NAS / UGOS
• Deutsche und englische Konfigurationskommentare
• Optionaler JSON-Report und Log-Ausgabe
• Erkennt vorhandene .lrc-Dateien und überspringt sie
• Ideal zum Hinzufügen von Lyrics zu Musikdateien
• Nutzbar mit UGREEN NAS Docker App oder klassischem Docker Compose

⁠Docker Image

Docker Pull:

docker pull railsimulatornet/ugreen-nas-lyrics-downloader:latest

Feste Version:

docker pull railsimulatornet/ugreen-nas-lyrics-downloader:1.0.0

⁠Docker Compose Beispiel

services:
  ugreen_lyrics_downloader:
    image: railsimulatornet/ugreen-nas-lyrics-downloader:latest
    container_name: ugreen_lyrics_downloader
    user: "${PUID:-1000}:${PGID:-10}"
    env_file:
      - .env
    volumes:
      - ${HOST_MUSIC_DIR:-/volume1/Emby/Musik}:/music
      - ./config:/config
      - ./reports:/reports
    restart: "no"

⁠Beispiel .env

HOST_MUSIC_DIR=/volume1/Emby/Musik

PUID=1000
PGID=10

SCAN_INTERVAL_SECONDS=0

AUDIO_EXTENSIONS=.mp3,.flac,.m4a,.mp4,.ogg,.opus

REQUIRE_SYNCED_LYRICS=true
WRITE_PLAIN_AS_LRC=false
WRITE_SIDECAR_LRC=true
WRITE_EMBEDDED_TAGS=false
SKIP_EXISTING_LRC=true
TOUCH_AUDIO_ON_WRITE=true

DRY_RUN=false
REQUEST_DELAY_SECONDS=1.0
MAX_FILES_PER_RUN=0

SAVE_REPORT=true
REPORT_PATH=/reports/last_report.json

LOG_LEVEL=INFO
USER_AGENT=UGREEN-NAS-Lyrics-Downloader/1.0

⁠Installation auf UGREEN NAS

1. Release-Paket von GitHub herunterladen
2. Paket in einen Docker-Projektordner entpacken, zum Beispiel /volume2/docker/UGREEN-NAS-Lyrics-Downloader
3. .env anpassen
4. Projekt über die UGREEN NAS Docker App bereitstellen
5. Log prüfen
6. Erzeugte .lrc-Dateien in der Musikbibliothek kontrollieren

⁠GitHub Repository

https://github.com/Railsimulatornet/UGREEN-NAS-Lyrics-Downloader⁠

⁠Release Download

https://github.com/Railsimulatornet/UGREEN-NAS-Lyrics-Downloader/releases⁠

⁠English

UGREEN NAS Lyrics Downloader is a lightweight Docker package for UGREEN NAS systems running UGOS.

It scans a music library for supported audio files and automatically downloads matching lyrics. Synchronized lyrics are written as .lrc files directly next to the music files. This helps music apps, media servers and other tools detect and display lyrics more easily.

⁠Features

• Automatic download of synchronized lyrics
• Saves .lrc files directly next to the music file
• Docker-based setup for UGREEN NAS / UGOS
• German and English configuration comments
• Optional JSON report and log output
• Detects existing .lrc files and skips them
• Ideal for adding lyrics to music files
• Works with the UGREEN NAS Docker App or regular Docker Compose

⁠Docker image

Docker Pull:

docker pull railsimulatornet/ugreen-nas-lyrics-downloader:latest

Fixed version:

docker pull railsimulatornet/ugreen-nas-lyrics-downloader:1.0.0

⁠Docker Compose example

services:
  ugreen_lyrics_downloader:
    image: railsimulatornet/ugreen-nas-lyrics-downloader:latest
    container_name: ugreen_lyrics_downloader
    user: "${PUID:-1000}:${PGID:-10}"
    env_file:
      - .env
    volumes:
      - ${HOST_MUSIC_DIR:-/volume1/Emby/Musik}:/music
      - ./config:/config
      - ./reports:/reports
    restart: "no"

⁠Example .env

HOST_MUSIC_DIR=/volume1/Emby/Musik

PUID=1000
PGID=10

SCAN_INTERVAL_SECONDS=0

AUDIO_EXTENSIONS=.mp3,.flac,.m4a,.mp4,.ogg,.opus

REQUIRE_SYNCED_LYRICS=true
WRITE_PLAIN_AS_LRC=false
WRITE_SIDECAR_LRC=true
WRITE_EMBEDDED_TAGS=false
SKIP_EXISTING_LRC=true
TOUCH_AUDIO_ON_WRITE=true

DRY_RUN=false
REQUEST_DELAY_SECONDS=1.0
MAX_FILES_PER_RUN=0

SAVE_REPORT=true
REPORT_PATH=/reports/last_report.json

LOG_LEVEL=INFO
USER_AGENT=UGREEN-NAS-Lyrics-Downloader/1.0

⁠Installation on UGREEN NAS

1. Download the release package from GitHub
2. Extract it into a Docker project folder, for example /volume2/docker/UGREEN-NAS-Lyrics-Downloader
3. Adjust .env
4. Deploy the project using the UGREEN NAS Docker App
5. Check the container log
6. Verify that .lrc files were created in the music library

⁠GitHub repository

https://github.com/Railsimulatornet/UGREEN-NAS-Lyrics-Downloader⁠

⁠Release download

https://github.com/Railsimulatornet/UGREEN-NAS-Lyrics-Downloader/releases⁠

⁠License / Lizenz

Community project by Roman Glos.

Not an official UGREEN product.

Copyright (c) 2026 Roman Glos