soundcloud

Browse SoundCloud tracks, artists, and playlists from the command line.

soundcloud is a single pure-Go binary. No API key required.

Install

go install github.com/tamnd/soundcloud-cli/cmd/soundcloud@latest

Or grab a prebuilt binary from the releases, or run the container image:

docker run --rm ghcr.io/tamnd/soundcloud:latest --help

Usage

# Search for tracks (default)
soundcloud search "jazz"
soundcloud search "lo-fi hip hop"

# Search for users/artists
soundcloud search "skrillex" --kind users

# Search for playlists
soundcloud search "workout" --kind playlists

# Fetch a user profile
soundcloud user skrillex

# Output formats
soundcloud search "jazz" -o json
soundcloud search "classical" -o csv
soundcloud user skrillex -o table

Commands

Command	Description
search <query>	Search SoundCloud for tracks, users, or playlists
user <permalink>	Fetch a user profile by permalink (e.g. skrillex)
version	Show version information

Search kinds

tracks (default), users, playlists

Global flags

-o, --output string    output format: table|json|jsonl|csv|tsv|url|raw (default "auto")
-n, --limit int        limit number of records (0 = command default: 20)
    --fields strings   comma-separated columns to include
    --no-header        omit header row
    --template string  Go text/template per record
    --timeout duration per-request timeout (default 30s)
    --delay duration   minimum spacing between requests

License

Apache-2.0. See LICENSE.