spotify-applescript

# Spotify AppleScript Control Control the Spotify desktop app using AppleScript. Works reliably with the macOS Spotify app without API rate limits or OAuth. ## Requirements - Spotify desktop app installed and running on macOS - No setup required - just works ## Quick Start ```bash # Play a playlist spotify play "spotify:playlist:665eC1myDA8iSepZ0HOZdG" spotify play "https://open.spotify.com/playlist/665eC1myDA8iSepZ0HOZdG" # Play an episode spotify play "spotify:episode:5yJKH11UlF3sS3gcKKaUYx" spotify play "https://open.spotify.com/episode/5yJKH11UlF3sS3gcKKaUYx" # Play a track spotify play "spotify:track:7hQJA50XrCWABAu5v6QZ4i" # Playback control spotify pause # Toggle play/pause spotify next # Next track spotify prev # Previous track spotify status # Current track info # Volume control spotify volume 50 # Set volume (0-100) spotify mute # Mute spotify unmute # Unmute ``` ## Spotify CLI Wrapper The `spotify` command is a wrapper script at `{baseDir}/spotify.sh` ### Commands | Command | Description | Example | |---------|-------------|---------| | `play <uri>` | Play track/album/playlist/episode | `spotify play spotify:track:xxx` | | `pause` | Toggle play/pause | `spotify pause` | | `next` | Next track | `spotify next` | | `prev` | Previous track | `spotify prev` | | `status` | Show current track info | `spotify status` | | `volume <0-100>` | Set volume | `spotify volume 75` | | `mute` | Mute | `spotify mute` | | `unmute` | Unmute | `spotify unmute` | ### URI Formats Accepts both Spotify URIs and open.spotify.com URLs: - `spotify:track:7hQJA50XrCWABAu5v6QZ4i` - `https://open.spotify.com/track/7hQJA50XrCWABAu5v6QZ4i` - `spotify:playlist:665eC1myDA8iSepZ0HOZdG` - `https://open.spotify.com/playlist/665eC1myDA8iSepZ0HOZdG?si=xxx` - `spotify:episode:5yJKH11UlF3sS3gcKKaUYx` - `https://open.spotify.com/episode/5yJKH11UlF3sS3gcKKaUYx` - `spotify:album:xxx` - `spotify:artist:xxx` The script auto-converts URLs to URIs. ## Direct AppleScript Commands For more control, use AppleScript directly: ```bash # Play osascript -e 'tell application "Spotify" to play track "spotify:playlist:xxx"' # Pause/Play toggle osascript -e 'tell application "Spotify" to playpause' # Next/Previous osascript -e 'tell application "Spotify" to next track' osascript -e 'tell application "Spotify" to previous track' # Get current track osascript -e 'tell application "Spotify" set trackName to name of current track set artistName to artist of current track return trackName & " by " & artistName end tell' # Get player state osascript -e 'tell application "Spotify" to player state' # Set volume (0-100) osascript -e 'tell application "Spotify" to set sound volume to 75' # Get current position (in seconds) osascript -e 'tell application "Spotify" to player position' # Set position (in seconds) osascript -e 'tell application "Spotify" to set player position to 30' ``` ## Available Properties ```applescript tell application "Spotify" name of current track -- Track name artist of current track -- Artist name album of current track -- Album name duration of current track -- Duration in ms player position -- Position in seconds player state -- playing/paused/stopped sound volume -- 0-100 repeating -- true/false repeating enabled -- true/false shuffling -- true/false shuffling enabled -- true/false end tell ``` ## Examples ### Agent Usage When the user says: - "Play my power hour playlist" → extract playlist URI and run `spotify play <uri>` - "Pause the music" → run `spotify pause` - "Next track" → run `spotify next` - "What's playing?" → run `spotify status` ### Play a specific episode ```bash spotify play https://open.spotify.com/episode/5yJKH11UlF3sS3gcKKaUYx ``` ### Get full track info ```bash osascript -e 'tell application "Spotify" return "Track: " & (name of current track) & "\nArtist: " & (artist of current track) & "\nAlbum: " & (album of current track) & "\nState: " & (player state as string) end tell' ``` ## Installation The skill is self-contained. To make the `spotify` command available system-wide: ```bash chmod +x {baseDir}/spotify.sh sudo ln -sf {baseDir}/spotify.sh /usr/local/bin/spotify ``` Or add the skill directory to PATH. ## Troubleshooting **"Spotify got an error"** - Make sure Spotify desktop app is running - Spotify must be launched at least once to accept AppleScript commands **Play command does nothing** - Verify the URI format is correct - Try playing from Spotify app first to ensure the content exists **No audio** - Check system volume and Spotify app volume - Ensure correct output device is selected in Spotify preferences ## Limitations - Requires Spotify desktop app to be running - macOS only (uses AppleScript) - Cannot search or browse library (use web interface or app for discovery) - Cannot manage playlists (add/remove tracks) For playlist management and search, use the web interface or consider the `spotify-player` skill (requires OAuth setup).