Music Service

Self-hosted music stack: Navidrome as the streaming server, slskd as a Soulseek P2P download client. Music lives in ~/Music on the server and streams to Feishin (Linux) and Symfonium (Android).

URLs:

Modules: modules/features/navidrome.nix, modules/features/slskd.nix

Initial Setup

Register a Soulseek Account

slskd needs a Soulseek network account. Register one through the official client:

  1. Download the SoulseekQt AppImage
  2. Run it and follow the first-launch account creation flow
  3. Note your username and password — these go into SOPS below

Add SOPS Secrets

Open the secrets file with sops hosts/server/secrets/secrets.yaml, add the entries below, then save and close:

slskd:
  # Soulseek network account (registered at slsknet.org)
  username: YOUR_SOULSEEK_USERNAME
  password: YOUR_SOULSEEK_PASSWORD
  # slskd web UI credentials (make these up)
  web-username: YOUR_WEB_USERNAME
  web-password: YOUR_WEB_PASSWORD

Deploy

rebuild 10.100.0.1

Go to https://music.yhkze.net and create an admin account.

slskd First Run

Go to https://slskd.yhkze.net and log in with the web credentials from SOPS. The Soulseek connection indicator (top-right) should turn green within a minute.

Downloading Music

Finding and Downloading via slskd

Go to https://slskd.yhkze.net → Search, type artist and track or album name.

Criteria for picking a result:

Select files or the whole folder → Download. Files land directly in ~/Music on the server.

Downloading via spotdl

spotdl is available for YouTube-sourced downloads when Soulseek doesn’t have a track. It uses a Spotify album URL as the source of metadata, then fetches audio from YouTube Music.

Since all releases — including singles — are albums on Spotify, the same workflow applies universally.

Step 1 — save the album metadata to a .spotdl file without downloading:

spotdl save "https://open.spotify.com/album/<id>" --save-file album.spotdl --log-level DEBUG

Step 2 — inspect album.spotdl and verify the download_url for each track. spotdl sometimes resolves to edits, remixes, or re-uploads instead of the original. Find the correct YouTube Music URL manually and update download_url in the JSON. Optionally update cover_url as well.

Step 3 — download using the corrected save file:

spotdl download album.spotdl --audio youtube-music --format opus --output "{album}/{artists} - {title}.{output-ext}"

Move the output folder into ~/Music/, then trigger a library scan.

Library Scan

Navidrome auto-scans every hour. Trigger a manual scan after adding files:

Go to https://music.yhkze.net → username menu (top-right) → Scan Library.

Client Setup

Linux — Feishin

Feishin is installed on workstations via values/packages/workstation.nix.

Connect to Navidrome:

  1. Open Feishin → Settings → Servers → Add Server
  2. Select OpenSubsonic
  3. URL: https://music.yhkze.net
  4. Enter your Navidrome credentials → Save

Autoplay / DJ mode: right-click a track or album → Add to Radio. Feishin suggests similar songs from the library based on Last.fm metadata.

Android — Symfonium

Install Symfonium (one-time purchase, available on Play Store).

Connect to Navidrome:

  1. Open Symfonium → + → Add media provider
  2. Select Subsonic / OpenSubsonic
  3. URL: https://music.yhkze.net
  4. Enter your Navidrome credentials → Save

Offline mode: browse to any album or playlist → three-dot menu → Make available offline. Symfonium downloads and caches it locally.

Music Directory

~/Music on the server is the single library root:

/var/lib/slskd holds slskd’s state (share index, transfer history, config) and is also persisted.

Operations

Check Navidrome

systemctl status navidrome
journalctl -u navidrome -n 50

Check slskd

systemctl status slskd
journalctl -u slskd -n 50

Rescan slskd Shares

After adding music to ~/Music, trigger a share re-index so other Soulseek users can download from the server: System → Shares → Rescan

Force Library Rescan

# Via web UI: music.yhkze.net → Activity → Quick|Full Scan
# Or restart the service to trigger startup scan
systemctl restart navidrome

Smart Playlists

Navidrome supports dynamic playlists defined as .nsp files (JSON) placed anywhere inside ~/Music. They are picked up automatically on the next library scan.

Filters use is for exact matches and contains for substring matches. all requires every condition to match (AND); any requires at least one (OR). Nesting any inside all expresses “match all of these, at least one of those”:

{
  "all": [
    {"is": {"loved": true}},
    {"any": [
      {"is": {"genre": "Darkwave"}},
      {"is": {"genre": "Dark Wave"}},
      {"is": {"genre": "Post-Punk"}},
      {"is": {"genre": "Coldwave"}},
      {"is": {"genre": "Goth"}},
      {"is": {"genre": "Gothic Rock"}},
      ...,
      {"is": {"album": "Lionheart"}}
    ]}
  ]
}

Albums with no genre tags can be included explicitly by album name, as shown with Lionheart above.

Save for example as ~/Music/smart-playlists/'Darkwave Favorites.nsp', then trigger a scan.

References