A comprehensive command-line integration for managing Apple TV, HomePod, and AirPlay devices using the pyatv library.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install apple-media
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install apple-media using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Apple Media Control?
The Apple Media skill provides a robust interface to interact with your Apple ecosystem directly from your AI agent. By leveraging the pyatv library and the atvremote utility, this skill allows for deep control over media playback, system navigation, and device management. It is a core component of the Openclaw Skills library for users looking to automate their home theater or multi-room audio setups.
This skill handles everything from initial device discovery and secure pairing to complex tasks like launching specific apps on an Apple TV or managing HomePod stereo pairs. It bridges the gap between standard AI agents and local hardware, turning your workspace into a central command hub for Apple hardware.
Apple Media Control Use Cases
- Automating home theater power states and playback settings for movie nights.
- Controlling music playback and volume on HomePods across different rooms.
- Using an AI agent to input text and search queries on Apple TV apps.
- Creating scheduled routines that pause media or sleep devices at specific times.
- Monitoring 'now playing' metadata to trigger secondary home automation events.
How Apple Media Control Works
- The skill utilizes the atvremote CLI to scan the local network for discoverable Apple devices.
- Users identify a target device by name, IP address, or unique identifier for specific command routing.
- A secure pairing handshake is performed for protected devices, storing credentials in a local configuration file.
- Commands are issued through the Openclaw Skills interface to trigger playback, volume, or navigation actions.
- The skill retrieves real-time feedback from the device, including power state, app status, and media metadata.
Apple Media Control Setup
To use this skill, ensure you have Python 3.13 installed, as higher versions may have compatibility issues with the underlying library. Install the requirements using the following commands:
pipx install pyatv --python python3.13
pipx ensurepath
Once installed, discover your devices on the network:
atvremote scan
For Apple TVs and secured devices, initiate pairing:
atvremote -n "Your Device Name" pair
Apple Media Control Data Schema & Taxonomy
The skill manages device connectivity and state through structured local files and command outputs:
| Data Component | Description |
|---|---|
| ~/.pyatv.conf | Local configuration file storing device identifiers and encrypted pairing keys. |
| Device Info | Metadata including model, OS version, MAC address, and protocol support. |
| Playback State | Real-time data including title, artist, album, track position, and repeat/shuffle status. |
| App Metadata | List of installed applications and current foreground bundle IDs. |
Apple Media Control Advanced Features
- Multi-room audio management to group or isolate specific AirPlay 2 speakers.
- Push update monitoring for live-streaming playback changes to the agent.
- Remote keyboard emulation for setting, appending, or clearing text fields on Apple TV.
- Direct app launching using bundle IDs (e.g., com.apple.TVMusic) for instant media access.
- Granular power management to check, wake, or sleep devices remotely.
SKILL.md
Loading
Related Openclaw Skills
OKX DEX Swap & Broadcast
A comprehensive tool for executing end-to-end on-chain token swaps with MEV protection and automated slippage via the OKX DEX Aggregator.
OKX DEX Aggregator Quote
A specialized skill for fetching real-time, optimized cryptocurrency swap quotes across multiple blockchain networks using the OKX DEX Aggregator API.
OpenBot ClawHub
A specialized skill for OpenClaw agents to inhabit and interact within a persistent 3D ocean-floor social environment as autonomous AI lobsters.
Soul Digital Identity
A sophisticated framework for AI agents to adopt and maintain consistent digital identities, worldviews, and writing styles.
Huckleberry Baby Tracker
A comprehensive AI agent skill that enables natural language tracking of baby sleep, feeding, diapers, and growth via the Huckleberry app API.
OpenClaw Research Tool
A powerful CLI tool that provides AI agents with live web access and deep reasoning capabilities via OpenRouter.
Featured*
