spogo/docs/install.md
Peter Steinberger 032a6ebed8
docs: rebuild docs site with proper navigation, dark mode, and full content
Replace the static one-page index.html with a Node-based docs site
generator. Sidebar nav, per-page TOC, dark mode toggle (system-pref
default, persisted), and a Spotify-green theme with animated equalizer
brand mark and ambient hero gradient.

Adds 11 hand-written doc pages (index, install, quickstart, auth,
playback, library, queue, devices, engines, output, agents,
troubleshooting, commands) alongside existing spec.md and RELEASING.md.

Pages workflow deploys dist/docs-site to GitHub Pages on push to main;
repo Pages source is now "GitHub Actions" instead of legacy /docs.
2026-05-05 09:41:06 +01:00

1.5 KiB

title description
Install Install spogo via Homebrew, go install, or a release binary. macOS, Linux, and Windows are all supported.

Install

spogo ships as a single static Go binary. Pick whichever path matches how you usually install CLIs.

Homebrew (macOS, Linux)

brew install steipete/tap/spogo

That's it — the formula pulls a signed binary from the latest GitHub release.

go install (any platform)

go install github.com/steipete/spogo/cmd/spogo@latest

Builds from source against your local Go toolchain. Requires Go 1.22+.

Pre-built release binaries

Grab a tarball or zip for your OS/arch from the releases page and drop the spogo binary somewhere on PATH:

curl -L https://github.com/steipete/spogo/releases/latest/download/spogo_$(uname -s)_$(uname -m).tar.gz | tar xz
sudo mv spogo /usr/local/bin/
spogo --version

Build from source

git clone https://github.com/steipete/spogo.git
cd spogo
make spogo
./spogo --version

Verify

spogo --version
spogo --help

If --help lists auth, search, play, library, playlist, device, and friends, you're done. Next stop: Quickstart.

Uninstall

  • Homebrew: brew uninstall spogo
  • go install: rm $(which spogo)
  • Manual: delete the binary; remove ~/Library/Application Support/spogo (macOS), ~/.config/spogo (Linux), or %APPDATA%\spogo (Windows) to clear cached cookies and config.