apple-media
Discover and control Apple media/AirPlay devices (HomePod, Apple TV, AirPlay speakers) from macOS. Use when you want to scan for AirPlay devices, map names→IPs/IDs, pair/connect, and control playback/volume using pyatv (atvremote) and Airfoil.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Discover and control Apple media/AirPlay devices (HomePod, Apple TV, AirPlay speakers) from macOS. Use when you want to scan for AirPlay devices, map names→IPs/IDs, pair/connect, and control playback/volume using pyatv (atvremote) and Airfoil.
How to use
Zainstaluj pyatv za pomocą pipx, pinując do Python 3.12, aby uniknąć problemów z asyncio: uruchom pipx install pyatv, a następnie pipx reinstall pyatv --python python3.12. Sprawdź instalację poleceniem atvremote --help.
Zeskanuj sieć w poszukiwaniu dostępnych urządzeń. Użyj ./scripts/scan.sh 5 do szybkiego skanowania (5 sekund) lub ./scripts/scan-hosts.sh z konkretnym zakresem IP, jeśli znasz adresy. Alternatywnie uruchom node ./scripts/scan-json.js 5 dla wyniku w formacie JSON. Zobaczysz HomePody, Apple TV i inne urządzenia AirPlay.
Do sterowania głośnikami HomePod i innymi głośnikami AirPlay użyj Airfoil (zalecana metoda). Najpierw wyświetl dostępne głośniki poleceniem ../airfoil/airfoil.sh list, aby potwierdzić, że Twoje urządzenie jest widoczne.
Połącz się z wybranym głośnikiem i ustaw głośność. Uruchom ./scripts/connect.sh "Nazwa Głośnika" (np. "Living Room"), a następnie ./scripts/volume.sh "Nazwa Głośnika" 35 aby ustawić głośność na 35%.
Aby rozłączyć się z głośnikiem, użyj ../airfoil/airfoil.sh disconnect "Nazwa Głośnika".
Do sterowania Apple TV (odtwarzanie, pauza, włączanie, wyłączanie) użyj atvremote z nazwą urządzenia, np. atvremote -n "TV" play_pause lub atvremote -n "TV" turn_on. Najpierw zeskanuj sieć, aby znaleźć dokładną nazwę Twojego Apple TV.