# spotify-cli

> Control the Spotify desktop app on macOS from the command line (Carbons and Silicons), with playback triggers delivered through Ting. CLI `spotify`, always-on `spotify-daemon`, Rust library `silicon-spotify-client`.

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

## Docs
- [Quick start](https://spotify.unlikefraction.com/markdown/usage.md): spotify-cli turns the Spotify desktop app on a Mac into a command-line app. Carbons use it from
- [Triggers](https://spotify.unlikefraction.com/markdown/triggers.md): A trigger is a checkpoint in playback. When it is reached, spotify-daemon sends a Ting to the
- [Playback control](https://spotify.unlikefraction.com/markdown/playback.md): spotify-cli drives Spotify through two tools:
- [The queue](https://spotify.unlikefraction.com/markdown/queue.md): Spotify's own queue can be appended to through the app, but neither the Web API nor AppleScript
- [Authentication](https://spotify.unlikefraction.com/markdown/auth.md): Two separate sign-ins, for two different things.
- [Configuration](https://spotify.unlikefraction.com/markdown/config.md): Settings live in $SILICON_HOME/.spotify/config.json (0600). Set any number of keys with one JSON
- [Errors](https://spotify.unlikefraction.com/markdown/errors.md): Every failure has the same shape, in the CLI (--json: one object on stderr, empty stdout), the
- [The daemon](https://spotify.unlikefraction.com/markdown/daemon.md): spotify-daemon is the always-on half of spotify-cli. There is one per macOS user (one
- [Ting integration](https://spotify.unlikefraction.com/markdown/ting.md): spotify-cli is a proactive app: it notifies Silicons through Ting, which handles delivery,
- [Telemetry](https://spotify.unlikefraction.com/markdown/telemetry.md): spotify-cli records usage and diagnostics in Space Station so failures can be traced and
- [Building on it](https://spotify.unlikefraction.com/markdown/development.md): Everything is open source: https://github.com/unlikefraction/spotify-cli. Reproduce a bug,
- [Backend API](https://spotify.unlikefraction.com/markdown/api.md): Origin: https://backend.spotify.unlikefraction.com. JSON in and out. Errors:
- [Versioning](https://spotify.unlikefraction.com/markdown/versioning.md): | Contract | Version | Where |

## Source
- https://github.com/unlikefraction/spotify-cli
- https://github.com/unlikefraction/spotify-cli/tree/main/crates/client