用途：在命令行通过 atvremote 控制本地网络中的 Apple TV、HomePod 和 AirPlay 设备。
主要能力：扫描发现设备并查看名称、地址、协议和配对状态；用名称、IP 或标识符定位设备；控制播放（播放、暂停、停止、上下曲、跳转、定位、随机与循环）、音量（读取、设置、增减）；将本地音频文件或远程 URL 串流到设备；查看和控制电源状态；对 Apple TV 进行方向键导航、菜单、主屏、控制中心等操作；在文本框输入文字；列出和启动应用；管理多房间输出设备；用 push_updates 实时监控播放变化；查看设备信息和当前应用。
使用方式：安装时注意 pyatv 与 Python 3.14+ 存在兼容问题，应使用 --python python3.13（或 ≤3.13）；如 ~/.local/bin 不在 PATH，运行 pipx ensurepath。典型命令为 atvremote 加目标参数（-n 名称、-s IP、-i 标识符）和动作，如 atvremote scan、atvremote -n "Kitchen" playing、atvremote -n "Kitchen" set_volume=50、atvremote -n "Kitchen" play_url=http://example.com/stream.mp3。部分设备需先配对（atvremote -n "Living Room" pair，或加 --protocol 指定协议，也可用 atvremote wizard 引导），凭据自动存入 ~/.pyatv.conf。
适用场景：局域网内对 Apple 音频/视频设备做脚本化或远程控制、多房间音频分组、按需串流本地或在线音频。
限制：导航与键盘输入命令主要面向 Apple TV 而非 HomePod；pytv 与 Python 3.14+ 不兼容；未提供收费、价格或平台支持等信息。