# Canticle

Canticle is a Go command-line tool and webhook service that fetches time-synced lyrics from Musixmatch, Petit Lyrics, and YouTube Music, saving them as .lrc files (with a .txt fallback for unsynced lyrics or. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2691/canticle

## Description

Canticle is a Go command-line tool and webhook service that fetches time-synced lyrics from Musixmatch, Petit Lyrics, and YouTube Music, saving them as .lrc files (with a .txt fallback for unsynced lyrics or instrumentals) next to your audio files. It can run one-shot, recursively over a whole library, or as a long-running Lidarr webhook server with scheduled scans, making it a good fit for self-hosted music setups that want automatic synced lyrics.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

57/100 (Fair), based on 3 of 4 factors.
- Maintained: 100 (last commit 25 days ago)
- Popular: 6 (1 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Official website: https://sydlexius.github.io/canticle/
- Unraid: https://ca.unraid.net/apps/canticle-1f8bxne0b5bhla?q=Canticle
- GitHub: https://github.com/sydlexius/canticle
- Documentation: https://sydlexius.github.io/canticle/INSTALL/

## Common questions

### Do I need host-to-container path mappings when running Canticle in Docker or Unraid?

No. Canticle uses container-friendly path resolution that prefers the scanned inventory, so Docker or Unraid mount differences do not require host-to-container path maps.

### Can I start the Canticle server without a Musixmatch token and add it later in Settings?

The source says a clean first-run without a Musixmatch token is currently impossible. The container crash-loops instead of opening the web UI where the token can be pasted and stored encrypted rather than in an env var.

### Does the native Linux package start Canticle automatically, and where is its state stored?

No. After installing the native package, copy the example config, set the token, and enable or start the service manually. Its SQLite database is stored in /var/lib/mxlrcgo-svc, and that state directory is preserved on package removal.

### What happens when I install Canticle over an existing mxlrcgo-svc package?

Installing the Canticle native package automatically replaces an existing mxlrcgo-svc install on supported distros. It removes the old package and any stale binary it owned.

### How are updates handled for Canticle installations?

Updates depend on the install method: native packages use the system package manager, Docker or Compose updates use image tags, Homebrew uses brew upgrade, and tarball or source installs are manual.

---
Source: Our Local Host (https://ourlocalhost.com/app/2691/canticle), the self-hosted and open-source app directory.
