sytone/python-firetv

python-firetv镜像

镜像概述

本镜像提供运行Python2版本firetv服务的Docker容器，通过ADB协议实现对亚马逊Fire TV设备的远程控制（需提前开启设备的ADB调试功能）。包含firetv-server HTTP服务器，支持通过RESTful接口访问设备状态与执行控制操作。

核心功能

1. 设备状态检测：识别设备的off（关机）、standby（待机）、idle（屏保）、play（播放）、pause（暂停）、disconnected（断开连接）等状态。
2. 设备控制动作：支持开机、关机、Home键、播放/暂停、音量调节、快进/后退等操作。
3. 应用管理：查询运行中应用、启动/停止指定应用、检查应用状态。
4. RESTful接口：提供设备列表、连接、状态查询、动作执行等HTTP路由接口。

使用场景

• 智能家居集成：远程控制Fire TV设备，融入家庭自动化系统。
• 多设备管理：通过配置文件管理多台Fire TV设备，实现统一控制。
• 跨语言集成：通过HTTP接口让Python3或其他语言的应用调用Fire TV控制功能。

配置说明

Docker部署示例

Windows环境

powershell
docker run -d --restart=always -v F:/docker/firetv/config:/config --name python-firetv -p 5556:5556 sytone/python-firetv -c /config/house.yaml

配置文件格式（house.yaml）

yaml
devices:
  sleepingroom:
    host: 192.168.0.13:5555
  livingroom:
    host: 192.168.0.16:5555

服务器参数

• -d X.X.X.X:5555：设置默认Fire TV设备地址。
• -p XXXX：指定服务器端口（默认5556）。
• -c /path/to/config.yaml：加载多设备配置文件。

RESTful接口示例

• 获取设备列表：GET /devices/list
• 执行动作：GET /devices/action/<device_id>/turn_on
• 添加设备（POST请求）：
  • 路径：/devices/add
  • 头部：Content-Type: application/json
  • 数据：

json
{
  "device_id": "your_device_id",
  "host": "address:port"
}