Skip to main content
spot is built with Rust and installed directly from source. The entire process takes under a minute on a typical machine.
spot is macOS-only. Playback controls rely on AppleScript, which is not available on Linux or Windows.

​
Prerequisites

Before you install, make sure you have the following:
  • macOS — required for AppleScript-based playback
  • Rust 1.83 or later — used to compile and install the binary
  • Spotify desktop app — must be installed for playback commands to work

​
Install spot

1

Install Rust

If you don’t have Rust installed, get it from rustup.rs. The installer sets up rustc, cargo, and the ~/.cargo/bin directory automatically.
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
After installation, restart your terminal or run the following to update your current shell session:
source "$HOME/.cargo/env"
Verify the version:
rustc --version
The output should show 1.83 or later.
2

Clone the repository

git clone https://github.com/kayznari/spot.git
3

Build and install

cd spot && cargo install --path .
Cargo compiles the binary and installs it to ~/.cargo/bin/spot.
4

Verify the installation

spot --version
If the command is not found, your shell’s PATH may not include ~/.cargo/bin. See the note below.

​
PATH configuration

Cargo installs binaries to ~/.cargo/bin. If spot is not found after installation, add that directory to your PATH. For zsh (the default macOS shell), add the following to ~/.zshrc: 
export PATH="$HOME/.cargo/bin:$PATH"
For bash, add the same line to ~/.bash_profile or ~/.bashrc. Then reload your shell: 
source ~/.zshrc

​
Next steps

With spot installed, connect your Spotify developer credentials to enable search.

Authentication

Connect your Spotify developer credentials to enable search

Build docs developers (and LLMs) love

Get started for freeTalk to us