apple-media
aaronn 제작
Media & Streaming요약
Control Apple TV, HomePod, and AirPlay devices via pyatv.
설명
이 스킬이 하는 일
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.
사용 시점
- 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
예시 워크플로
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
요구 사항
- atvremote CLI (installed via pyatv)
- Python 3.13 or earlier (incompatible with Python 3.14+)
설치
clawhub install aaronn/apple-mediaCLI 명령을 실행하거나, 프롬프트를 Claude Code, Cursor, Codex 등 사용하는 코딩 에이전트에 붙여넣으세요.