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-mediaشغّل أمر واجهة سطر الأوامر، أو الصق النص في Claude Code أو Cursor أو Codex أو أي وكيل برمجة تستخدمه.