Setup & Installation
openclaw skills install @lucakaufmann/appletv
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install appletv
What This Skill Does
Controls Apple TV devices over the local network using the pyatv library. Supports playback, navigation, volume, power, and app launching through a command-line script. Requires one-time pairing with the device before use.
Lets an AI agent control Apple TV programmatically without relying on Shortcuts, HomeKit automations, or physical remotes.
When to use it
- Asking the agent what show is currently playing
- Pausing playback without picking up a remote
- Opening Netflix or YouTube by voice or chat
- Turning off the TV at the end of a session
- Checking Apple TV status from another room
Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: Open Netflix on the TV
AGENT
- 1Read device config from ~/clawd/config/appletv.json
- 2Connect to Apple TV using stored IP and credentials
- 3Run scripts/appletv.py app Netflix
- 4Confirm the app launched by checking status
OUTPUT
Netflix opens on the Apple TV
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.
pyatv installed via pipx with Python 3.11 or 3.13 (pipx install pyatv --python python3.11)Apple TV device ID, IP address, and pairing credentials saved to ~/clawd/config/appletv.json