turtletank99/adbtuner

ADBTuner

概述

ADBTuner是一款基于Web的小型应用，可通过ADB（Android调试桥）在联网设备上加载Android TV/Google TV的深度链接内容。该应用提供全功能Web界面，支持管理多个"调谐器"设备和配置"频道"，并能动态生成M3U播放列表供媒体应用使用。

核心功能

• 通过Web界面配置和管理Android TV/Google TV设备
• 支持添加多个"调谐器"设备，配置设备IP和流媒体端点
• 自定义频道信息，包括频道号、名称、提供商等
• 动态生成标准M3U播放列表，兼容多种媒体应用
• 提供配置数据持久化存储（通过卷挂载）

使用场景

适用于需要集中管理多个Android TV/Google TV设备，通过深度链接快速访问特定流媒体内容的场景，如家庭媒体中心、小型电视直播系统等。

使用方法

Docker Run 部署

bash
docker run -d --init -p 5592:5592 --name adbtuner -v adbtuner_config:/app/.config docker.xuanyuan.run/turtletank99/adbtuner

Docker Compose 部署

yaml
version: '2'
services:
  adbtuner:
    image: docker.xuanyuan.run/turtletank99/adbtuner
    restart: always
    init: true
    volumes:
      - adbtuner_config:/app/.config  # 持久化存储配置数据
    ports:
      - "5592:5592"  # Web界面访问端口
volumes:
  adbtuner_config:  # 定义配置数据卷

Web界面访问

访问地址：http://[Docker主机IP]:5592

调谐器（Tuners）配置

配置项说明

"调谐器"包含两个配置设置：

• Android/Google TV设备的IP地址
• "流媒体端点"：HTTP视频流设备（HDMI接收器、发射器等）的URL

添加调谐器前注意事项

添加新调谐器前，请确保：

• 设备已重启，且未连接到其他ADB服务器
• 设备处于开机状态
• 已启用开发者模式
• 可用遥控器批准ADB连接请求

频道（Channels）配置

频道数据字段

每个频道包含以下数据字段：

• 频道号：任意数字，用于频道排序
• 提供商名称：频道提供商名称（如"Hulu Live"），仅作参考用途
• 频道名称：频道名称（如"NBC"）
• Gracenote Station ID（可选）：频道的Gracenote/TVG ID，若提供将包含在M3U文件中
• URL：深度链接URL（如"[***]"或"nbctve://live/nbc"）
• 包名：目标Android应用包名（如"com.appmaker.appname.androidtv"）
• 备用包名（可选）：备用Android应用包名（如"com.appmaker.appname.firetv"），适用于不同设备类型（如Google TV和Fire TV）
• 兼容模式：部分应用使用非标准视频播放器或不响应标准控制操作（如"停止视频"），启用此模式可采取更主动的措施确保内容正确加载，效果可能因应用而异

频道管理

频道列表支持导入和导出，用于备份、共享或迁移到其他ADBTuner实例。导出数据可查看当前JSON文档结构。

M3U播放列表

ADBTuner会动态生成包含所有配置频道的M3U播放列表，访问地址： http://[Docker主机IP]:5592/channels.m3u

此标准播放列表可被多种媒体应用消费，多数应用支持通过该列表轻松切换频道。

注意事项

• 许可证：保留所有权利（待开源发布）