Unofficial CLI for the Spotify API
Find a file
2026-01-20 11:01:43 -05:00
.github/workflows chore(internal): update actions/checkout version 2026-01-17 09:27:33 +00:00
bin chore(internal): codegen related update 2025-11-13 05:11:54 +00:00
cmd/spotted feat(cli): automatic streaming for paginated endpoints 2025-12-11 19:36:32 +00:00
internal chore: update internal comment 2026-01-15 11:08:40 +00:00
pkg/cmd release: 0.23.1 2026-01-17 09:27:46 +00:00
scripts chore(internal): codegen related update 2026-01-15 11:03:38 +00:00
.gitignore chore(cli): add *.exe files back to .gitignore 2025-12-18 21:50:26 +00:00
.goreleaser.yml feat(api): manual updates 2026-01-15 02:01:22 +00:00
.release-please-manifest.json release: 0.23.1 2026-01-17 09:27:46 +00:00
.stats.yml codegen metadata 2026-01-16 19:24:28 +00:00
CHANGELOG.md release: 0.23.1 2026-01-17 09:27:46 +00:00
go.mod feat(api): manual updates 2026-01-15 01:14:16 +00:00
go.sum feat(api): manual updates 2026-01-15 01:14:16 +00:00
LICENSE feat(api): manual updates 2026-01-05 14:10:53 +00:00
README.md chore(docs): Update name in README 2026-01-16 19:24:28 +00:00
release-please-config.json chore(internal): codegen related update 2025-11-13 05:11:54 +00:00
SECURITY.md chore(internal): codegen related update 2025-11-13 05:11:54 +00:00

Spotted CLI

The unofficial CLI for the Spotify Web API.

It is generated with Stainless.

Installation

Installing with Homebrew

brew tap cjavdev/spotted-cli
brew install spotted

Installing with Go

go install 'github.com/cjavdev/spotted-cli/cmd/spotted@latest'

Running Locally

./scripts/run args...

Usage

The CLI follows a resource-based command structure:

spotted [resource] [command] [flags]
spotted albums retrieve \
  --id 4aawyAB9vmqN3uQ7FjRGTy \
  --market ES

For details about specific commands, use the --help flag.

Global Flags

  • --help - Show command line usage
  • --debug - Enable debug logging (includes HTTP request/response details)
  • --version, -v - Show the CLI version
  • --base-url - Use a custom API backend URL
  • --format - Change the output format (auto, explore, json, jsonl, pretty, raw, yaml)
  • --format-error - Change the output format for errors (auto, explore, json, jsonl, pretty, raw, yaml)
  • --transform - Transform the data output using GJSON syntax
  • --transform-error - Transform the error output using GJSON syntax