Skip to content
TakoAPI
Back to skills

appletv

by lucakaufmann

Apple Apps & Services
2.0kDownloads reported by clawskills.sh
2Stars
0Views
0 likesSign in to like this skill
—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. 1

    Read device config from ~/clawd/config/appletv.json

  2. 2

    Connect to Apple TV using stored IP and credentials

  3. 3

    Run scripts/appletv.py app Netflix

  4. 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/appletv

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links