home-music

What This Skill Does

The Home Music skill is an advanced automation bridge for macOS users that synchronizes Spotify playback with Airfoil speaker routing. It transforms complex, multi-step audio management tasks into single-command, scene-based presets. By integrating native AppleScript control with the Airfoil API, this agent allows you to transition your living environment between 'Morning', 'Party', and 'Chill' modes instantly. It handles the heavy lifting of volume scaling, speaker selection, and playlist launching so you can focus on the music rather than toggling menus.

Installation

To install, navigate to your Clawd installation directory and ensure your terminal permissions are set correctly. First, run chmod +x ~/clawd/skills/home-music/home-music.sh to allow the script to execute. Follow this by creating a global symbolic link using sudo ln -sf ~/clawd/skills/home-music/home-music.sh /usr/local/bin/home-music. Ensure that both the Spotify desktop application and Airfoil are active before triggering any commands, as the skill relies on these processes being reachable via their respective APIs.

Use Cases

This skill is perfect for home automation enthusiasts and music lovers who use mixed-brand audio setups. Whether you are automating a morning routine where audio follows you from the bedroom to the kitchen, or managing a dynamic party environment where multiple devices need to be synced via Airfoil, Home Music reduces the friction of manual configuration. It is also ideal for quickly silencing a house when you need to take an unexpected call or transition into a work-from-home mode.

Example Prompts

1. "OpenClaw, get the house ready for guests with the party music scene."
2. "It's time to wind down, switch the speakers to chill mode."
3. "Hey Claw, what is currently playing and which speakers are active?"

Tips & Limitations

The primary limitation of this skill is its dependency on macOS and specifically the active state of the Spotify and Airfoil applications; if these apps are not running, the commands will fail. To customize your experience, navigate to the script header to replace existing Spotify URI strings with your own personal playlists. For the best experience, ensure your Airfoil speakers are pre-named clearly within the Airfoil app itself so the script can accurately identify and route audio to your preferred output devices without confusion.