subsonic-shuffler (1.0.0)

Published 2026-05-14 07:03:13 +00:00 by victor in victor/subsonic_shuffle

Setup this registry in the Cargo configuration file (for example ~/.cargo/config.toml):

[registries.forgejo]
index = "sparse+" # Sparse index
# index = "" # Git

[net]
git-fetch-with-cli = true

To install the package using Cargo, run the following command:

cargo add subsonic-shuffler@1.0.0 --registry forgejo

For more information on the Cargo registry, see the documentation.

Disclaimer: This project is completely AI generated.

subsonic-shuffler

A command-line tool that shuffles a Subsonic / OpenSubsonic playlist. It can shuffle a playlist in-place or write the shuffled result to a different playlist.

Requirements

Rust toolchain (edition 2021, MSRV 1.85)
just (optional, for the convenience recipes)
A Subsonic-compatible server (Navidrome, Gonic, etc.)

Configuration

Credentials are read from environment variables:

Variable	Description
`SUBSONIC_URL`	Server base URL
`SUBSONIC_USER`	Username
`SUBSONIC_PASSWORD`	Password

Copy .env.sample to .env and fill in your values. The just recipes load .env automatically.

cp .env.sample .env
$EDITOR .env

Usage

subsonic-shuffler [OPTIONS] [PLAYLIST]

Source options

The source playlist can be specified as a positional argument (by name) or via a flag:

Option	Description
`PLAYLIST`	Source playlist name (positional)
`--source <NAME>`	Source playlist by name
`--source-id <ID>`	Source playlist by ID

If multiple playlists share the same name, the tool errors and lists each one with its ID so you can switch to --source-id.

Destination options

If no destination option is given, the source playlist is shuffled in-place.

Option	Description
(none)	Shuffle the source playlist in-place
`--create <NAME>`	Create a new playlist; fails if a playlist with that name already exists
`--output <NAME>`	Write to a playlist by name; creates it if missing, overwrites if it exists
`--output-id <ID>`	Overwrite an existing playlist by ID

--create, --output, and --output-id are mutually exclusive.

Examples

Shuffle a playlist in-place:

subsonic-shuffler "My Playlist"
subsonic-shuffler --source "My Playlist"
subsonic-shuffler --source-id 42

Create a new shuffled copy (fails if Shuffle Queue already exists):

subsonic-shuffler "My Playlist" --create "Shuffle Queue"

Write the shuffled result to an existing-or-new playlist:

subsonic-shuffler "My Playlist" --output "Shuffle Queue"

Overwrite a specific playlist by ID:

subsonic-shuffler "My Playlist" --output-id 99

Just recipes

just shuffle "My Playlist"                        # in-place by name
just shuffle-id 42                                # in-place by ID
just shuffle-create "My Playlist" "Shuffle Queue" # create new (fails if exists)
just shuffle-output "My Playlist" "Shuffle Queue" # create or overwrite by name
just shuffle-output-id "My Playlist" 99           # overwrite by ID
just build                                        # release build

Building

cargo build --release
# binary at target/release/subsonic-shuffler

ID	Version
anyhow	^1
clap	^4
opensubsonic	^0.3
rand	^0.8
tokio	^1

Details

Cargo

victor/subsonic_shuffle

2026-05-14 07:03:13 +00:00

Victor Gabriel Savu <dev@victorsavu.eu>

18 KiB

Assets (1)

subsonic-shuffler-1.0.0.crate 18 KiB

Versions (1) View all

1.0.0

2026-05-14

Issues