A comprehensive automation skill that enables AI agents to control Apple TV hardware via the pyatv library for media playback and app management.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install appletv
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 appletv 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 TV Control?
The Apple TV Control skill provides a robust interface for interacting with Apple TV devices directly from your AI agent environment. By leveraging the pyatv library, this skill allows for deep integration with home entertainment systems, facilitating everything from simple playback commands to complex application navigation. It is an essential addition to Openclaw Skills for users looking to bridge the gap between digital AI assistants and physical hardware.
This skill supports the Companion and AirPlay protocols, ensuring compatibility with various control needs. Whether you are building a voice-controlled media center or automating your home theater routines, this tool provides the technical foundation needed to communicate with Apple devices over a local network.
Apple TV Control Use Cases
- Remote playback control including play, pause, stop, and skipping tracks through Openclaw Skills prompts.
- Launching specific streaming applications like Netflix, YouTube, or Disney+ using simple text commands.
- Automating power management to wake or put the Apple TV to sleep based on scheduled routines.
- Checking real-time "Now Playing" status to integrate media info into other dashboards or logs.
- Navigating tvOS menus programmatically when the physical remote is unavailable.
How Apple TV Control Works
- The skill uses the pyatv library to discover and communicate with Apple TV devices on the local network.
- Users perform a one-time pairing process using the Companion and AirPlay protocols to generate secure credentials.
- Commands are issued via the Openclaw Skills interface, which triggers specific Python scripts tailored for playback, navigation, or app management.
- The script sends the request to the device IP, and the Apple TV executes the action (e.g., volume change or app launch).
- The skill returns the device status or confirmation back to the agent to close the interaction loop.
Apple TV Control Setup
To get started with this skill, install the required library. Note that pyatv requires Python 3.13 or lower:
pipx install pyatv --python python3.11
Next, discover your device and pair it to generate credentials:
atvremote scan
atvremote --id <DEVICE_ID> --protocol companion pair
Finally, create a configuration file at ~/clawd/config/appletv.json with your device ID, IP, and the credentials obtained during the pairing process.
Apple TV Control Data Schema & Taxonomy
The skill manages its configuration and device metadata through a structured JSON file. Below is the schema used for device integration:
| Field | Type | Description |
|---|---|---|
| name | String | The display name for the device (e.g., "Living Room"). |
| id | String | The unique hardware identifier for the Apple TV. |
| ip | String | The local network IP address of the device. |
| credentials | Object | Contains the tokens for 'companion' and 'airplay' protocols. |
Status updates return real-time information including the current app, playback state, and media metadata.
Apple TV Control Advanced Features
- Support for multi-protocol pairing to enable both control and media metadata retrieval.
- App-specific launching capabilities allowing direct access to installed tvOS applications.
- Granular navigation controls (up, down, left, right, select, home) for full menu interaction.
- Detailed device discovery via the scan command to identify all compatible units on the network.
- Power toggle and sleep/wake functionality for integrated energy management within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Video Generator MCP
An automated video production skill that converts product titles, descriptions, and images into marketing short videos via MCP tools.
0protocol
A cryptographic identity substrate that enables autonomous agents to sign plugins, rotate credentials, and make verifiable public attestations.
IP Camera Control (RTSP & ONVIF)
A comprehensive tool for managing IP cameras via RTSP and ONVIF, enabling PTZ movement, snapshots, and auto-discovery.
Todo Management
A high-performance, per-workspace SQLite task manager that allows AI agents to organize todos via a dedicated CLI script.
Snapmaker Printer Control
Control and monitor your Snapmaker U1 3D printer through AI-driven automation using the Moonraker API.
macOS Calendar Management
A specialized skill for managing Apple Calendar events and schedules on macOS using natural language commands and programmatic AppleScript execution.
Featured*
