Skip to content
Projects

f1nniboy/lrcmux has 48 GitHub stars and 5 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 21:58 UTC. Last push 2026-11-14.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

A lyrics API that aggregates every public provider

Self-hosted

README.md

Original

lrcmux logo

lrcmux

A lyrics API that aggregates every public provider

Version License Matrix

Fans out requests across multiple providers, picks the best result, and caches everything.

A public instance runs at lrcmux.dev. The API docs are browsable at lrcmux.dev/docs.

Self-hosting

Docker Compose

The easiest way to run the full stack (API + frontend + Redis):

git clone https://github.com/f1nniboy/lrcmux
cd lrcmux
cp config.example.toml config.toml
docker compose up

The API will be available at http://localhost:8080 and the frontend at http://localhost:3000.

Binary

git clone https://github.com/f1nniboy/lrcmux
cd lrcmux
cp config.example.toml config.toml
go run ./cmd/lrcmux -config config.toml

Fly.io + Cloudflare Workers

The API runs on Fly.io and the frontend on Cloudflare Workers. Set up the API first, then push config.prod.toml as its config:

fly launch --no-deploy
fly secrets set REDIS_URL=redis://...
just deploy-config

Then deploy both:

just deploy

Configuration

See config.example.toml for all available options.

I have a question!

Join the Matrix room at #lrcmux:oss.zone.