appletv
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".
Why use this skill?
Seamlessly manage your Apple TV with OpenClaw. Launch apps, control playback, and toggle power using voice or text commands with this easy-to-install home media skill.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/lucakaufmann/appletvWhat This Skill Does
The Apple TV skill allows OpenClaw to act as a remote control for your Apple TV devices using the pyatv library. It provides comprehensive control over your media experience, enabling playback management, navigation, app launching, and power state control. By leveraging the companion and airplay protocols, the skill establishes a secure connection to your hardware, allowing the agent to perform actions such as pausing movies, navigating menu interfaces, adjusting volume, or switching between installed streaming applications like Netflix or Disney+. This effectively turns your terminal-based AI assistant into a home media controller.
Installation
To get started, ensure you have python 3.11 or 3.13 installed, as pyatv is incompatible with 3.14+. Install the dependencies via pipx install pyatv --python python3.11. You must register your device by running atvremote scan to identify your device ID, then complete the pairing process for both the companion and airplay protocols using the atvremote CLI tools. Once credentials are obtained, store them in ~/clawd/config/appletv.json as specified in the documentation. Finally, install the skill into OpenClaw via clawhub install openclaw/skills/skills/lucakaufmann/appletv.
Use Cases
This skill is perfect for users who prefer hands-free control of their living room environment. It is ideal for automating your entertainment setup, such as turning off the TV as part of a 'goodnight' automation sequence or quickly checking what media is currently playing without picking up a physical remote. It is also highly effective for multi-tasking, allowing you to switch between streaming apps via voice or text prompts, or navigating complex menus using simple directional commands.
Example Prompts
- "What's playing on the TV right now?"
- "Can you pause the movie for a second?"
- "Open YouTube on the Apple TV and navigate to my subscriptions."
Tips & Limitations
Always ensure your Apple TV is on the same local network as the device running OpenClaw for consistent discovery. If control becomes unresponsive, verify that your credentials haven't expired or changed following an Apple TV system update. Note that the volume control functionality may depend on your specific hardware configuration, particularly whether you are using HDMI-CEC to manage your sound system volume via the Apple TV remote protocol.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-lucakaufmann-appletv": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-read, file-write