Back to skills
appletv
by lucakaufmann
Apple Apps & Services—Not yet rated
Your rating
Brief
Control Apple TV via pyatv.
Description
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
INPUT
User asks: Open Netflix on the TV
AGENT
- 1
Read device config from ~/clawd/config/appletv.json
- 2
Connect to Apple TV using stored IP and credentials
- 3
Run scripts/appletv.py app Netflix
- 4
Confirm the app launched by checking status
OUTPUT
Netflix opens on the Apple TV
Requirements
- 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
Installation
clawhub install lucakaufmann/appletvRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.