Spotify Applescript
Apps & Automationspotify-applescriptSpotify Applescript is an Agent Skill for apps & automation published in the sundial-org/awesome-openclaw-skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Control Spotify desktop app via AppleScript. Play playlists, tracks, albums, episodes, and manage playback. Works reliably with macOS Spotify app without API keys or OAuth.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/sundial-org/awesome-openclaw-skills/blob/HEAD/skills/spotify-applescript/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/spotify-applescript, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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
# 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:7hQJA50XrCWABAu5v6QZ4ihttps://open.spotify.com/track/7hQJA50XrCWABAu5v6QZ4ispotify:playlist:665eC1myDA8iSepZ0HOZdGhttps://open.spotify.com/playlist/665eC1myDA8iSepZ0HOZdG?si=xxxspotify:episode:5yJKH11UlF3sS3gcKKaUYxhttps://open.spotify.com/episode/5yJKH11UlF3sS3gcKKaUYxspotify:album:xxxspotify:artist:xxx
The script auto-converts URLs to URIs.
Direct AppleScript Commands
For more control, use AppleScript directly:
# 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
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
spotify play https://open.spotify.com/episode/5yJKH11UlF3sS3gcKKaUYx
Get full track info
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:
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).