### Start Local Mock Daemon

Source: https://github.com/fiso64/sockseek/blob/master/docs/api.md

Use this command to start a local mock daemon for client development. It requires a directory of mock music files and specifies various configuration options for the mock server.

```bash
python scripts/create_mock_music_library.py -o /tmp/sockseek-fixture

dotnet run --project Sockseek.Cli -- daemon \
  --mock-files-dir /tmp/sockseek-fixture/mock-library \
  --mock-files-no-read-tags \
  --mock-files-slow \
  --server-port 5030 \
  -p /tmp/sockseek-out
```

--------------------------------

### Build and Start Sockseek Container

Source: https://github.com/fiso64/sockseek/blob/master/docs/docker.md

Clone the Sockseek repository, navigate to the directory, and start the Docker Compose stack to build and run the container.

```shell
clone https://github.com/fiso64/sockseek
cd Sockseek
docker compose up -d
```

--------------------------------

### Start Sockseek Daemon and Connect CLI

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Starts the Sockseek daemon on a specified IP and port, and then connects the CLI client to it using a remote URL.

```bash
sockseek daemon --server-ip 0.0.0.0 --server-port 5030
sockseek "Artist - Title" --remote http://127.0.0.1:5030
```

--------------------------------

### Example Sockseek Configuration File

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Illustrates the basic syntax for a Sockseek configuration file, including username, password, and preferences.

```ini
username = your-username
password = your-password
pref-format = flac
fast-search = true
```

--------------------------------

### Configuration Profile Example

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Shows how to define a configuration profile named 'lossless' to set specific preferences.

```ini
[lossless]
pref-format = flac,wav
```

--------------------------------

### Sockseek Configuration Profile for Wishlist

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Example of a profile configuration in sockseek.conf for managing a wishlist. This setup includes input file path, input type, index path for tracking downloaded items, and a log file.

```ini
[wishlist]
input = ~/sockseek/wishlist.txt 
input-type = list
index-path = ~/sockseek/wishlist-index.sockseek
log-file = ~/sockseek/wishlist.log
```

--------------------------------

### Wishlist File Format Example

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Example of how to format entries in the wishlist.txt file. Each line can specify a song or album with optional parameters like strict matching and desired format.

```text
"Artist - My Favorite Song"            strict-title=true;format=flac
a:"Artist - Some Album"                strict-album=true;album-track-count=5
```

--------------------------------

### List File Input Example

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Demonstrates the format for a text file used with `--input-type=list`. Supports various input types and optional conditions for filtering search results.

```text
# Any input type                conditions (optional)           pref. conditions (optional)
"Artist - Song"                 "format=mp3; br>128"            "br >= 320"

# Album download shorthand:
a:"Artist - Album"              strict-album=true;album-track-count=13

# Any other input type is also accepted:
path/to/tracks.csv
https://www.youtube.com/playlist?list=blah
```

--------------------------------

### Basic Name Format Example

Source: https://github.com/fiso64/sockseek/blob/master/README.md

A simple naming pattern using artist and title tags. This is a basic format for naming files.

```text
{artist} - {title}
```

--------------------------------

### Configure Cron Job for Sockseek

Source: https://github.com/fiso64/sockseek/blob/master/docs/docker.md

Example of a cron job entry to run Sockseek for a specific task, such as searching for missing tracks from a Spotify playlist. This entry specifies the schedule and the command with its arguments.

```shell
# min   hour    day     month   weekday command
0 1 * * 0 sockseek https://open.spotify.com/playlist/6sf1WR5grXGJ6dET -c /config -p /data --index-path /data/index.sockseek --spotify-id 123456 --spotify-secret 123456
```

--------------------------------

### yt-dlp Integration for Sockseek Downloads

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Configure Sockseek to use yt-dlp for downloading tracks not found on Soulseek. Ensure yt-dlp is installed and accessible via the command line.

```bash
--yt-dlp                        Use yt-dlp to download tracks that weren't found on
                                Soulseek. yt-dlp must be available from the command line.
--yt-dlp-argument <str>         The command line arguments when running yt-dlp. Default:
                                "{id}" -f bestaudio/best -ci -o "{savepath-noext}.%(ext)s" -x
                                Available vars are: {id}, {savedir}, {savepath},
                                {savepath-noext}.
                                Warning: If you change the -o parameter, Sockseek won't be able
                                to index the downloaded files.
                                Note that -x causes yt-dlp to download webms in case ffmpeg
                                is unavailable.
```

--------------------------------

### Interactive Album Download with Track Count Filter

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Initiate an interactive album download, filtering to include only albums with a specified minimum number of tracks. The example filters for albums with 13 or more tracks.

```bash
sockseek "Album Name" -at --atc 13+
```

--------------------------------

### Configuring Conditions with --cond and --pref

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Demonstrates how to supply conditions and preferences as a semicolon-delimited string using command-line arguments.

```bash
--cond "br>=320; format=mp3,ogg; sr<96000" --pref "album-track-count>=8; required-track-title=Intro"
```

--------------------------------

### Test Search Logic with Mock Files

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Utilize the --mock-files-dir option to test search and download logic using local audio files instead of live Soulseek searches. This is useful for testing with a large music library.

```bash
sockseek "Artist - Album" -at --mock-files-dir /path/to/dir
```

```bash
sockseek "Artist - Album" -at --mock-files-dir /path/to/dir --mock-files-no-read-tags
```

--------------------------------

### Preview Playlist Tracks Before Download

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Check up to 10 tracks from a large playlist before initiating a full download. Use `--print-tracks-full` for detailed track information.

```bash
sockseek "input" -n 10 --print-tracks-full
```

--------------------------------

### Daemon / Remote Options for Sockseek

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Options for running sockseek as a daemon or connecting to a remote daemon.

```text
sockseek daemon                 Start the HTTP/SignalR daemon instead of running a download
--server-ip <ip>                IP/interface for the daemon HTTP API (default: 127.0.0.1)
--server-port <port>            Port for the daemon HTTP API (default: 5030)
--remote <url>                  Use an existing daemon instead of running locally
```

--------------------------------

### Download Options Reference

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Commonly used flags for controlling download behavior, such as downloading entire folders or interactively selecting files.

```text
-a, --album                     Download a whole folder instead of a single file
-t, --interactive               Pick from album results before downloading
-g, --aggregate                 Download distinct songs/albums from grouped results
-p, --path <path>               Download directory
--pref-format <formats>         Preferred formats for ranking, e.g. flac,wav. Unordered.
--format <formats>              Required accepted formats. Unordered.
--album-track-count <count>     Required number of audio files when downloading albums
--skip-music-dir <path>         Skip tracks already in a music library
--profile <names>               Apply configuration profile(s)
--name-format <format>          Organize files using a path template
--strict-title/artist/album     Require title in filename, artist in path, album in folder path
```

--------------------------------

### Queue Downloaded Audio Files in foobar2000

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Queues downloaded audio files into foobar2000 upon successful download. This command hides the window and checks if the file is audio before adding it.

```ini
on-complete = when=success hidden -- cmd /c if {is-audio}==true start "" "path\to\foobar2000.exe" /immediate /add "{path}"
```

--------------------------------

### Conditional Profile Configuration

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Demonstrates defining profiles with conditions, such as 'no-stale' for album downloads and 'youtube' for specific download paths.

```ini
# never automatically cancel album downloads in interactive mode
[no-stale]
profile-cond = interactive && download-mode == "album"
max-stale-time = 9999999

# download to another location for YouTube
[youtube]
profile-cond = input-type == "youtube"
path = ~/downloads/sockseek-youtube
```

--------------------------------

### Fast Search Options for Sockseek

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Configure rapid downloading and candidate acceptance criteria. These options are primarily for normal download modes.

```bash
--fast-search                   Begin downloading as soon as a file satisfying the preferred
                                conditions is found. Only for normal download mode.
--fast-search-delay <ms>        Delay before accepting fast-search candidates (default: 300)
--fast-search-min-up-speed <n>  Minimum upload speed for fast-search candidates (default: 1)
```

--------------------------------

### General Sockseek Options

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Provides a comprehensive list of general options for managing downloads, input types, naming conventions, and concurrency.

```text
-p, --path <path>               Download directory
--input-type <type>             [csv|youtube|spotify|bandcamp|string|list|soulseek|
                                musicbrainz] (default: auto)
--name-format <format>          Name format for downloaded tracks. See `--help name-format`
--invalid-replace-str <str>     Replacement string for invalid path characters (default: space)

-n, --number <maxtracks>        Download the first n tracks of a playlist
-o, --offset <offset>           Skip a specified number of tracks
-r, --reverse                   Download tracks in reverse order
-c, --config <path>             Set config file location. Set to 'none' to ignore config
--no-config                     Ignore any config file
--profile <names>               Configuration profile(s) to use. See `--help config`.
--concurrent-jobs <num>         Max concurrent leaf jobs (default: 20)
--concurrent-searches <num>     Max concurrent Soulseek searches (default: 2)
--concurrent-extractors <num>   Max concurrent input extractors (default: 4)
--write-playlist                Create an m3u playlist file in the output directory
--playlist-path <path>          Override default path for m3u playlist file
--no-write-index                Do not create/update the Sockseek index
--index-path <path>             Override default path for Sockseek index
--no-incomplete-ext             Save files with their final name instead of a temporary
                                `.incomplete` extension.

--no-skip-existing              Do not skip downloaded tracks
--skip-mode-output-dir <mode>   How to match files in the output dir: name|tag|index
                                (default: index)
--skip-check-cond               Check file conditions when skipping existing files
--skip-check-pref-cond          Check preferred conditions when skipping existing files
--skip-music-dir <path>         Also skip downloading tracks found in a music library
--skip-mode-music-dir <mode>    How to match files in --skip-music-dir: name|tag
                                (default: name)
--skip-not-found                Skip searching for tracks that weren't found on Soulseek
                                during the last run.

--listen-port <port>            Port for incoming connections (default: 49998)
--no-listen                     Disable the incoming connection listener
--connect-timeout <ms>          Timeout used when logging in to Soulseek (default: 20000ms)
--user-description <desc>       Optional description text for your Soulseek account
--shared-files <int>            Number of files you share on Soulseek (default: 0)
--shared-folders <int>          Number of folders you share on Soulseek (default: 0)

--on-complete <command>         Run a command when a download completes. See `--help
                                on-complete`
```

--------------------------------

### Download an Album Interactively with Sockseek

Source: https://github.com/fiso64/sockseek/blob/master/README.md

This command allows for interactive album downloads. The '-at' flag enables interactive mode for album downloads, letting you choose which tracks to download.

```bash
sockseek "Artist - Album Title" -at
```

--------------------------------

### Download All Artist Albums Interactively

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Interactively download all albums by a specified artist, sorted by popularity. This may include compilations.

```bash
sockseek "artist=Artist Name" -agt
```

--------------------------------

### Convert Downloaded Audio Files to MP3 on Windows

Source: https://github.com/fiso64/sockseek/blob/master/README.md

A multi-step process to convert downloaded audio files to MP3 on Windows, including checks for audio type, existing MP3, and conversion success. Requires ffmpeg.

```ini
# Check if file is audio and not already MP3
on-complete =   when=success hidden -- cmd /c if "{is-audio}"=="true" if /i not "{ext}"==".mp3" if not exist "{path-noext}.mp3" echo true
```

```ini
# Convert to MP3 if check passed
on-complete = + when=success hidden -- cmd /c if /i "{stdout}"=="true" (ffmpeg -i "{path}" -q:a 0 "{path-noext}.mp3" && echo success)
```

```ini
# Delete original and update index if conversion succeeded
on-complete = + when=success hidden update-index -- cmd /c if /i "{stdout}"=="success" (del "{path}" & echo "ignored;{path-noext}.mp3")
```

--------------------------------

### Download a Track with Sockseek

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Use this command to download a specific track by providing the artist and song title as a search string. Sockseek will search the network and download the best match.

```bash
sockseek "Artist - Song Title"
```

--------------------------------

### YouTube Data API Configuration for Sockseek

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Configure Sockseek to use the YouTube Data API for retrieving video information. Requires a valid API key.

```bash
--youtube-key <key>             YouTube Data API key
--get-deleted                   Attempt to retrieve titles of deleted videos from wayback
                                machine. Requires yt-dlp.
--deleted-only                  Only retrieve & download deleted music.
```

--------------------------------

### Printing and Debugging Options for Sockseek

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Options for controlling the verbosity of output and directing debug information. Use `--log-file` to write debug information to a specified file. `--progress-json` enables printing progress events as JSON lines. Various `--print` options allow outputting tracks, search results, or index information in different formats.

```bash
-v, --verbose                   Print extra debug info
```

```bash
-vv, --trace                    Print trace-level debug info
```

```bash
--debug                         Alias for --verbose
```

```bash
--log-file <path>               Write debug info to a specified file
```

```bash
--no-progress                   Disable progress bars/percentages, only simple printing
```

```bash
--progress-json                 Print progress events as JSON lines
```

```bash
--print <option>                Print tracks or search results instead of downloading:
                                'tracks': Print all tracks to be downloaded
                                'tracks-full': Print extended information about all tracks
                                'results': Print search results satisfying file conditions
                                'results-full': Print search results including full paths.
                                'json': Print first result in json format
                                'json-all': Print json of all results in sorted order
                                'link': Print first result slsk:// link
                                'index': Print Sockseek index as formatted json
                                'index-failed': Print failed downloads from Sockseek index
```

```bash
--mock-files-dir <path>         Directory containing files to simulate download results
```

```bash
--mock-files-no-read-tags       Only read filenames when simulating (much faster)
```

```bash
--mock-files-slow               Simulate slow mock-file downloads and folder browses
```

```bash
--mock-files-fail-downloads <n> Simulate n failed mock-file downloads
```

--------------------------------

### Download Album by Song Name

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Use the -a or --album flag to download an entire album when searching for a song within it.

```bash
sockseek "Artist - Album" -a
```

--------------------------------

### Aggregate Download Options for Sockseek

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Options to control aggregate download mode, including finding all distinct songs for an artist or album. Use `--aggregate-length-tol` to specify the maximum length tolerance in seconds for considering tracks or albums equal. `--min-shares-aggregate` sets the minimum number of shares required for a track or album to be downloaded.

```bash
-g, --aggregate                 Aggregate download mode: Find and download all distinct
                                songs associated with the provided artist, album, or title.
```

```bash
--aggregate-length-tol <tol>    Max length tolerance in seconds to consider two tracks or
                                albums equal. (Default: 3)
```

```bash
--min-shares-aggregate <num>    Minimum number of shares of a track or album for it to be
                                downloaded in aggregate mode. (Default: 2)
```

```bash
--relax-filtering               Slightly relax file filtering in aggregate mode to include
                                more results
```

--------------------------------

### Download a Playlist

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Download all songs from a given YouTube playlist URL.

```bash
sockseek "https://www.youtube.com/playlist?list=blah"
```

--------------------------------

### Download a Song by Title

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Use this command to download a specific song by its title. The hyphen can help differentiate artist and title.

```bash
sockseek "Song Title"
sockseek "Artist - Song Title"
```

--------------------------------

### Download Album with Preferred Formats

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Download an album while prioritizing FLAC or WAV formats, but accepting others if necessary.

```bash
sockseek "Artist - Album Title" -a --pref-format flac,wav
```

--------------------------------

### Required Arguments for Sockseek

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Specifies the essential inputs required to run sockseek, including URLs, search strings, or local file paths.

```text
<input>                         A URL, search string, Soulseek link, or path to a local
                                CSV/list file. Run `--help input` to view the accepted inputs.
                                Can also be passed with -i, --input <input>
--user <username>               Soulseek username
--pass <password>               Soulseek password
```

--------------------------------

### CLI Shortcuts for Sockseek

Source: https://github.com/fiso64/sockseek/blob/master/README.md

These shortcuts can be used in the command-line interface to manage jobs. They allow for cancellation, retrying, and retrieving job information.

```bash
c               cancel a job by id or all jobs
t               try next candidate for a job id
i               get detailed info about job by id
```

--------------------------------

### Wishlist Downloader Configuration

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Configure Sockseek to automatically download items from a wishlist file. This involves creating a wishlist file with specific formatting and adding a profile to the sockseek.conf file.

```bash
sockseek --profile wishlist
```

--------------------------------

### Search Album Art with Cover Fetcher

Source: https://github.com/fiso64/sockseek/blob/master/README.md

This snippet searches for album art using Cover Fetcher after a successful album download. It hides the command window and uses Windows command execution.

```ini
on-complete = when=success scope=album hidden -- cmd /c start "" "path\to\CoverFetcher.exe" --from-dir "{path}"
```

--------------------------------

### Interactive Mode CLI Shortcuts

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Interactive mode, enabled with -t/--interactive, allows for manual selection of folders or files. Use these key bindings to navigate and manage downloads within the interactive prompt.

```bash
Up/p            previous folder
Down/n          next folder
Enter/d         download selected folder
y               download folder and disable interactive mode
r               retrieve all files in the folder
s               skip current album
Esc/q           quit program
h               print this help text

d:1,2,3         download specific files
d:start-end     download a range of files
f               filter folders containing files matching query
cd ..           load parent folder
cd subdir       go to subfolder
```

--------------------------------

### Spotify Authenticated Download with Tokens

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Perform a Spotify download using stored refresh and access tokens. This avoids the recurring login flow for authenticated actions.

```bash
sockseek spotify-likes --spotify-id 123456 --spotify-secret 123456 --spotify-refresh 123456 --spotify-token 123456 -n 1 --pt
```

--------------------------------

### Download YouTube Playlist with yt-dlp Fallback

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Download a YouTube playlist, with an option to use yt-dlp as a fallback. This command also retrieves deleted video names.

```bash
sockseek "https://youtube.com/playlist/id" --get-deleted --yt-dlp
```

--------------------------------

### Download an Album Automatically

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Automatically download an entire album. Separating artist and album title with a hyphen is recommended for better results.

```bash
sockseek "Album Title" -a
sockseek "Artist - Album Title" -a
```

--------------------------------

### Spotify API Configuration for Sockseek

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Provide credentials for accessing Spotify services. These are necessary for Sockseek to interact with Spotify playlists or metadata.

```bash
--spotify-id <id>               Spotify client ID
--spotify-secret <secret>       Spotify client secret
--spotify-token <token>         Spotify access token
--spotify-refresh <token>       Spotify refresh token
--remove-from-source            Remove downloaded tracks from source playlist
```

--------------------------------

### Minimal Sockseek Configuration

Source: https://github.com/fiso64/sockseek/blob/master/README.md

This is a minimal configuration file for Sockseek. Ensure you replace 'your-soulseek-username' and 'your-soulseek-password' with your actual Soulseek credentials. You can also specify preferred audio formats like FLAC or WAV.

```ini
username = your-soulseek-username
password = your-soulseek-password
# Sockseek prefers mp3 by default. To prefer lossless (will still
# fall back to mp3 if unavailable):
# pref-format = flac,wav
```

--------------------------------

### Advanced Search and Filtering Options for Sockseek

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Options for handling search ambiguities and managing download retries. Includes desperate search modes and user share filtering.

```bash
--artist-maybe-wrong            Performs an additional search without the artist name.
                                Useful for sources like SoundCloud where the "artist"
                                could just be an uploader. Note that when downloading a
                                YouTube playlist via URL, this option is set automatically
                                on a per-track basis, so it is best kept off in that case.
-d, --desperate                 Tries harder to find the desired track by searching for the
                                artist/album/title only, then filtering. (slower search)
--no-remove-special-chars       Keep special characters in Soulseek search terms
--max-retries <num>             Max download retries per item (default: 10)
--unknown-error-retries <num>   Extra retries for unknown/transient errors (default: 2)
--fails-to-downrank <num>       Number of fails to downrank a user's shares (default: 1)
--fails-to-ignore <num>         Number of fails to ban/ignore a user's shares (default: 2)
```

--------------------------------

### Execute Sockseek Commands in Container

Source: https://github.com/fiso64/sockseek/blob/master/docs/docker.md

Access the running Sockseek container using Docker Compose exec and view help information for the sockseek command.

```shell
docker compose exec sockseek sh
sockseek --help
```

--------------------------------

### Default Required File Conditions

Source: https://github.com/fiso64/sockseek/blob/master/README.md

These are the default conditions Sockseek uses to accept files. They include common audio formats and a tolerance for length discrepancies.

```ini
format = mp3,flac,ogg,m4a,opus,wav,aac,alac
length-tol = 3
```

--------------------------------

### Spotify Private Content Login Flow

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Initiate the Spotify login flow for private playlists, liked songs, or liked albums. Sockseek will attempt to open a browser or log a URL for manual authorization.

```bash
sockseek spotify-likes --spotify-id 123456 --spotify-secret 123456 -n 1 --print-tracks
```

--------------------------------

### Skip Existing Music Files During Download

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Download a playlist from a CSV file, skipping any tracks already present in your specified music directory.

```bash
sockseek "playlist.csv" --skip-music-dir "path/to/music"
```

--------------------------------

### Complex Directory Structure with Conditional Logic

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Organizes files into nested directories based on album artist, album, and track number, with a fallback for missing tags. This allows for structured sorting of music files.

```text
{albumartist(/)album(/)track(. )title|(missing-tags/)slsk-foldername(/)slsk-filename}
```

--------------------------------

### Download Specific Song with Format Preference

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Download a specific song identified by name and length, with a preference for lossless audio formats like FLAC or WAV. Ensure the song title and length are accurate.

```bash
sockseek "MC MENTAL @ HIS BEST, length=242" --pref-format "flac,wav"
```

--------------------------------

### Download Tracks from CSV

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Use this command to download tracks listed in a CSV file. Ensure the CSV file is correctly formatted with track information.

```bash
sockseek "tracks.csv"
```

--------------------------------

### Send Linux Desktop Notification for Album Downloads

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Use this snippet to send a desktop notification on Linux when an album download is successful. It specifies the success condition and album scope.

```ini
on-complete = when=success scope=album -- notify-send "Downloaded: {album}" "{path}"
```

--------------------------------

### Search Rate Limiting Options for Sockseek

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Control the frequency and timing of searches to avoid rate limits or bans. Adjust these based on source server policies.

```bash
--search-timeout <ms>           Max search time in ms (default: 6000)
--max-stale-time <ms>           Max download time without progress in ms (default: 30000)
--searches-per-time <num>       Max searches per time interval. Higher values may cause
                                30-minute bans, see `--help notes`. (default: 34)
--searches-renew-time <sec>     Controls how often available searches are replenished.
                                See `--help notes`. (default: 220)
```

--------------------------------

### Interactive Download of Artist's Albums

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Download all albums featuring a specific artist interactively. The results are sorted by popularity, and you can choose which albums to download or skip. Consider using --strict-artist for more accurate results.

```bash
sockseek "artist=MC MENTAL" -agt
```

--------------------------------

### Apply Strict Matching for Song Downloads

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Use strict filters for song title and artist to improve matching accuracy and avoid downloading incorrect songs.

```bash
sockseek <input> --strict-title --strict-artist
```

--------------------------------

### Default Preferred File Conditions

Source: https://github.com/fiso64/sockseek/blob/master/README.md

These are the default preferences Sockseek applies to rank available files. They prioritize specific formats, bitrates, and metadata matching.

```ini
pref-format = mp3
pref-length-tol = 3
pref-min-bitrate = 200
pref-max-bitrate = 2500
pref-max-samplerate = 48000
pref-strict-title = true
pref-strict-album = true
```

--------------------------------

### Bandcamp HTML Source Option for Sockseek

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Specify a local HTML file as the source for Bandcamp data. Useful for offline processing or custom scraping.

```bash
--from-html <path>              Read Bandcamp page HTML from a local file
```

--------------------------------

### Adjust Length Tolerance for Downloads

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Loosen the default 3-second tolerance for song/album length mismatches, or disable it entirely, to find files with differing lengths.

```bash
--length-tol 10
--length-tol 0
```

--------------------------------

### Print Artist Songs Not in Library

Source: https://github.com/fiso64/sockseek/blob/master/README.md

List all songs by a specified artist that are not present in your local music directory. This command requires the path to your music directory to be specified.

```bash
sockseek "artist=MC MENTAL" -g --skip-music-dir "path/to/music" --print results
```

--------------------------------

### Download Spotify Playlist or Liked Songs

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Download a Spotify playlist or your liked songs by providing the playlist URL or 'spotify-likes'. You must supply your Spotify API credentials (ID, secret, and refresh token if applicable).

```bash
sockseek "https://open.spotify.com/playlist/id" --spotify-id 123456 --spotify-secret 123456
sockseek "spotify-likes" --spotify-id 123456 --spotify-secret 123456 --spotify-refresh 123456
```

--------------------------------

### Filter Album Downloads by Track Count

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Filter album downloads by the expected number of tracks to avoid downloading incorrect folders. Supports exact counts, ranges, and inequalities.

```bash
sockseek "Artist - Album" -a --album-track-count 10
```

--------------------------------

### Conditional Name Format with Fallback

Source: https://github.com/fiso64/sockseek/blob/master/README.md

A more robust naming pattern that falls back to the filename if artist or title tags are missing. This ensures files are named even with incomplete metadata.

```text
{artist( - )title|filename}
```

--------------------------------

### Title Parsing and Filtering Options for Sockseek

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Options to clean and parse track titles for more accurate searching. Includes removal of specific patterns and regex-based filtering.

```bash
--remove-ft                     Remove 'feat.' and everything after before searching
--remove-brackets               Remove square-bracketed text from track titles before search
--extract-artist                Extract artist/title from titles like "Artist - Title"
--parse-title <template>        Parse title fields with placeholders like {artist} - {title}
--regex <regex>                 Remove a regexp from all track titles and artist names.
                                Optionally specify a replacement regex after a semicolon.
                                Add 'T:', 'A:' or 'L:' at the start to only apply this to
                                the track title, artist, or album respectively. Prefix with
                                '+ ' to append a regex rule instead of replacing prior rules.
```

--------------------------------

### Spotify Public Playlist Download

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Download songs from a public Spotify playlist using application credentials. Ensure your Spotify account has a Premium subscription.

```bash
sockseek "https://open.spotify.com/playlist/id" --spotify-id 123456 --spotify-secret 123456
```

--------------------------------

### Download Albums from Spotify Playlist

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Download all albums associated with a Spotify playlist. This requires your Spotify API credentials.

```bash
sockseek "https://open.spotify.com/playlist/id" -a --spotify-id 123456 --spotify-secret 123456
```

--------------------------------

### Remove "feat." or "ft." Artists

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Use the --remove-ft option to clean up artist names by removing 'feat.' or 'ft.' designations.

```bash
sockseek "Artist - Song" --remove-ft
```

--------------------------------

### Remove Text in Parentheses and Keywords

Source: https://github.com/fiso64/sockseek/blob/master/README.md

Employ the --regex option to remove text within parentheses, as well as 'Lyrics' and 'Official' keywords, from YouTube playlist inputs.

```bash
sockseek "YouTube Playlist" --regex "[\\\[\\\]\(\\)].*?[\\\]\(\\)|(?i:lyrics)|(?i:official)"
```

--------------------------------

### Inspect Soulseek Search Results

Source: https://github.com/fiso64/sockseek/blob/master/README.md

View the results returned by Soulseek without initiating a download. Useful for debugging search queries.

```bash
--print results-full
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.