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:
music.yhkze.net — Navidrome web player and APIslskd.yhkze.net — slskd download clientModules: modules/features/navidrome.nix,
modules/features/slskd.nix
slskd needs a Soulseek network account. Register one through the official client:
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_PASSWORDrebuild 10.100.0.1Go to https://music.yhkze.net and create an admin account.
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.
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.
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 DEBUGStep 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.
Navidrome auto-scans every hour. Trigger a manual scan after adding files:
Go to https://music.yhkze.net → username menu (top-right) →
Scan Library.
Feishin is installed on workstations via
values/packages/workstation.nix.
Connect to Navidrome:
Settings → Servers → Add ServerOpenSubsonicSaveAutoplay / DJ mode: right-click a track or album →
Add to Radio. Feishin suggests similar songs from the
library based on Last.fm metadata.
Install Symfonium (one-time purchase, available on Play Store).
Connect to Navidrome:
+ → Add media providerSubsonic / OpenSubsonicSaveOffline mode: browse to any album or playlist → three-dot menu →
Make available offline. Symfonium downloads and caches it
locally.
~/Music on the server is the single library root:
user:users 664)/var/lib/slskd holds slskd’s state (share index,
transfer history, config) and is also persisted.
systemctl status navidrome
journalctl -u navidrome -n 50systemctl status slskd
journalctl -u slskd -n 50After adding music to ~/Music, trigger a share re-index
so other Soulseek users can download from the server:
System → Shares → Rescan
# Via web UI: music.yhkze.net → Activity → Quick|Full Scan
# Or restart the service to trigger startup scan
systemctl restart navidromeNavidrome 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.
modules/features/navidrome.nix,
modules/features/slskd.nix