Agent skill · software engineering · sundial-org
apple-media
Control Apple TV, HomePod, and AirPlay devices via pyatv (scan, stream, playback, volume, navigation).
Why this skill is useful
Adds executable commands for controlling Apple devices that aren't available in public documentation.
What it needs
Requires pipx installed locally. About 3k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
Apple Media Remote Control Apple TV, HomePod, and AirPlay devices from the command line using atvremote. Setup Notes pyatv has a compatibility issue with Python 3.14+. Use --python python3.13 (or any version ≤3.13) when installing. If ~/.local/bin isn't on your PATH after install, run: pipx ensurepath If your default Python is 3.14+, you can also call directly: python3.13 -m pyatv.scripts.atvremote <command> Scan for Devices Returns all discoverable Apple TV, HomePod, and AirPlay devices on the local network with their names, addresses, protocols, and pairing status. Target a Device Use -n <name> (device name), -s <ip> (address), or -i <id> (identifier) to target: Playback Control Volume Streaming Stream local files or URLs to a device: Supports common audio formats (MP3, WAV, AAC, FLAC, etc.). Power Management Navigation (Apple TV) Keyboard Input (Apple TV) When a text field is focused: App Control (Apple TV) Output Devices (Multi-room) Manage connected audio outputs (e.g. grouping HomePods): Push Updates (Live Monitoring) Watch for real-time playback changes: Pairing Some devices (especially Apple TV) require pairing before control: Credentials are stored automatically in ~/.pyatv.conf after pairing. Device Info Tips Pause vs Stop: Use pause/play to suspend and resume. stop ends the session entirely — playback must be restarted from the source (Siri, Home app, etc.) HomePods with "Pairing: NotNeeded" can be streamed to immediately Apple TVs typically require pairing first (all protocols the device supports) The playing command shows media type, title, artist, position, shuffle/repeat state For stereo HomePod pairs, target either unit by name Use --scan-hosts for faster targeting when you know the device IP Navigation and keyboard commands are primarily for Apple TV (not HomePod)
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/apple-media