
home-audio
Multi-backend network speaker plugin that installs servers and clients, debugs playback, and manages rooms.
- version
- 1.0.0
- GitHub stars
- 32
What it does
- Adds
audioctl.pywithscan,ma-players,snap-status,test-play,announce, andtransfersubcommands for JSON output - Covers install, inventory, speaker switching, grouping, announcements, sleep timers, and podcast or radio playback across Music Assistant, Lyrion, and Snapcast
- Keeps your servers, endpoints, and history in a private overlay folder, with tokens read from environment variables rather than stored
- Designed for home setups that mix Squeezelite, snapclient, and Music Assistant and need to drive Home Assistant from one place
Network speakers and multi-room audio across backends (Music Assistant, Lyrion/Squeezelite, Snapcast): install servers and clients, inventory, set speakers, debug, drive the MA and Home Assistant APIs. Your installation lives in a private overlay.
Add marketplace
/plugin marketplace add danielrosehill/Claude-Code-PluginsRun it inside Claude Code once, then install the plugin below.
Install
/plugin install home-audio@danielrosehillRun it inside Claude Code after adding the marketplace.
Files
Discovered from sourceAnnounce
Load
Overlay DIR via bash ${CLAUDE_PLUGIN_ROOT}/scripts/overlay-paths.sh dir; read
profile.env and installation.json (rooms -> player names). Run calls through the user's
secrets route if profile.env names one. A="python3 ${CLAUDE_PLUGIN_ROOT}/scripts/audioctl.py".
Resolve rooms to players by name; $A ma-players lists them. Never guess IDs.
Steps
- Pick the engine once:
$A ma players/tts_engineslistsuids (hass/tts.<entity>when TTS comes from Home Assistant). Record the user's choice asHOME_AUDIO_TTS_ENGINEinprofile.env, and pass it with--engine. $A announce "<text>" -p "<room>" [-p ...] [--engine <uid>] [--language en] [--volume 50] [--no-chime]. A sound file instead of speech:--url <http url MA can reach>. MA ducks or pauses what is playing and resumes it afterwards.- This makes sound in someone's room: say where before sending, unless asked directly.
- MA unreachable or no engine: Home Assistant
tts.speak({"entity_id":"tts.<engine>","media_player_entity_id":"media_player.<x>","message"}) ormusic_assistant.play_announcement(message,tts_entity_id,url,use_pre_announce,announce_volume); see thehome-assistantskill.
Commands underneath
players/cmd/play_announcement {"player_id","message"|"url","tts_engine?","language?", "volume_level?","pre_announce?","pre_announce_url?"} (source: 2.10.11; message and
tts_engine are newer than the url-only form). Player config keys announce_volume,
announce_volume_strategy, announce_volume_min/max set the default level.
Data storage
HOME_AUDIO_TTS_ENGINE in profile.env, only on the user's choice.
Readme
Home Audio
Agent skills for a home network-speaker system, whatever the backend: Music Assistant, Lyrion (LMS) + Squeezelite, Snapcast, with AirPlay and Spotify Connect endpoints covered where they meet those. Install servers and endpoint clients, document what is on the network, change the speaker an endpoint plays to, debug, group rooms, and drive the Music Assistant and Home Assistant APIs.
The plugin is generic. Your installation (servers, endpoints, rooms, sinks, history) lives
in a private overlay folder outside the plugin, which the setup skill can turn into a
private git repo.
Skills
| Skill | Does |
|---|---|
setup | Creates the private record: profile.env, installation.json; offers a private repo |
inventory | Scans the LAN, asks each server, reads endpoint configs, writes installation.json/.md |
install-server | Music Assistant (HA add-on or Docker), Lyrion, or snapserver |
install-client | Squeezelite or snapclient (or shairport-sync, librespot) as a resilient systemd unit |
connect-server | Points clients at a server, enables MA providers, migrates between backends |
set-speaker | Changes an endpoint's output device: ALSA card, PipeWire sink, second speaker |
debug | Walks source -> server -> network -> client -> device, with a 10-90 s test play to a speaker or group; records the fix |
groups | Multi-room sync in MA, Snapcast, LMS or HA |
now-playing | What each room is playing, sleep timers, recent and in-progress items |
move-music | Move the playing queue to another room, or extend it |
announce | Speak or play an announcement on rooms or groups (MA TTS or HA) |
sleep-and-alarms | Sleep timers, fade-outs, wake-up music via an HA automation |
podcasts-radio | Add feeds or an OPML, latest episodes, resume, radio streams |
library-providers | Provider health, add a source via the setup flow, reload, resync |
music-assistant | MA API: players, play media, volume, queues, playlists, DSP presets, logs, announcements |
home-assistant | music_assistant / snapcast / squeezebox integrations, media_player calls, automations |
audioctl.py
One stdlib-only CLI the skills share (scripts/audioctl.py, JSON output):
audioctl.py scan --subnet 192.168.1.0/24 # which hosts expose audio ports
audioctl.py mdns # audio-related mDNS services
audioctl.py ma-players # Music Assistant players
audioctl.py ma players/cmd/volume_set '{"player_id":"<id>","volume_level":30}'
audioctl.py lms serverstatus 0 100 # LMS, or MA's Squeezelite provider
audioctl.py snap-status # Snapcast groups and clients
audioctl.py ha GET /api/states/media_player.kitchen
audioctl.py test-play -p "Living Room" -s 30 --volume 40 # 10/30/60/90 s of known media
audioctl.py ma-add-podcast --opml https://example.com/feeds.opml
audioctl.py now-playing --history 5
audioctl.py transfer --to Kitchen
audioctl.py announce "Dinner is ready" -p Kitchen --engine <uid>
audioctl.py sleep 30 -p Bedroom
audioctl.py episodes "<podcast>" --play "Living Room"
audioctl.py providers --problems
Overlay (your private data)
scripts/overlay-paths.sh prints where it is and why. Order: $HOME_AUDIO_HOME,
$CLAUDE_USER_DATA/home-audio, ~/.claude-user-data/home-audio (if that root exists),
$XDG_DATA_HOME/claude-plugins/home-audio (if that root exists), else
~/.claude-user-data/home-audio.
profile.env settings (keys below)
installation.json servers, endpoints, groups, HA entities, history
installation.md human rendering
endpoints/<host>.md per-endpoint notes and fixes
dsp-presets/*.json your EQ presets (same name overrides a built-in)
changelog.md dated changes made by the skills
<skill>.md private notes for one skill; they override its defaults
| Key | Used by | Default |
|---|---|---|
HOME_AUDIO_BACKEND | all | music-assistant |
HOME_AUDIO_SUBNET | inventory, setup | none |
HOME_AUDIO_MA_URL | music-assistant, inventory, groups | none |
HOME_AUDIO_MA_TOKEN_VAR | music-assistant | MA_TOKEN (name of the env var, not the token) |
HOME_AUDIO_LMS | inventory, groups, debug | none |
HOME_AUDIO_SNAPSERVER | inventory, groups, debug | none |
HOME_AUDIO_HA_URL | home-assistant | none |
HOME_AUDIO_HA_TOKEN_VAR | home-assistant | HA_TOKEN |
HOME_AUDIO_SSH_USER | install-*, set-speaker, inventory | SSH config |
Tokens are never written by the plugin; profile.env names the environment variables.
Installation
claude plugins install home-audio@danielrosehill
Then run setup.
History
Replaces the Snapcast and Spotify-network parts of smart-home, and the
media-assistant-ops and music-assistant-ops plugins (2026-11-14).
License
MIT
Details
- Marketplace
- danielrosehill/Claude-Code-Plugins
- Source
- danielrosehill/Home-Audio
- Author
- Daniel Rosehill
- Category
- Network & Smart Home
- License
- MIT
More from danielrosehill/Claude-Code-Plugins
All 264- home-budget-helperv1.0.0
- hotkey-builderv0.2.1
- html-email-designerv1.0.0
- ideationv1.0.0
- ideation-planningv1.4.3
- ikea-israelv0.1.1
- image-annotationv1.1.0
- image-editingv1.0.0
- image-productionv2.4.2
- imagemeterv1.0.0
- input-device-mapperv0.2.0
- israel-agent-skillsv1.1.2
- israel-open-datav0.1.0
- israel-opening-hoursv0.2.1
- israel-osintv0.1.0
- israel-postv0.3.0
- israel-shoppingv1.9.0
- israeli-tech-shoppingv1.0.0
- jewish-texts-referencev1.1.0
- jewish-utilitiesv1.0.0
- kaizenv0.1.0
- kaizen-pleasev0.2.0
- kde-agent-workspacev0.5.0
- kde-plasmav0.3.1
Similar to home-audio
More Media & Audio/Video
marketing-skillscoreyhaines31/marketingskills61.1K stars53 marketing skills for technical marketers and founders: CRO, copywriting, cold email, prospecting, SEO, AI SEO, paid ads, SMS, ad creative, video production,
ElevenLabs AutomationComposioHQ/awesome-claude-skills51.5K starsAutomate ElevenLabs text-to-speech workflows -- generate speech from text, browse and inspect voices, check subscription limits, list models, stream audio, and
amd-skillsanthropics/claude-plugins-official47.9K starsAMD's verified Agent Skills in one plugin: route image/audio through local AI on Ryzen AI, serve LLMs on AMD Instinct GPUs with vLLM, optimize inference through
file-conversionwshobson/agents42.8K starsConvert common image, audio, video, document, and data formats with installed local tools while preserving originals.
adobe-for-creativityanthropics/knowledge-work-plugins36.5K starsBrings together Adobe Creative Cloud tools for images, vectors, design, and video. Edit multiple assets at once, adapt for different platforms, and complete mul
gpt-image-2-style-libraryfreestylefly/awesome-gpt-image-235.9K starsChoose GPT-Image2 visual styles, industrial prompt templates, categories, and scene tags.