ClawHub

Announcer

v1.2.3

Announce text throughout the house via AirPlay speakers using Airfoil + ElevenLabs TTS.

⭐ 1· 2.1k·2 current·2 all-time
byOliver Drobnik@odrobnik
MIT-0
Download zip
LicenseMIT-0 · Free to use, modify, and redistribute. No attribution required.
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
✓
Purpose & Capability
Name/description (AirPlay announcements using Airfoil + ElevenLabs) match what the files and SKILL.md ask for: python3, ffmpeg, Airfoil, and an ElevenLabs API key. The script calls a sibling elevenlabs speech tool (declared as a required skill in metadata), uses ffmpeg to produce stereo MP3 for AirPlay, and controls Airfoil via AppleScript as expected for macOS.
ℹ
Instruction Scope
Runtime instructions and announce.py are focused on generating TTS (via the ElevenLabs speech script), converting audio with ffmpeg, and controlling Airfoil via osascript/afplay. This is within scope. Note: announce.py executes the sibling elevenlabs script and runs system commands (osascript, afplay, ffmpeg). These behaviors are expected, but you should only install if you trust the elevenlabs skill and the host will run Airfoil/afplay.
✓
Install Mechanism
No install spec — instruction-only plus a local script file. Nothing is downloaded or extracted during install, so there is no remote-install risk from this package itself.
✓
Credentials
Only ELEVENLABS_API_KEY is required (plus optional ANNOUNCER_WORKSPACE to override discovery). That single credential is proportional to the declared need to call ElevenLabs. No unrelated credentials or config paths are requested. The script reads a local config.json for speakers and audio settings (declared in SETUP.md).
✓
Persistence & Privilege
The skill does not request permanent/always-on privileges and does not modify other skills or global agent configuration. It runs only when invoked and controls only local apps (Airfoil/afplay) via AppleScript.
Assessment
This skill appears to do what it says: generate TTS with ElevenLabs, convert it for AirPlay with ffmpeg, and control Airfoil via AppleScript. Before installing, confirm the following: (1) you trust the sibling elevenlabs skill and review its speech.py since announcer invokes it; (2) store ELEVENLABS_API_KEY securely (the skill will send text to ElevenLabs); (3) place and secure ~/clawd/announcer/config.json as it contains your speaker names and voice_id; (4) Airfoil must be installed and running on macOS and the skill will control it via osascript/afplay (local automation); (5) if you share this machine, be aware the script runs subprocesses with the provided text and will execute the elevenlabs script — review that code to ensure it only contacts the ElevenLabs API you expect. No remote downloads or unexpected credentials were found in the package.

Like a lobster shell, security has layers — review code before you run it.

latestvk979echgrnm6ft9zyq714gdaxh827f69

License

MIT-0
Free to use, modify, and redistribute. No attribution required.
Termshttps://spdx.org/licenses/MIT-0.html

Runtime requirements

📢 Clawdis
Binspython3, ffmpeg
EnvELEVENLABS_API_KEY

Comments