Demo library
A copyright-free library for screenshots, previews and trying the player without your own music. Everything is generated: synthesized tracks (small generative pieces), dithered monochrome covers, tags, some synced lyrics and a few playlists. It is deterministic, so the same seed gives the same library.
bun run demo:library ./demo-music # 19 albums, ~160 tracks, 30 s each (about 150 MB)
bun run demo:library ./demo-music --seconds 10 --seed 7Needs ffmpeg on the path. Tracks are FLAC (about two thirds), Opus 160 and MP3 256, so quality badges and the library
doctor have a believable mix. Each folder has a cover.png (and FLAC/MP3 files embed it); Playlists/*.m3u8 use
relative paths, which Navidrome imports as playlists.
Try it with Navidrome
docker compose -f compose.demo.yaml up -dNavidrome serves ./demo-music on http://localhost:4533. Create the demo user (password demo) on first visit, then
run the player against it (see configuration). PR previews use this same library and account.
Security
lodesong is a thin client in front of your Navidrome. The server in this repo (apps/api/src) is the only thing that talks to Navidrome, and the browser never sees a credential.
Previews
Every pull request from this repo gets one, like Vercel: a build of the PR's player at player-pr-<n>.<PREVIEW_DOMAIN> (its API reference at /api), and one sticky comment on the PR (edited in place, never a new one per push): building as soon as the PR opens, deploying, ready or failed, with the build log, the Dokploy deploy log and, once it's up, the Preview link. Closing the PR deletes the app and marks the comment as deleted. The site (apps/web) is hosted on Vercel, which previews it on every PR with a comment of its own.