name: announcer description: "Announce text throughout the house via AirPlay speakers using Airfoil + ElevenLabs TTS." summary: "House-wide TTS announcements via AirPlay speakers, Airfoil, and ElevenLabs." version: 1.2.3 homepage: https://github.com/odrobnik/announcer-skill metadata: { "openclaw": { "emoji": "📢", "requires": { "bins": ["python3", "ffmpeg"], "apps": ["Airfoil"], "env": ["ELEVENLABS_API_KEY"], "skills": ["elevenlabs"], "platform": "macos" }, }, }

Announcer

Play TTS announcements through AirPlay speakers via Airfoil and ElevenLabs.

How It Works

1. Generate speech via ElevenLabs (high-quality opus → stereo MP3)
2. Connect to AirPlay speakers via Airfoil
3. Play an optional chime (gong) followed by the announcement
4. Disconnect speakers after playback

Setup

See SETUP.md for prerequisites and setup instructions.

Usage

# Announce to all configured speakers
python3 skills/announcer/scripts/announce.py "Dinner is ready!"

# Announce to specific speakers only
python3 skills/announcer/scripts/announce.py "Wake up!" --speakers "Kids Room"

# Skip the chime
python3 skills/announcer/scripts/announce.py "Quick note" --no-gong

File Structure

announcer/
├── SKILL.md
├── assets/
│   └── gong_stereo.mp3      # Announcement chime
└── scripts/
    └── announce.py           # Main announcement script

User config (not part of skill):

~/clawd/announcer/
└── config.json               # Speaker list, voice, audio settings