Multi-Tier Lyrics Resolution
YTMDL automatically resolves lyrics for downloaded tracks using a prioritized provider chain.
Resolution Chain
text
Track Metadata
│
▼
┌──────────────┐ HIT (LRC / TXT)
│ LRCLIB │ ────────────────────────> Save Sidecar (.lrc / .txt)
└──────────────┘
│ MISS
▼
┌──────────────┐ HIT (Plain)
│YouTube Music │ ────────────────────────> Save Sidecar (.txt)
└──────────────┘
│ MISS
▼
┌──────────────┐ HIT (Plain)
│Genius (opt.) │ ────────────────────────> Save Sidecar (.txt)
└──────────────┘
│ MISS
▼
Missing- LRCLIB: Primary lyrics source providing synchronized
.lrcand plain.txtlyrics. Tracks identified as instrumental terminate the chain immediately to prevent false matches. - YouTube Music: Secondary fallback extracting official plain lyrics.
- Genius (Optional Fallback): Conservative plain-text search fallback. Disabled by default; can be enabled via
MUSICDL_GENIUS_ENABLED=trueor in Settings. SettingMUSICDL_GENIUS_ACCESS_TOKENswitches searches to the authenticated Genius API.
NOTE
Existing lyrics files are never silently overwritten. Manual refreshes can be initiated on demand from the WebUI.
