apple-media

What This Skill Does

The apple-media skill is a powerful automation wrapper designed for macOS users to discover, manage, and control Apple media hardware, including HomePods, Apple TVs, and AirPlay-enabled speakers. By integrating the robust 'pyatv' library for device discovery and remote control alongside Airfoil for stable speaker routing and volume management, this skill bridges the gap between CLI commands and intuitive voice control. Whether you need to quickly scan your home network for available AirPlay targets, pause your living room Apple TV, or adjust the volume on a cluster of HomePods, this skill provides a unified interface to execute those actions seamlessly through OpenClaw.

Installation

To get started, ensure you have a macOS environment with Python 3.12 installed. This skill relies on 'pyatv' for protocol handling. Install or upgrade the dependency using pipx to ensure environment isolation:

1. Run pipx install pyatv or pipx reinstall pyatv --python python3.12 to maintain compatibility with required async structures.
2. Verify the installation by executing atvremote --help.
3. Install the skill via your terminal using the command clawhub install openclaw/skills/skills/officialpm/apple-media-officialpm.

Use Cases

• Unified Home Theater Control: Quickly turn off your Apple TV after a movie night without reaching for a physical remote.
• Whole-Home Audio: Use the Airfoil integration to synchronize volume across multiple HomePods in different rooms.
• Device Discovery: Maintain an inventory of all AirPlay-capable devices on your network to troubleshoot connectivity or locate specific device IPs.

Example Prompts

1. "Scan my network and list all available Apple TV and HomePod devices."
2. "Set the Living Room HomePod volume to 35 percent using Airfoil."
3. "Pause the playback on the Apple TV named 'Living Room' immediately."

Tips & Limitations

• Prefer Airfoil for Audio: While pyatv is excellent for remote control commands like play/pause/power, it can occasionally struggle with granular volume control on some HomePod models. For consistent speaker routing and volume, utilize the Airfoil-based scripts bundled in this skill.
• Authentication: Some Apple devices require initial pairing. If commands return protocol errors, ensure you have authorized the device via standard Apple pairing procedures.
• Networking: Ensure your host machine is on the same local network subnet as your Apple devices to ensure the discovery scripts can successfully broadcast and receive mDNS packets.