How do I install the Appletv skill?

Run npx skillmds@latest add dvcrn/appletv in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Appletv safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Appletv?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Appletv free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Appletv?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Appletv by dvcrn — Agent Skill

Name: Appletv
Rating: 4.2 (5 reviews)
Author: dvcrn

File contents

Apple TV Control

Control Apple TV via the pyatv library.

Requirements

pipx install pyatv --python python3.11

Note: pyatv requires Python ≤3.13. Python 3.14+ has breaking asyncio changes. Use --python python3.11 or python3.13 with pipx.

Configuration

Config file at ~/clawd/config/appletv.json:

{
  "name": "Living Room",
  "id": "DEVICE_ID",
  "ip": "192.168.x.x",
  "credentials": {
    "companion": "...",
    "airplay": "..."
  }
}

First-Time Pairing

# Find your Apple TV
atvremote scan

# Pair Companion protocol (required)
atvremote --id <DEVICE_ID> --protocol companion pair

# Pair AirPlay protocol (for media)
atvremote --id <DEVICE_ID> --protocol airplay pair

Save the credentials to the config file.

Quick Commands

Status & Playing

scripts/appletv.py status     # Full status with now playing
scripts/appletv.py playing    # What's currently playing

Playback Control

scripts/appletv.py play       # Play/resume
scripts/appletv.py pause      # Pause
scripts/appletv.py stop       # Stop
scripts/appletv.py next       # Next track/chapter
scripts/appletv.py prev       # Previous

Navigation

scripts/appletv.py up         # Navigate up
scripts/appletv.py down       # Navigate down
scripts/appletv.py left       # Navigate left
scripts/appletv.py right      # Navigate right
scripts/appletv.py select     # Press select/OK
scripts/appletv.py menu       # Menu button
scripts/appletv.py home       # Home screen

Volume

scripts/appletv.py volume_up
scripts/appletv.py volume_down

Power

scripts/appletv.py turn_on    # Wake from sleep
scripts/appletv.py turn_off   # Put to sleep
scripts/appletv.py power      # Toggle

Apps

scripts/appletv.py apps       # List installed apps
scripts/appletv.py app Netflix
scripts/appletv.py app YouTube
scripts/appletv.py app "Disney+"

Discovery

scripts/appletv.py scan       # Find Apple TVs on network

Example Interactions

"What's playing on the TV?" → scripts/appletv.py status
"Pause the TV" → scripts/appletv.py pause
"Turn off the Apple TV" → scripts/appletv.py turn_off
"Open Netflix on TV" → scripts/appletv.py app Netflix

---name: appletvdescription: Control Apple TV via pyatv. Use for play/pause, navigation, volume, launching apps, power control, and checking what's playing. Triggers on "Apple TV", "TV", "what's playing", "pause TV", "play TV", "turn off TV".---# Apple TV ControlControl Apple TV via the pyatv library.## Requirements```bashpipx install pyatv --python python3.11```> **Note:** pyatv requires Python ≤3.13. Python 3.14+ has breaking asyncio changes. Use `--python python3.11` or `python3.13` with pipx.## ConfigurationConfig file at `~/clawd/config/appletv.json`:```json{ "name": "Living Room", "id": "DEVICE_ID", "ip": "192.168.x.x", "credentials": { "companion": "...", "airplay": "..." }}```### First-Time Pairing```bash# Find your Apple TVatvremote scan# Pair Companion protocol (required)atvremote --id <DEVICE_ID> --protocol companion pair# Pair AirPlay protocol (for media)atvremote --id <DEVICE_ID> --protocol airplay pair```Save the credentials to the config file.## Quick Commands### Status & Playing```bashscripts/appletv.py status # Full status with now playingscripts/appletv.py playing # What's currently playing```### Playback Control```bashscripts/appletv.py play # Play/resumescripts/appletv.py pause # Pausescripts/appletv.py stop # Stopscripts/appletv.py next # Next track/chapterscripts/appletv.py prev # Previous```### Navigation```bashscripts/appletv.py up # Navigate upscripts/appletv.py down # Navigate downscripts/appletv.py left # Navigate leftscripts/appletv.py right # Navigate rightscripts/appletv.py select # Press select/OKscripts/appletv.py menu # Menu buttonscripts/appletv.py home # Home screen```### Volume```bashscripts/appletv.py volume_upscripts/appletv.py volume_down```### Power```bashscripts/appletv.py turn_on # Wake from sleepscripts/appletv.py turn_off # Put to sleepscripts/appletv.py power # Toggle```### Apps```bashscripts/appletv.py apps # List installed appsscripts/appletv.py app Netflixscripts/appletv.py app YouTubescripts/appletv.py app "Disney+"```### Discovery```bashscripts/appletv.py scan # Find Apple TVs on network```## Example Interactions- "What's playing on the TV?" → `scripts/appletv.py status`- "Pause the TV" → `scripts/appletv.py pause`- "Turn off the Apple TV" → `scripts/appletv.py turn_off`- "Open Netflix on TV" → `scripts/appletv.py app Netflix`

Frequently asked questions

Appletv