Sockseek
Sockseek is a command-line downloader for Soulseek. Point it at a search string, Spotify playlist, YouTube playlist, CSV file, Bandcamp page, MusicBrainz release, or Soulseek link; it searches the network, ranks candidate files using your preferences, and downloads the best match (automatically or interactively). It is scriptable, configurable, and can run either as a one-shot CLI tool or as a persistent daemon.
This project was formerly named sldl (and slsk-batchdl before that). See here for why it was renamed to something dumb.
Quick Start
- Download a release for your OS from the releases page.
- Create a config file named sockseek.conf in one of these locations:
- Linux/macOS/Windows: ~/.config/sockseek/sockseek.conf
- Windows: %APPDATA%\sockseek\sockseek.conf
Minimal config:
username = your-soulseek-username
password = your-soulseek-password
output-dir = path/to/your/download/folder
# Sockseek prefers mp3 by default. To prefer FLAC (will still
# fall back to mp3 if unavailable):
# pref-format = flacIf you're running a persistent Soulseek client, use Sockseek with a separate Soulseek account to avoid connection problems.
- Download your first song:
sockseek "Artist - Song Title" -s- Or download an album interactively (-t):
sockseek "Artist - Album Title" -tIf a download is wrong or missing, see When downloads are wrong or missing.
[!NOTE] Sockseek does not share your music folders yet. To keep the Soulseek network healthy, please also share your collection with a regular client like Nicotine+ or slskd. Daemon mode is the path toward longer-running client features, but sharing is not implemented yet.
Common workflows
#### Download a song
sockseek "Song Title" --song
sockseek "Artist - Song Title" --song