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

2.2 KiB

Raw Blame History

title	description
Quickstart	From install to playing your first track in five minutes — cookie import, search, play, status.

Quickstart

Five minutes from brew install to controlling Spotify from the terminal.

1. Install

brew install steipete/tap/spogo

Other options live in Install.

2. Import your browser cookies

spogo authenticates by reading the cookies your browser already has for open.spotify.com. Make sure you're logged in there in Chrome (or Brave, Edge, Firefox, Safari), then:

spogo auth import --browser chrome

Defaults: Chrome, the Default profile. To pick a non-default profile:

spogo auth import --browser chrome --browser-profile "Profile 1"

If something goes wrong (locked keychain, weird WSL setup), see Auth for auth paste and other fallbacks.

Verify:

spogo auth status

3. Find something to play

spogo search track "weezer say it ain't so" --limit 3

Add --json if you want structured output, or --plain for tab-separated lines.

4. Play it

spogo play spotify:track:7hQJA50XrCWABAu5v6QZ4i

You can also pass an https://open.spotify.com/... URL, or a playlist/album/show URI. spogo figures out the type from the URI; for raw IDs use --type.

5. Drive the rest

spogo status                 # what's playing
spogo pause
spogo next
spogo volume 60
spogo shuffle on
spogo queue add spotify:track:6rqhFgbbKwnb9MLmUQDhG6
spogo device list            # available speakers/players
spogo device set "Kitchen"   # switch playback there

6. Pipe it into something

# What track is playing right now, machine-readable?
spogo status --json | jq -r '.item.name'

# Save the top-5 search results into a playlist
spogo search track "lo-fi" --limit 5 --plain |
  awk '{print $1}' |
  xargs spogo playlist add "Lo-Fi Coding"

Where to next

Auth — cookie details, manual paste, troubleshooting.
Engines — when to choose connect, web, auto, or applescript.
Output — the JSON / plain contract.
Agents — end-to-end automation patterns.
Command Reference — every subcommand and flag.

2.2 KiB Raw Blame History