Home 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

⚠️ 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...

🎯 Focus

Heads-down work sessions (used by automations)

home-music focus       # default 30%
home-music focus 25    # custom volume percent

• Speaker: Sonos Move
• Volume: 30% (override with an integer percent)
• Playlist: Deep Focus
• Vibe: 🧠 Low-key background music for getting things done

🔇 Off

Silence

home-music off     # alias: home-music stop

• Pauses Spotify
• Disconnects all speakers
• Vibe: 🤫 Finally, peace and quiet

🐍 Python API (for automations)

Automations (e.g. a daily report job) can drive scenes — and, crucially, stop music when work is done — via the bundled home_music Python module:

from home_music import play_focus_mode, play_chill_mode, stop_music

play_focus_mode(volume=30)   # start background work music
# ... do your work ...
stop_music()                 # ALWAYS stop when finished

The module shells out to home-music.sh, so CLI and API behavior never drift.

• Set HOME_MUSIC_DRY_RUN=1 to print intended commands without touching macOS-only tooling — handy for testing the call chain on CI/Linux.
• Override the script location with HOME_MUSIC_SCRIPT=/path/to/home-music.sh.
• Functions never raise by default (music control must not crash your job); pass raise_on_error=True to opt into exceptions.

💡 Tip: Wrap your work in try/finally and call stop_music() in the finally block so the music stops even if the job errors out.

📊 Status

What's playing right now?

home-music status

Shows:

• Current Spotify track
• Connected speakers

🔧 Installation

# Make the script executable
chmod +x ~/clawd/skills/home-music/home-music.sh

# Symlink for global access
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 CONFIGURATION ===
PLAYLIST_MORNING="spotify:playlist:19n65kQ5NEKgkvSAla5IF6"
PLAYLIST_PARTY="spotify:playlist:37i9dQZF1DXaXB8fQg7xif"
PLAYLIST_CHILL="spotify:playlist:37i9dQZF1DWTwnEm1IYyoj"

How to find Playlist URIs:

1. Right-click on a playlist in Spotify
2. "Share" → "Copy Spotify URI"
3. Or copy the URL and extract the /playlist/ part

Adding a New Scene

Add a new case in the main block:

# In home-music.sh after the "scene_chill" function:

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!"
}

# And in the case block:
    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?

# Manually check 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:

# Connect a speaker
osascript -e 'tell application "Airfoil" to connect to (first speaker whose name is "Sonos Move")'

# Set speaker volume (0.0 - 1.0)
osascript -e 'tell application "Airfoil" to set (volume of (first speaker whose name is "Sonos Move")) to 0.5'

# Disconnect a speaker
osascript -e 'tell application "Airfoil" to disconnect from (first speaker whose name is "Sonos Move")'

# List connected speakers
osascript -e 'tell application "Airfoil" to get name of every speaker whose connected is true'

# Set audio source
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 (scenes + stop)
└── __init__.py     # Python API wrapper (home_music: play_focus_mode/stop_music/...)

💡 Pro Tips

1. 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"
   

2. Use with Clawdbot:

   "Hey, start party mode" "Put on some chill music" "Stop the music"

3. 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.1.1
License: MIT
Pond: The one with the water lilies 🪷

Did this skill improve your life? Owen appreciates flies. 🪰