Apple Media Remote

Control Apple TV, HomePod, and AirPlay devices from the command line using atvremote.

Setup Notes

• pyatv has a compatibility issue with Python 3.14+. Use --python python3.13 (or any version ≤3.13) when installing.
• If ~/.local/bin isn't on your PATH after install, run: pipx ensurepath
• If your default Python is 3.14+, you can also call directly: python3.13 -m pyatv.scripts.atvremote <command>

Scan for Devices

atvremote scan
atvremote --scan-hosts 10.0.0.50 scan          # Scan specific IP (faster)
atvremote --scan-hosts 10.0.0.50,10.0.0.51 scan  # Multiple IPs

Returns all discoverable Apple TV, HomePod, and AirPlay devices on the local network with their names, addresses, protocols, and pairing status.