Skip to content
TakoAPI
Back to skills

apple-media

by aaronn

Media & Streaming
2.4kDownloads reported by clawskills.sh
5Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Control Apple TV, HomePod, and AirPlay devices via pyatv.

Description

What This Skill Does

Controls Apple TV, HomePod, and AirPlay devices from the command line using pyatv's atvremote tool. Supports playback, volume, navigation, multi-room audio grouping, streaming local files or remote URLs, and live push updates. Apple TV requires pairing first; HomePods marked 'NotNeeded' can be used immediately.

Gives shell-level access to Apple media devices, enabling scripting and automation that the Home app and Siri don't support.

When to Use It

  • Adjusting HomePod volume from a terminal without touching a phone
  • Streaming a local audio file to an Apple TV or HomePod
  • Pausing playback on a specific room's speaker from a script
  • Grouping multiple HomePods into a synchronized audio session
  • Automating Apple TV navigation to launch apps or enter search text

Example Workflow

INPUT

User asks: Stream a local podcast file to the Kitchen HomePod

AGENT
  1. 1

    Run atvremote --scan-hosts 10.0.0.50 scan to discover devices on the network

  2. 2

    Confirm the device named 'Kitchen' is listed with pairing status 'NotNeeded'

  3. 3

    Run atvremote -n "Kitchen" stream_file=/home/user/podcast.mp3 to start playback

  4. 4

    Run atvremote -n "Kitchen" set_volume=60 to adjust volume

OUTPUT

Podcast audio plays on the Kitchen HomePod at the specified volume

Requirements

  • atvremote CLI (installed via pyatv)
  • Python 3.13 or earlier (incompatible with Python 3.14+)

Installation

clawhub install aaronn/apple-media

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

Links