Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Tencent SkillHub · AI
Sonos Announce
Play audio on Sonos with intelligent state restoration - pauses streaming, skips Line-In/TV/Bluetooth, resumes everything.
skill openclawclawhub Free
Play audio on Sonos with intelligent state restoration - pauses streaming, skips Line-In/TV/Bluetooth, resumes everything.
⬇ 0 downloads ★ 0 stars Unverified but indexed
Install for OpenClaw
Quick setup
- Download the package from Yavira.
- Extract the archive and review SKILL.md first.
- Import or place the package into your OpenClaw setup.
Package facts
- Download mode
- Yavira redirect
- Package format
- ZIP package
- Source platform
- Tencent SkillHub
- What's included
- SKILL.md, sonos_core.py
Validation
- Use the Yavira download entry.
- Review SKILL.md after the package is downloaded.
- Confirm the extracted package contains the expected setup assets.
Install with your agent
Agent handoff
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
New install
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
Upgrade existing
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Trust & source
Release facts
- Source
- Tencent SkillHub
- Verification
- Indexed source record
- Version
- 1.0.4
Provenance
- Publisher
- clawdianova
- Source page
- View original listing
- Canonical URL
- Open canonical page
Documentation
Sonos Announce
Play audio files on Sonos speakers with intelligent state restoration.
When to use
User wants to play an announcement on Sonos Soundboard effects (airhorn, rimshot, etc.) Any audio playback that should resume previous state This skill handles playback only - audio generation (TTS, ElevenLabs, etc.) is separate.
Quick Start
import sys import os sys.path.insert(0, '/path/to/sonos-announce') from sonos_core import announce # Play audio and restore previous state # Assumes audio is in default media_dir (~/.local/share/openclaw/media/outbound) result = announce('my_audio.mp3')
Installation
pip install soco Requirements: python3 - Python 3 ffprobe - Part of ffmpeg, for audio duration detection soco - Python Sonos library
Core Function
announce(audio_file_path, wait_for_audio=True, media_dir=None)
Parameters
ParameterTypeDefaultDescriptionaudio_file_pathstrrequiredFilename (if using media_dir) or full path to audio filewait_for_audioboolTrueWait for audio to finish playing before returningmedia_dirstrNoneDirectory where audio file is located (HTTP server will serve from here)
Returns
{ 'coordinators': 2, 'states': { '192.168.1.120': { 'uri': 'x-sonos-spotify:spotify%3atrack%3a...', 'position': '0:01:23', 'queue_position': 5, 'was_playing': True, 'is_external': False, 'transport_state': 'PLAYING', 'speaker_name': 'Bedroom' } } }
Simple (file in default media directory)
from sonos_core import announce # File served from default media_dir result = announce('announcement.mp3')
With custom media directory
from sonos_core import announce # Full path to audio file result = announce( 'my_audio.mp3', media_dir='/home/user/audio/announcements' )
Full path (no media_dir)
from sonos_core import announce # Uses directory of file as media_dir result = announce('/full/path/to/audio.mp3')
Environment Variables
Configure the HTTP server for streaming to Sonos: VariableDefaultDescriptionSONOS_HTTP_HOSTauto-detectedLAN IP address (auto-detected)SONOS_HTTP_PORT8888HTTP server port # Set before running (optional) export SONOS_HTTP_HOST=192.168.1.100 # Override auto-detected IP export SONOS_HTTP_PORT=8888 # Override port # Or set in code before importing import os os.environ['SONOS_HTTP_HOST'] = '192.168.1.100' from sonos_core import announce announce('audio.mp3')
Supported Platforms
PlatformStatusNotesmacOS✅ SupportedFull supportLinux✅ SupportedFull supportWindows✅ SupportedUses taskkill and start /b The module automatically detects your platform and uses appropriate commands for: Killing the HTTP server Starting the HTTP server in background
State Restoration
The module intelligently restores previous playback state: Source TypeBehaviorSpotify TrackResumed at exact position (seek)Spotify PlaylistResumed at exact position (seek)Spotify RadioResumed from start (no seek)Internet RadioResumed from start (no seek)Line-InRe-connected to Line-In inputTV/HDMIRe-connected to TV audioBluetoothRe-connected to BluetoothPaused contentLeft paused
Seeking Behavior
Some streaming services don't support seeking to a specific position: Can seek: Spotify tracks, Spotify playlists, local files, queue items Cannot seek: Spotify Radio, TuneIn radio, Pandora, Tidal radio The module automatically detects these and handles accordingly.
External Input Detection
Automatically detects inputs that cannot be paused: x-rincon:RINCON_* - Line-In x-rincon-stream:RINCON_* - Line-In stream x-sonos-htastream:* - TV/HDMI (Sonos Home Theater) x-sonos-vanished:* - Vanished device x-rincon-bt:* - Bluetooth
Soundboard Example
from sonos_core import announce SOUNDS = { 'airhorn': '/path/to/sounds/airhorn.mp3', 'rimshot': '/path/to/sounds/rimshot.mp3', 'victory': '/path/to/sounds/victory.mp3', } def play_sound(name): """Play a sound effect.""" if name in SOUNDS: announce(SOUNDS[name]) else: print(f"Unknown sound: {name}")
Troubleshooting
IssueSolutionNo speakers foundEnsure on same network as Sonos speakersResume not workingCheck speakers were playing (not paused) before announcementHTTP server failedCheck port 8888 is available, or set SONOS_HTTP_PORTModule import errorRun: pip install socoDuration detection failsEnsure ffprobe is installed (part of ffmpeg)
Files
sonos_core.py - Main module with announce() function SKILL.md - This documentation
Category context
Agent frameworks, memory systems, reasoning layers, and model-native orchestration.
Source: Tencent SkillHub
Largest current source with strong distribution and engagement signals.
Package contents
Included in package
1 Docs1 Scripts
- SKILL.md
- sonos_core.py