announcer-skill

📢 House-wide TTS announcements via AirPlay speakers using Airfoil and ElevenLabs.

An OpenClaw skill.

Works with any AirPlay speakers, including HomePods, Apple TVs, and third-party AirPlay receivers.

How It Works

1. Selects System-Wide Audio as the Airfoil source
2. Connects to all configured speakers and waits until every one is online
3. Sets the volume to the configured level
4. Plays an optional chime (gong) followed by the TTS announcement
5. Disconnects speakers after playback

Quick Start

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

# List available speakers
python3 skills/announcer/scripts/announce.py speakers

See SKILL.md for full documentation, configuration, and usage details.

Documentation

• SKILL.md — agent-facing reference (commands, behavior, limitations)
• SETUP.md — prerequisites, configuration, and setup instructions
• ClawHub — install via ClawHub registry