✓ Verified 💻 Development ✓ Enhanced Data

Airfoil

Control AirPlay speakers via Airfoil from the command line.

Rating: 4.4 (370 reviews)
Downloads: 7,012 downloads
Version: 1.0.0

Overview

Control AirPlay speakers via Airfoil from the command line.

Complete Documentation

View Source →

🔊 Airfoil Skill

text

╔═══════════════════════════════════════════════════════════╗
    ║                                                           ║
    ║   🎵  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?" 🐸

📖 What Does This Skill Do?

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

⚙️ Requirements

What	Details
OS	macOS (uses AppleScript)
App	Airfoil by Rogue Amoeba
Price	$35 (free trial available)

Installation

Install Airfoil:

bash

# 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! 🚀

🛠️ Commands

`list` — Show All Speakers

bash

./airfoil.sh list

Output:

text

Computer, Andy's M5 Macbook, Sonos Move, Living Room TV

`connect` — Connect to Speaker

bash

./airfoil.sh connect "Sonos Move"

Output:

text

Connected: Sonos Move

💡 Speaker name must match exactly (case-sensitive!)

`disconnect` — Disconnect Speaker

bash

./airfoil.sh disconnect "Sonos Move"

Output:

text

Disconnected: Sonos Move

`volume <0-100>` — Set Volume

bash

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

text

Volume Sonos Move: 40%

`status` — Show Connected Speakers

bash

./airfoil.sh status

Output:

text

Sonos Move: 40%
Living Room TV: 65%

Or if nothing is connected:

text

No speakers connected

🎯 Example Workflows

🏠 "Music in the Living Room"

bash

./airfoil.sh connect "Sonos Move"
./airfoil.sh volume "Sonos Move" 50
# → Now fire up Spotify/Apple Music and enjoy!

🎬 "Movie Night Setup"

bash

./airfoil.sh connect "Living Room TV"
./airfoil.sh volume "Living Room TV" 70
./airfoil.sh disconnect "Sonos Move"  # If still connected

🌙 "All Off"

bash

for speaker in "Sonos Move" "Living Room TV"; do
    ./airfoil.sh disconnect "$speaker" 2>/dev/null
done
echo "All speakers disconnected 🌙"

🔧 Troubleshooting

❌ "Speaker Not Found"

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

❌ "Airfoil Won't Start / No Permission"

Problem: AppleScript can't control Airfoil

Solutions:

System Settings → Privacy & Security → Accessibility
Add Terminal (or iTerm)
Add Airfoil
Restart macOS (sometimes necessary 🙄)

❌ "Volume Doesn't Work"

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

❌ "Airfoil Not Installed"

Problem: execution error: Application isn't running

Solution:

bash

# Start Airfoil
open -a Airfoil

# Or install it
brew install --cask airfoil

❌ "bc: command not found"

Problem: Volume calculation fails

Solution:

bash

# Install bc (should be standard on macOS)
brew install bc

📋 Known Speakers

These speakers have been tested:

Speaker	Type	Notes
Computer	Local	Always available
Andy's M5 Macbook	Mac	When on the network
Sonos Move	Sonos	Bluetooth or WiFi
Living Room TV	Apple TV	Via AirPlay

💡 Use ./airfoil.sh list to discover your own speakers!

🔗 Integration with Clawd

This skill works perfectly with Clawd! Examples:

text

"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

📜 Changelog

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!

🐸 Credits

text

@..@
 (----)
( >__< )   "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! 🐸

Installation

Terminal bash


openclaw install airfoil

Copied!

💻Code Examples

╚═══════════════════════════════════════════════════════════╝

-.txt

> *"Why hop to your Mac when you can croak at it?"* 🐸

---

## 📖 What Does This Skill Do?

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

---

## ⚙️ Requirements

| What | Details |
|------|---------|
| **OS** | macOS (uses AppleScript) |
| **App** | [Airfoil](https://rogueamoeba.com/airfoil/mac/) by Rogue Amoeba |
| **Price** | $35 (free trial available) |

### Installation

1. **Install Airfoil:**

Computer, Andy's M5 Macbook, Sonos Move, Living Room TV

computer-andys-m5-macbook-sonos-move-living-room-tv.txt

---

### `connect <speaker>` — Connect to Speaker

Connected: Sonos Move

connected-sonos-move.txt

> 💡 Speaker name must match exactly (case-sensitive!)

---

### `disconnect <speaker>` — Disconnect Speaker

Disconnected: Sonos Move

disconnected-sonos-move.txt

---

### `volume <speaker> <0-100>` — Set Volume

Volume Sonos Move: 40%

volume-sonos-move-40.txt

---

### `status` — Show Connected Speakers

No speakers connected

no-speakers-connected.txt

---

## 🎯 Example Workflows

### 🏠 "Music in the Living Room"

echo "All speakers disconnected 🌙"

echo-all-speakers-disconnected-.txt

---

## 🔧 Troubleshooting

### ❌ "Speaker Not Found"

**Problem:** `execution error: Airfoil got an error: Can't get speaker...`

**Solutions:**
1. Check exact spelling: `./airfoil.sh list`
2. Speaker name is **case-sensitive** ("sonos move" ≠ "Sonos Move")
3. Speaker must be on the same network
4. Speaker must be powered on and reachable

---

### ❌ "Airfoil Won't Start / No Permission"

**Problem:** AppleScript can't control Airfoil

**Solutions:**
1. **System Settings → Privacy & Security → Accessibility**
2. Add Terminal (or iTerm)
3. Add Airfoil
4. Restart macOS (sometimes necessary 🙄)

---

### ❌ "Volume Doesn't Work"

**Problem:** Volume command has no effect

**Solutions:**
1. Speaker must be **connected** before volume can be set
2. First `connect`, then `volume`
3. Some speakers have hardware-side limits

---

### ❌ "Airfoil Not Installed"

**Problem:** `execution error: Application isn't running`

**Solution:**

brew install --cask airfoil

brew-install---cask-airfoil.txt

---

### ❌ "bc: command not found"

**Problem:** Volume calculation fails

**Solution:**

brew install bc

brew-install-bc.txt

---

## 📋 Known Speakers

These speakers have been tested:

| Speaker | Type | Notes |
|---------|------|-------|
| `Computer` | Local | Always available |
| `Andy's M5 Macbook` | Mac | When on the network |
| `Sonos Move` | Sonos | Bluetooth or WiFi |
| `Living Room TV` | Apple TV | Via AirPlay |

> 💡 Use `./airfoil.sh list` to discover your own speakers!

---

## 🔗 Integration with Clawd

This skill works perfectly with Clawd! Examples:

→ ./airfoil.sh status

-airfoilsh-status.txt

---

## 📜 Changelog

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

---

## 🐸 Credits