Control AirPlay speakers via Airfoil from the command line. Connect, disconnect, set volume, and manage multi-room audio with simple CLI commands.
Real data. Real impact.
Growing
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
╔═══════════════════════════════════════════════════════════╗ ║ ║ ║ 🎵 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:
| What | Details |
|---|---|
| OS | macOS (uses AppleScript) |
| App | Airfoil by Rogue Amoeba |
| Price | $35 (free trial available) |
Install Airfoil:
# Via Homebrew brew install --cask airfoilOr download from rogueamoeba.com/airfoil/mac/
Launch Airfoil and grant Accessibility permissions (System Settings → Privacy & Security → Accessibility)
Skill is ready! 🚀
list./airfoil.sh list
Output:
Computer, Andy's M5 Macbook, Sonos Move, Living Room TV
connect <speaker>./airfoil.sh connect "Sonos Move"
Output:
Connected: Sonos Move
💡 Speaker name must match exactly (case-sensitive!)
disconnect <speaker>./airfoil.sh disconnect "Sonos Move"
Output:
Disconnected: Sonos Move
volume <speaker> <0-100># Set to 40% ./airfoil.sh volume "Sonos Move" 40Set 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%
status./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:
./airfoil.sh listProblem: AppleScript can't control Airfoil
Solutions:
Problem: Volume command has no effect
Solutions:
connectvolumeProblem:
execution error: Application isn't runningSolution:
# Start Airfoil open -a AirfoilOr 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:
| Speaker | Type | Notes |
|---|---|---|
| Local | Always available |
| Mac | When on the network |
| Sonos | Bluetooth or WiFi |
| Apple TV | Via AirPlay |
💡 Use
to discover your own speakers!./airfoil.sh list
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
| Version | Date | Changes |
|---|---|---|
| 1.0.0 | 2025-01-25 | Initial release |
| 1.1.0 | 2025-06-10 | Documentation polished 🐸 |
| 1.2.0 | 2025-06-26 | Translated 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! 🐸
</div>No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.