apple-media
por aaronn
Media & StreamingResumo
Control Apple TV, HomePod, and AirPlay devices via pyatv.
Descrição
O que esta skill faz
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.
Quando usá-la
- 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
Exemplo de fluxo de trabalho
User asks: Stream a local podcast file to the Kitchen HomePod
- 1
Run
atvremote --scan-hosts 10.0.0.50 scanto discover devices on the network - 2
Confirm the device named 'Kitchen' is listed with pairing status 'NotNeeded'
- 3
Run
atvremote -n "Kitchen" stream_file=/home/user/podcast.mp3to start playback - 4
Run
atvremote -n "Kitchen" set_volume=60to adjust volume
Podcast audio plays on the Kitchen HomePod at the specified volume
Requisitos
- atvremote CLI (installed via pyatv)
- Python 3.13 or earlier (incompatible with Python 3.14+)
Instalação
clawhub install aaronn/apple-mediaExecute o comando da CLI ou cole o prompt no Claude Code, Cursor, Codex ou no agente de código que você usa.