spotify

name	spotify
description	Spotify Web Player control via Playwright
triggers	["spotify","play","music","song","artist","pause","next","previous"]
url	https://open.spotify.com

Spotify

What it does

Controls Spotify Web Player — search, play, pause, skip, volume.

Use when

• User mentions Spotify explicitly
• User says "play [song/artist]"
• User says "pause music", "next song", "previous track"

Security

• Only ever navigate to https://open.spotify.com
• Never extract or log session cookies or auth tokens
• Do not interact with login prompts — user must be pre-logged in

Browser Setup (Best Experience)

Jarvis connects to Chrome via CDP (debug port 9222).

Option A — Use your real Chrome (zero extra login): Add --remote-debugging-port=9222 to your Chrome shortcut target:

"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222

When Chrome is open this way, Jarvis attaches to it directly — your existing Spotify session is used.

Option B — Let Jarvis open automation Chrome (default, one-time login): If no Chrome has the debug port open, Jarvis launches a separate Chrome window using .playwright-profile/chrome/. Log into Spotify once in that window — it persists across restarts.

CRITICAL — playback bug

NEVER use keyboard_press(key="space") on Spotify. Space triggers global play/pause on whatever was last loaded, not the searched song. Always use Playwright click on the specific play button.

How to search and play a song

Prerequisite: User must be logged into Spotify in the Playwright Chrome window. On first use, Chrome opens a fresh profile — log into Spotify there once (it persists). If [data-testid='search-input'] is not found after navigation, the user is not logged in — respond: "Please log into Spotify in the Chrome window that just opened, then ask me again."

1. playwright_focus_tab(url_contains="spotify") — try existing tab first (best-effort, may not find one)
2. playwright_open_url(url="https://open.spotify.com/search") — navigate to the Spotify search page (always use this exact URL, never append the query to the URL)
3. playwright_wait_for(selector="[data-testid='search-input']", timeout_ms=5000) — verify user is logged in; if this times out, stop and tell user to log in first
4. playwright_click(selector="[data-testid='search-input']") — click the search input to focus it
5. playwright_type(selector="[data-testid='search-input']", text="<query>", press_enter=true) — type the search query and press Enter to submit
6. playwright_wait_for(selector="[data-testid='tracklist-row']", timeout_ms=8000) — wait for search results to load
7. playwright_click(selector="[data-testid='tracklist-row']:first-child", click_count=2) — double-click the first track to start playing it immediately
8. (fallback only if track does not auto-play after step 7) playwright_click(selector="[data-testid='control-button-playpause']", strategy="auto") — click the play/pause button in the bottom player bar

IMPORTANT: NEVER append the song name to the URL. Always navigate to /search and type the query. Step 7 MUST use click_count=2 — a single click only highlights the row, a double-click plays it. Do NOT use keyboard_press(key="space") for Spotify (see CRITICAL warning above).

How to toggle play/pause

1. playwright_focus_tab(url_contains="spotify")
2. playwright_click(selector="[data-testid='control-button-playpause']")

How to skip tracks

• Next: playwright_focus_tab(url_contains="spotify") → playwright_click(selector="[data-testid='control-button-skip-forward']")
• Previous: playwright_focus_tab(url_contains="spotify") → playwright_click(selector="[data-testid='control-button-skip-back']")

Primitives used

• playwright_focus_tab(url_contains) — switch to Spotify tab
• playwright_open_url(url) — open Spotify
• playwright_click(selector, strategy, click_count) — click elements; use click_count=2 for tracklist rows
• playwright_type(selector, text) — type search query
• playwright_wait_for(selector, timeout_ms) — wait for results
• playwright_hover(selector) — reveal hidden play buttons