| name | home-music |
| description | Control whole-house music scenes combining Spotify playback with Airfoil speaker routing. Quick presets for morning, party, chill modes. |
| homepage | local |
| metadata | {"clawdbot":{"emoji":"๐ ","os":["darwin"]}} |
| triggers | ["music scene","morning music","party mode","chill music","house music","stop music"] |
โช โซ โช โซ โช โซ โช โซ โช โซ โช โซ โช โซ โช โซ โช โซ โช โซ
๐ H O M E M U S I C ๐ต
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Whole-House Music Scenes โ
โ One command. All speakers. Perfect. โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โช โซ โช โซ โช โซ โช โซ โช โซ โช โซ โช โซ โช โซ โช โซ โช โซ
"Why click 17 times when one command does the job?" โ Owen ๐ธ
๐ฏ What Does This Skill Do?
Home Music combines Spotify + Airfoil into magical music scenes. One command โ and the right playlist plays on the right speakers at the perfect volume.
Imagine:
- You wake up โ
home-music morning โ Gentle tunes in the bathroom
- Friends arrive โ
home-music party โ All speakers blasting rock
- Time to relax โ
home-music chill โ Lounge vibes everywhere
- Done for the day โ
home-music off โ Silence. Peace. Serenity.
๐ Dependencies
| What | Why | Link |
|---|
| ๐ macOS | This skill uses AppleScript | โ |
| ๐ข Spotify Desktop App | The music source! Must be running. | spotify.com |
| ๐ก Airfoil | Routes audio to AirPlay speakers | rogueamoeba.com |
| ๐ต spotify-applescript | Clawdbot skill for Spotify control | skills/spotify-applescript/ |
โ ๏ธ Important: Both Spotify and Airfoil must be running before you start any scenes!
๐ฌ Scenes
๐
Morning
A gentle start to your day
home-music morning
- Speaker: Sonos Move
- Volume: 40%
- Playlist: Morning Playlist
- Vibe: โ Coffee + good vibes
๐ Party
Time to celebrate!
home-music party
- Speaker: ALL (Computer, MacBook, Sonos Move, Living Room TV)
- Volume: 70%
- Playlist: Rock Party Mix
- Vibe: ๐ค Neighbors hate this one trick
๐ Chill
Pure relaxation
home-music chill
- Speaker: Sonos Move
- Volume: 30%
- Playlist: Chill Lounge
- Vibe: ๐ง Om...
๐ Off
Silence
home-music off
- Pauses Spotify
- Disconnects all speakers
- Vibe: ๐คซ Finally, peace and quiet
๐ Status
What's playing right now?
home-music status
Shows:
- Current Spotify track
- Connected speakers
๐ง Installation
chmod +x ~/clawd/skills/home-music/home-music.sh
sudo ln -sf ~/clawd/skills/home-music/home-music.sh /usr/local/bin/home-music
Now home-music works from anywhere in your terminal! ๐
๐จ Custom Playlists & Scenes
Changing Playlists
Open home-music.sh and find the playlist configuration:
PLAYLIST_MORNING="spotify:playlist:19n65kQ5NEKgkvSAla5IF6"
PLAYLIST_PARTY="spotify:playlist:37i9dQZF1DXaXB8fQg7xif"
PLAYLIST_CHILL="spotify:playlist:37i9dQZF1DWTwnEm1IYyoj"
How to find Playlist URIs:
- Right-click on a playlist in Spotify
- "Share" โ "Copy Spotify URI"
- Or copy the URL and extract the
/playlist/ part
Adding a New Scene
Add a new case in the main block:
scene_workout() {
echo "๐ช Starting Workout scene..."
airfoil_set_source_spotify
airfoil_connect "Sonos Move"
sleep 0.5
airfoil_volume "Sonos Move" 0.8
"$SPOTIFY_CMD" play "spotify:playlist:YOUR_WORKOUT_PLAYLIST"
"$SPOTIFY_CMD" volume 100
echo "โ
Workout: Sonos Move @ 80%, Pump it up!"
}
workout)
scene_workout
;;
Available Speakers
ALL_SPEAKERS=("Computer" "Andy's M5 Macbook" "Sonos Move" "Living Room TV")
You can add any AirPlay speaker โ they just need to be visible in Airfoil.
๐ Troubleshooting
โ "Speaker won't connect"
Check 1: Is Airfoil running?
pgrep -x Airfoil || echo "Airfoil is not running!"
Check 2: Is the speaker on the network?
- Open the Airfoil app
- Check if the speaker appears in the list
- Try connecting manually
Check 3: Is the name exactly correct?
- Speaker names are case-sensitive!
- Open Airfoil and copy the exact name
โ "No sound"
Check 1: Is Spotify playing?
~/clawd/skills/spotify-applescript/spotify.sh status
Check 2: Is the Airfoil source correct?
- Open Airfoil
- Check if "Spotify" is selected as the audio source
- If not: Click "Source" โ Select Spotify
Check 3: Speaker volume?
osascript -e 'tell application "Airfoil" to get volume of (first speaker whose name is "Sonos Move")'
โ "Spotify won't start"
Is Spotify open?
pgrep -x Spotify || open -a Spotify
Is spotify-applescript installed?
ls ~/clawd/skills/spotify-applescript/spotify.sh
โ "Permission denied"
chmod +x ~/clawd/skills/home-music/home-music.sh
๐ Direct Airfoil Commands
If you want to control Airfoil manually:
osascript -e 'tell application "Airfoil" to connect to (first speaker whose name is "Sonos Move")'
osascript -e 'tell application "Airfoil" to set (volume of (first speaker whose name is "Sonos Move")) to 0.5'
osascript -e 'tell application "Airfoil" to disconnect from (first speaker whose name is "Sonos Move")'
osascript -e 'tell application "Airfoil" to get name of every speaker whose connected is true'
osascript -e 'tell application "Airfoil"
set theSource to (first application source whose name contains "Spotify")
set current audio source to theSource
end tell'
๐ Files
skills/home-music/
โโโ SKILL.md # This documentation
โโโ home-music.sh # The main script
๐ก Pro Tips
-
Set aliases for even faster access:
alias mm="home-music morning"
alias mp="home-music party"
alias mc="home-music chill"
alias mo="home-music off"
-
Use with Clawdbot:
"Hey, start party mode"
"Put on some chill music"
"Stop the music"
-
Combine scenes: Create a dinner scene with a jazz playlist at 25% โ perfect for guests!
๐ธ Credits
โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ โ
โ Crafted with ๐ by Owen the Frog ๐ธ โ
โ โ
โ "Ribbit. Music makes everything better." โ
โ โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
Author: Andy Steinberger (with help from his Clawdbot Owen the Frog ๐ธ)
Version: 1.0.0
License: MIT
Pond: The one with the water lilies ๐ชท
Did this skill improve your life? Owen appreciates flies. ๐ชฐ
