lodesong

Getting started

updated Oct 28, 2026

You need a running Navidrome (or any OpenSubsonic server) and Docker. Setting up everything from scratch (Navidrome, uploads, AI playlists, a domain, Lyterion), or having a coding agent do it: self-hosting.

1. Run it

Next to an existing Navidrome, on the same Docker network:

services:
  player:
    image: ghcr.io/findmalek/lodesong:latest
    restart: unless-stopped
    environment:
      NAVIDROME_URL: http://navidrome:4533
    ports:
      - "8080:8080"
    volumes:
      - player-data:/data
volumes:
  player-data:
docker compose up -d

No Navidrome yet? deploy/full-stack.compose.yaml runs both. Behind a domain: deploy/README.md (Traefik, Caddy, nginx, Dokploy).

NAVIDROME_URL is the address this container uses, not your browser: usually the Navidrome service name on a shared Docker network. Every other setting has a default (configuration).

2. Sign in

Open http://localhost:8080. Above the form, lodesong checks the server:

  • ✓ navidrome 0.64.2 · 12 ms — all good. Sign in with any Navidrome account.
  • ✗ can't reach navidrome — the container can't reach NAVIDROME_URL. See troubleshooting.

Your password goes to the lodesong server only, which turns it into a Subsonic token, checks it with Navidrome and keeps it encrypted. The browser gets a session cookie and never sees the token (security).

3. First run

Right after the first sign-in in a browser:

  1. Make it yours: theme, how much music to keep for offline (the next songs download ahead so they start instantly), and whether to pick up where your phone left off.
  2. Three things worth knowing: ⌘K searches everything (even lyrics), ? lists every shortcut, and the queue follows you between devices.

4. Next

  • Learn the keyboard: press ?, or read shortcuts.
  • Search tricks: search.
  • Lyrics everywhere: lyrics.
  • Use your phone too: sync. Your other computers: devices.
  • Mixes, prompt playlists and the recap: mixes.

On this page