openclaw 网盘下载
OpenClaw

技能详情(站内镜像,无评论)

首页 > 技能库 > Apple TV

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".

开发与 DevOps

许可证:MIT-0

MIT-0 ·免费使用、修改和重新分发。无需归因。

版本:v1.0.0

统计:⭐ 2 · 2.1k · 4 current installs · 4 all-time installs

2

安装量(当前) 4

🛡 VirusTotal :良性 · OpenClaw :良性

Package:appletv

安全扫描(ClawHub)

  • VirusTotal :良性
  • OpenClaw :良性

OpenClaw 评估

The skill's code, instructions, and requirements are consistent with an Apple TV control utility using pyatv — it only needs local pairing tokens and calls the pyatv/atvremote CLI to talk to devices on your LAN.

目的

Name/description match the included script and README: the skill controls Apple TV via pyatv/atvremote. No unrelated binaries, cloud APIs, or credentials are requested.

说明范围

SKILL.md instructs installing pyatv and performing local pairing, which is appropriate. The instructions and script require a local config file containing companion/airplay credentials; the skill does not attempt to read other system files or external endpoints. Note: credentials are stored as JSON in the user's home directory and the script passes them on the command line to atvremote (visible to local process listings) — a normal tradeoff fo…

安装机制

No install spec in the registry; SKILL.md suggests installing pyatv via pipx — a reasonable, minimal instruction. There are no downloads from untrusted URLs or archive extraction steps in the skill package.

证书

The skill requests no environment variables and only needs locally generated Apple TV pairing credentials stored in a config file. The number and type of secrets (companion/airplay tokens) are proportional to the stated purpose.

持久

always is false and the skill does not request elevated or persistent platform privileges. It reads/writes only its own config paths and does not modify other skills or global agent settings.

综合结论

This skill appears to do what it says: control Apple TV locally via pyatv/atvremote. Before installing, consider: (1) Pairing generates companion/airplay tokens that are stored in a JSON file under your home directory — protect that file (set restrictive permissions) because those tokens grant control of the device. (2) The script passes credentials on the command line to atvremote, which can make them visible to local users via process listin…

安装(复制给龙虾 AI)

将下方整段复制到龙虾中文库对话中,由龙虾按 SKILL.md 完成安装。

请把本段交给龙虾中文库(龙虾 AI)执行:为本机安装 OpenClaw 技能「Apple TV」。简介:Control Apple TV via pyatv. Use for play/pause, navigation, volume, launching a…。
请 fetch 以下地址读取 SKILL.md 并按文档完成安装:https://raw.githubusercontent.com/openclaw/skills/refs/heads/main/skills/lucakaufmann/appletv/SKILL.md
(来源:yingzhi8.cn 技能库)

SKILL.md

打开原始 SKILL.md(GitHub raw)

---
name: appletv
version: 1.0.0
description: 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".
license: MIT
---

# Apple TV Control

Control Apple TV via the pyatv library.

## Requirements

```bash
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`:

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

### First-Time Pairing

```bash
# 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
```bash
scripts/appletv.py status     # Full status with now playing
scripts/appletv.py playing    # What's currently playing
```

### Playback Control
```bash
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
```bash
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
```bash
scripts/appletv.py volume_up
scripts/appletv.py volume_down
```

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

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

### Discovery
```bash
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`