Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
What This Skill Does
Controls Apple TV, HomePod, and AirPlay devices from the command line using pyatv's atvremote tool. Supports playback, volume, navigation, multi-room audio grouping, streaming local files or remote URLs, and live push updates. Apple TV requires pairing first; HomePods marked 'NotNeeded' can be used immediately.
Gives shell-level access to Apple media devices, enabling scripting and automation that the Home app and Siri don't support.
When to use it
- Adjusting HomePod volume from a terminal without touching a phone
- Streaming a local audio file to an Apple TV or HomePod
- Pausing playback on a specific room's speaker from a script
- Grouping multiple HomePods into a synchronized audio session
- Automating Apple TV navigation to launch apps or enter search text
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Stream a local podcast file to the Kitchen HomePod
- 1Run `atvremote --scan-hosts 10.0.0.50 scan` to discover devices on the network
- 2Confirm the device named 'Kitchen' is listed with pairing status 'NotNeeded'
- 3Run `atvremote -n "Kitchen" stream_file=/home/user/podcast.mp3` to start playback
- 4Run `atvremote -n "Kitchen" set_volume=60` to adjust volume
Podcast audio plays on the Kitchen HomePod at the specified volume
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.