Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Control AirPlay speakers via Airfoil from the command line. Connect, disconnect, set volume, and manage multi-room audio with simple CLI commands.
Control AirPlay speakers via Airfoil from the command line. Connect, disconnect, set volume, and manage multi-room audio with simple CLI commands.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ โ โ ๐ต A I R F O I L S P E A K E R C O N T R O L ๐ต โ โ โ โ Stream audio to any AirPlay speaker โ โ from your Mac via CLI โ โ โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ "Why hop to your Mac when you can croak at it?" ๐ธ
The Airfoil Skill gives you full control over your AirPlay speakers directly from the terminal โ or through Clawd! Connect speakers, control volume, check status โ all without touching the mouse. Features: ๐ก List โ Show all available speakers ๐ Connect โ Connect to a speaker ๐ Disconnect โ Disconnect from a speaker ๐ Volume โ Control volume (0-100%) ๐ Status โ Show connected speakers with volume levels
WhatDetailsOSmacOS (uses AppleScript)AppAirfoil by Rogue AmoebaPrice$35 (free trial available)
Install Airfoil: # Via Homebrew brew install --cask airfoil # Or download from rogueamoeba.com/airfoil/mac/ Launch Airfoil and grant Accessibility permissions (System Settings โ Privacy & Security โ Accessibility) Skill is ready! ๐
./airfoil.sh list Output: Computer, Andy's M5 Macbook, Sonos Move, Living Room TV
./airfoil.sh connect "Sonos Move" Output: Connected: Sonos Move ๐ก Speaker name must match exactly (case-sensitive!)
./airfoil.sh disconnect "Sonos Move" Output: Disconnected: Sonos Move
# Set to 40% ./airfoil.sh volume "Sonos Move" 40 # Set to maximum ./airfoil.sh volume "Living Room TV" 100 # Quiet mode for night time ./airfoil.sh volume "Sonos Move" 15 Output: Volume Sonos Move: 40%
./airfoil.sh status Output: Sonos Move: 40% Living Room TV: 65% Or if nothing is connected: No speakers connected
./airfoil.sh connect "Sonos Move" ./airfoil.sh volume "Sonos Move" 50 # โ Now fire up Spotify/Apple Music and enjoy!
./airfoil.sh connect "Living Room TV" ./airfoil.sh volume "Living Room TV" 70 ./airfoil.sh disconnect "Sonos Move" # If still connected
for speaker in "Sonos Move" "Living Room TV"; do ./airfoil.sh disconnect "$speaker" 2>/dev/null done echo "All speakers disconnected ๐"
Problem: execution error: Airfoil got an error: Can't get speaker... Solutions: Check exact spelling: ./airfoil.sh list Speaker name is case-sensitive ("sonos move" โ "Sonos Move") Speaker must be on the same network Speaker must be powered on and reachable
Problem: AppleScript can't control Airfoil Solutions: System Settings โ Privacy & Security โ Accessibility Add Terminal (or iTerm) Add Airfoil Restart macOS (sometimes necessary ๐)
Problem: Volume command has no effect Solutions: Speaker must be connected before volume can be set First connect, then volume Some speakers have hardware-side limits
Problem: execution error: Application isn't running Solution: # Start Airfoil open -a Airfoil # Or install it brew install --cask airfoil
Problem: Volume calculation fails Solution: # Install bc (should be standard on macOS) brew install bc
These speakers have been tested: SpeakerTypeNotesComputerLocalAlways availableAndy's M5 MacbookMacWhen on the networkSonos MoveSonosBluetooth or WiFiLiving Room TVApple TVVia AirPlay ๐ก Use ./airfoil.sh list to discover your own speakers!
This skill works perfectly with Clawd! Examples: "Hey Clawd, connect the Sonos Move" โ ./airfoil.sh connect "Sonos Move" "Turn the music down" โ ./airfoil.sh volume "Sonos Move" 30 "Which speakers are on?" โ ./airfoil.sh status
VersionDateChanges1.0.02025-01-25Initial release1.1.02025-06-10Documentation polished ๐ธ1.2.02025-06-26Translated to English, ClawdHub-ready!
@..@ (----) ( >__< ) "This skill was crafted with love ^^ ^^ by a frog and his human!" Author: Andy Steinberger (with help from his Clawdbot Owen the Frog ๐ธ) Powered by: Airfoil by Rogue Amoeba Part of: Clawdbot Skills Collection Made with ๐ for the Clawdbot Community Ribbit! ๐ธ
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.