now-playing

Use when the user wants to inspect Now Playing runtime state without changing anything — peek at processes, recent recognitions, capture levels, hygiene activity, promotion progress. Triggers on "what's it doing", "show me logs", "is recognition working", "inspect the orchestrator".

Use when the user needs to generate the third-party credentials Now Playing requires — currently just a Discogs personal access token. Triggers on phrases like "set up my discogs account", "get a discogs token", "discogs api key", "accounts", "credentials", "what api keys do I need".

Use when the user is wiring up the physical audio chain for Now Playing — connecting their turntable, RIAA preamp, RCA splitter, Sonos line-in, and USB audio capture device, or attaching the kiosk display and touch USB cable. Triggers on phrases like "wire the audio", "connect the turntable", "how do I split the signal", "what cables do I need", "set up the hardware", "connect the display".

Use when the user is ready to install the Now Playing backend software on the Pi — cloning the repo, creating the Python venv, writing the .env, syncing their Discogs catalog, and manually verifying audio capture. Triggers on phrases like "install the software", "set up discogs sync", "run uv sync", "create the env file", "verify audio capture", "run capture_proto".

Use when the user wants to enable Last.fm scrobbling on their Now Playing kiosk — guides them through creating a Last.fm API app, minting a permanent session key via the browser-auth dance, writing the three env vars into the Pi's .env, and restarting the orchestrator. Triggers on phrases like "set up last.fm", "enable scrobbling", "scrobble to last.fm", "configure lastfm", "lastfm auth".

Use when the user needs to prepare a fresh Raspberry Pi for Now Playing — flashing Pi OS, setting the hostname, enabling SSH, installing base system packages. Triggers on phrases like "prepare my pi", "flash the sd card", "first time pi setup", "set up the pi", "set the hostname", "enable ssh on the pi".

Use when the user is ready to install the systemd services for Now Playing — the orchestrator and the kiosk Chromium launcher — and confirm both are running and the kiosk URL is reachable. Triggers on phrases like "install the services", "set up systemd", "start the kiosk", "enable autostart", "verify services running", "open the kiosk".

Use when the user wants to install or set up the Now Playing kiosk on a Raspberry Pi for the first time. Triggers on phrases like "help me set this up", "install nowplaying on my pi", "get started", "first time setup", or when the user has just cloned the repo and asks how to begin.

Use when the user needs to configure their Sonos zone for Now Playing — picking a zone name, setting line-in as the playback source, confirming the Pi can reach Sonos over the network. Triggers on phrases like "configure sonos", "set up the zone", "sonos line in", "sonos zone name", "sonos vlan", "sonos discovery not working".

Use when the user asks "what's playing right now" or wants the current track info without opening the kiosk. Just queries the orchestrator and reports.

Use when the user reports the Now Playing kiosk isn't working — service failing, audio device not found, no recognition firing, kiosk showing wrong info, or any error during install. Triggers on phrases like "it's not working", "the kiosk is blank", "no audio", "service won't start", "debug my install".