barnybbb/adb-hass-androidtv

adb-hass-androidtv

概述

通过ADB（Android调试桥）连接并控制Android TV/Fire TV/Google TV设备。

该镜像会启动一个监听5037端口的ADB服务器，并通过网络连接到指定的Android TV/Fire TV/Google TV设备列表。这使您能够使用AndroidTV集成将这些设备与Home Assistant集成。

核心功能和特性

• 快速简便地通过网络连接Android设备
• 基于Alpine的轻量级镜像
• 支持通过环境变量或YAML文件进行配置
• 支持最高Android 15版本的设备
• 支持需要配对码和配对端口的无线ADB连接（adbwifi）
• 输入验证功能
• 带轮转的日志记录

使用场景和适用范围

适用于需要通过网络远程控制Android TV、Fire TV或Google TV设备，并将其集成到Home Assistant智能家居系统中的用户。尤其适合家庭自动化场景，实现电视设备的远程控制和状态监控。

使用方法和配置说明

Docker

通过挂载存储config.yml配置文件的卷运行：

shell
docker run -it -v /tmp:/opt/androidtv-connect barnybbb/adb-hass-androidtv:latest

使用环境变量运行：

shell
docker run -it -e devicelist=192.168.1.100,192.168.1.101::739264:44556 -e bootwait=10 -e checkfreq=60 barnybbb/adb-hass-androidtv:latest

Docker Compose（挂载配置文件卷）：

yml
services:
  adb-hass-androidtv:
    image: barnybbb/adb-hass-androidtv:latest
    hostname: adb-hass-androidtv.local
    container_name: adb-hass-androidtv
    ports:
      - 5037:5037
    volumes:
      - /tmp:/opt/androidtv-connect
    restart: unless-stopped

Docker Compose（使用环境变量）：

yml
services:
  adb-hass-androidtv:
    image: barnybbb/adb-hass-androidtv:latest
    hostname: adb-hass-androidtv.local
    container_name: adb-hass-androidtv
    ports:
      - 5037:5037
    environment:
      devicelist: 192.168.1.100,192.168.1.101::739264:44556
      bootwait: 10
      checkfreq: 300
    restart: unless-stopped

UnRAID

您可以使用UnRAID社区模板，详情可在UnRAID论坛查看。

配置说明

配置通过位于/opt/androidtv-connect的YAML文件（config.yml）或环境变量进行管理。config.yml中提供的选项将覆盖环境变量。

配置选项

以下选项可通过环境变量或config.yml文件指定：

环境变量devicelist必须是逗号分隔的设备列表，格式如下：

<host>[:<port>][:<auth_code>:<auth_port>]

• <host> - 必需，Android设备的IP地址或主机名
• <port> - 可选，默认值为5555
• <auth_code> - 可选，ADB无线配对的配对码
• <auth_port> - 可选，ADB无线配对的配对端口（必须与<auth_code>一起指定）

示例：

• 192.168.1.100 - 指定单个设备，默认连接ADB端口5555
• 192.168.1.100:5555,192.168.101:5555 - 指定两个设备，均连接ADB端口5555
• 192.168.1.101:5555:739264:44556 - 指定单个设备，包含auth_code和auth_port
• 192.168.1.100,192.168.1.101::739264:44556 - 指定两个设备，第二个设备使用默认端口5555并包含auth_code和auth_port

典型配置文件示例

yml
devicelist:
  - name: 客厅电视
    host: 192.168.1.100
    port: 12345
  - name: 卧室电视
    host: 192.168.1.101
    port: 15555
    auth_code: 739264
    auth_port: 44556

完整配置文件示例

yml
bootwait: 10
checkfreq: 300
enable_adb_usb: no
devicelist:
  - name: 客厅电视
    host: 192.168.1.100
    port: 5555
    auth_code: 48273
    auth_port: 11223
  - name: 卧室电视
    host: 192.168.1.101
    port: 5555
    auth_code: 739264
    auth_port: 44556

Home Assistant集成

• 安装Android Debug Bridge集成
  • 设置
  • 添加集成
  • 搜索Android Debug Bridge

!https://github.com/BLBurgess/adb-hass-androidtv/raw/main/doc_img/hass-adb-add-integration.png

• 添加每个Android设备（按照容器配置）
  • 设置
  • Android Debug Bridge
  • 添加设备
  • 完成设备配置
    • 主机：Android设备的主机名/IP（如在devicelist中配置）
    • 端口：Android设备监听的端口（如在devicelist中配置）
    • ADB服务器的IP地址：barnybbb/adb-hass-androidtv容器的主机名/IP地址
    • ADB服务器的端口：barnybbb/adb-hass-androidtv容器监听的端口（默认5037）
  • 提交

!https://github.com/BLBurgess/adb-hass-androidtv/raw/main/doc_img/hass-adb-integration-add-device.png

许可证

本项目采用MIT许可证。详见https://github.com/BLBurgess/adb-hass-androidtv/blob/main/LICENSE%E6%96%87%E4%BB%B6%E3%80%82

GitHub项目

https://github.com/BLBurgess/adb-hass-androidtv

版本历史