Self-hosted music with synced lyrics
Synced lyrics, with the current line highlighted as the song plays, are one of the first things people miss when they leave a streaming service. A self-hosted server can have them too. This page explains where Melarka gets lyrics and how to fix them when they are wrong.
Where the lyrics come from
When a song has no stored lyrics, Melarka looks in this order, keeping the best match it finds:
- The file itself: lyrics embedded in the tags.
- A .lrc file next to the song: the common format for timed lyrics.
- Online lyrics services: by default LRCLIB, then NetEase, QQ Music and Kugou.
The order is configurable: lyrics.providers in config.yaml lists the sources in ranking order, and you can remove any to switch it off. The configuration reference is in the docs. NetEase, QQ Music and Kugou are unofficial services that may break or change at any time, which is why they can be switched off.
Fixing lyrics that run early or late
Wrong timing is the usual complaint with synced lyrics, since a lyrics file is matched to one version of a song while your copy may start a second earlier or later. In Melarka anyone, not only the admin, can fix it from the Now Playing screen:
- Shift the lyrics earlier or later;
- align to the line being sung, so the app sets the offset for you;
- report wrong lyrics, which brings up the next best version.
Fixes are stored in Melarka's database and your files are never changed.
Lyrics on the lock screen and in the car
The iPhone and Android apps show the current lyric line on the lock screen and on the car display, in addition to the full synced lyrics in the app. Combined with car autoplay, your favorites can start when you get in and the lyrics follow along.
Good to know
- Melarka includes no lyrics. They are fetched from the sources you allow, on your server.
- Online lyrics depend on those services having your song; very obscure tracks or YouTube-only songs with unusual names may need the title fixed first. Admins can edit titles and artists as overrides, and an optional AI agent skill can clean up messy YouTube names in batches. A cleaner title usually finds lyrics better.
- If you have your own .lrc files, putting them next to the songs is the most reliable route.
Other servers and lyrics
Many servers can show lyrics, depending on the server version and the app you use. Melarka's approach is to handle fetching, ranking and fixing in one place, with its own apps displaying them. If you are weighing options, compare the Navidrome alternative page.
Install in one command
Needs a Linux machine or NAS with Docker.
curl -fsSL https://raw.githubusercontent.com/aaronsuns/melarka/main/deploy/install.sh | sh -s -- /path/to/your/music
Install in one command ★ Melarka on GitHub
Step by step and configuration: docs/install.md.
FAQ
Does Melarka support synced lyrics?
Yes. It reads lyrics from the file, from a .lrc file next to it, or from online services, and shows the current line in the app, on the lock screen and on the car display.
What if the lyrics are early or late?
Anyone can shift them or align them to the line being sung from the Now Playing screen. You can also report wrong lyrics to get the next best version.
Can I turn off online lyrics?
Yes. Remove providers from lyrics.providers in config.yaml, or leave only embedded lyrics and .lrc files.
Does it change my files?
No. Lyrics and fixes are stored in Melarka's own database.