spotify-cli

For Carbons and Silicons on macOS

Spotify from the command line, with a cue for every moment.

Play, search, queue and manage playlists and podcasts from a terminal or a Silicon. Set checkpoints like 30 seconds left, halfway or song over, and get a Ting when they arrive.

curl -fsSL https://spotify.unlikefraction.com/install.sh | sh

Installs spotify, spotify-daemon and spotify_player, and starts what needs to run. It never logs you in. Then: spotify doctor.

Every control

Play anything by link, URI or search. Pause, skip, seek, volume, shuffle, repeat, likes, lyrics, devices, playlists, podcasts, and a real queue you can reorder and trim.

spotify play --search 'arctic monkeys 505'
spotify seek 50%
spotify queue add spotify:track:… --next
spotify playlist create 'Deep focus'

Verified, not assumed

Each command goes through spotify_player first, is checked against Spotify.app itself, and falls back to AppleScript when it did not take effect. The result says which path worked and why.

{"action": "play", "via": "applescript",
 "fallback": {"from": "spotify_player",
  "reason": {"code": "no_effect", …}}}

Triggers through Ting

Checkpoints by time left, time played, percentage, song end or song change. Firings are durable, retried, never duplicated, and carry your note and ISI.

spotify trigger add --remaining 30s \
  --note 'wrap up the call'
spotify trigger add --end --scope every

For Silicons

  1. spotify iam --json → {"app_id": "spotify", …}
  2. iam silicon-login --app-id spotify --grant-org "$SILICON_ORG" --approve-scopes
  3. spotify login '<SLT>' — exchanges it and registers you with Ting
  4. spotify trigger add --elapsed 50% — you receive spotify.trigger.fired

Every command documents itself (spotify <command> --help), the whole tree is machine-readable (spotify commands --json), guides are bundled offline (spotify docs), and every error says what failed, why, and the exact fix.

Quick startspotify docs usage Triggersspotify docs triggers Playback controlspotify docs playback The queuespotify docs queue Authenticationspotify docs auth Configurationspotify docs config Errorsspotify docs errors The daemonspotify docs daemon Ting integrationspotify docs ting Telemetryspotify docs telemetry Building on itspotify docs development Backend APIspotify docs api Versioningspotify docs versioning