Melarka

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:

  1. The file itself: lyrics embedded in the tags.
  2. A .lrc file next to the song: the common format for timed lyrics.
  3. 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:

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

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.