sinedied/googlehomekodi

sinedied/googlehomekodi镜像说明

镜像概述

sinedied/googlehomekodi镜像提供了通过Google Home或Google Assistant语音控制Kodi媒体中心的能力，用户无需手动操作即可完成播放内容选择、音量调节、系统管理等任务，大幅提升家庭娱乐场景的便捷性。

核心功能

• 影视播放：指定/随机播放电影（支持类型/年份筛选）、电视剧下一集/指定集/最新集播放；
• 控制：搜索并播放视频或显示搜索结果；
• 播放控制：暂停/继续/停止播放、音量调节（静音/设置值/增减）；
• PVR频道：通过名称或编号切换PVR频道；
• 系统操作：控制电视开关（HDMI切换）、Kodi关机/重启/休眠/挂起；
• 库管理：扫描/清理媒体库；
• 界面导航：控制Kodi界面上下左右/返回/选择，打开指定窗口（收藏/电影/设置等）；
• 播放设置：查询播放状态、切换字幕/音频流、快进/快退/跳转进度；
• 音乐播放：播放指定歌曲/专辑/艺术家作品、按 genre 随机播放、开启派对模式；
• 播放列表：播放指定列表、切换列表项。

使用场景

适用于家庭娱乐场景：

• 语音控制Kodi播放影视/音乐，无需遥控器；
• 控制多个房间的Kodi实例（如客厅、卧室）；
• 快速执行库扫描或系统操作。

配置说明

步骤1：开启Kodi Web服务

1. Kodi中进入设置 > 服务 > Web服务器；
2. 开启允许通过HTTP远程控制；
3. 设置端口（如8080，记为YOUR_KODI_PORT）；
4. 设置用户名/密码（记为YOUR_KODI_USER/YOUR_KODI_PASSWORD）。

步骤2：Docker部署

Docker Run命令

bash
docker run \
  --detach \
  --publish 8099:8099 \
  --restart always \
  -e KODI_PROTOCOL="http" \
  -e KODI_IP="YOUR_KODI_INTERNAL_IP" \
  -e KODI_PORT="YOUR_KODI_PORT" \
  -e KODI_USER="YOUR_KODI_USER" \
  -e KODI_PASSWORD="YOUR_KODI_PASSWORD" \
  -e AUTH_TOKEN="YOUR_CUSTOM_PASSWORD" \
  --name googlehomekodi \
  sinedied/googlehomekodi

占位符替换：
YOUR_KODI_INTERNAL_IP（Kodi设备内网IP）、YOUR_CUSTOM_PASSWORD（自定义连接密码）。

Docker Compose配置

创建docker-compose.yml：

yaml
version: '3'
services:
  googlehomekodi:
    image: sinedied/googlehomekodi
    ports:
      - "8099:8099"
    environment:
      - KODI_PROTOCOL=http
      - KODI_IP=YOUR_KODI_INTERNAL_IP
      - KODI_PORT=YOUR_KODI_PORT
      - KODI_USER=YOUR_KODI_USER
      - KODI_PASSWORD=YOUR_KODI_PASSWORD
      - AUTH_TOKEN=YOUR_CUSTOM_PASSWORD
    restart: always

执行部署：docker-compose up --detach

步骤3：IFTTT连接Google Home

1. 访问IFTTT创建Applet；
2. 触发条件：选择Google Assistant，设置语音指令（如“Kodi播放电影$”）；
3. 执行动作：选择Maker Webhooks，设置URL为http://你的公网IP:8099/playmovie?q={{TextField}}；
4. 请求方法POST，Body为{"token":"YOUR_CUSTOM_PASSWORD"}。
   重复此步骤为不同指令（如暂停、音量调节）创建Applet。