ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified media Safety 4/5

apple-media

Control Apple TV, HomePod, and AirPlay devices via pyatv (scan, stream, playback, volume, navigation).

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/aaronn/apple-media
Or

What This Skill Does

The apple-media skill empowers OpenClaw to interact seamlessly with your Apple ecosystem, including Apple TV, HomePod, and various AirPlay-enabled devices. By leveraging the robust pyatv library, this skill provides a powerful command-line interface for controlling media playback, volume, device power states, and streaming. Whether you need to pause your living room TV, adjust the volume of a speaker in the kitchen, or stream a specific audio file to your home network, this skill acts as the bridge between your agent and your hardware.

Installation

To begin, ensure you have the pyatv library installed on your host. Note that pyatv currently encounters compatibility issues with Python 3.14+, so it is highly recommended to perform the installation within a dedicated environment using python3.13 or lower. Run the command clawhub install openclaw/skills/skills/aaronn/apple-media to pull the skill into your OpenClaw library. After installation, verify your environment with pipx ensurepath to ensure the atvremote binaries are accessible in your terminal path. If you are operating on a system where Python 3.14 is the default, explicitly call python3.13 -m pyatv.scripts.atvremote to execute commands.

Use Cases

This skill is perfect for home automation enthusiasts and media power users. Common use cases include: integrating Apple TV controls into broader 'Goodnight' or 'Movie Night' automation scripts, creating multi-room audio sync routines, managing home background music without manual remote searching, and programmatically sleeping devices that were left on unintentionally.

Example Prompts

  1. "OpenClaw, check the status of my Apple TV in the living room and turn it off if nothing is currently playing."
  2. "Please set the volume on the Kitchen HomePod to 40% and stream the audio file at /home/user/music/morning_routine.mp3."
  3. "I'm heading out, scan the network for all AirPlay devices and turn off any that are currently active."

Tips & Limitations

For faster interaction, always use the --scan-hosts flag with a specific IP address to avoid scanning your entire network. Note that the initial pairing process for Apple TV requires a PIN code; perform this manually once to establish a persistent connection. While the skill supports playback controls like skipping tracks or seeking to specific timestamps, note that some features (like skip duration) are dependent on the specific application currently running on the target device.

Read Full Documentation on GitHub

Metadata

Author@aaronn
Stars4473
Views1
Updated2026-05-01
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-aaronn-apple-media": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Tags(AI)

#apple#home-automation#airplay#media-control#iot
Safety Score: 4/5

Flags: network-access, file-read

Related Skills

huckleberry

Track baby sleep, feeding, diapers, and growth via Huckleberry app API. Use for logging baby activities through natural language.

aaronn 4473

research-tool

Search the web using LLMs via OpenRouter. Use for current web data, API docs, market research, news, fact-checking, or any question that benefits from live internet access and reasoning.

aaronn 4473