knapoc/hue-sync

hue-sync

Docker化版本的https://github.com/kwasmich/shairport-sync（基于https://github.com/mikebrady/shairport-sync）。

镜像概述

本镜像提供hue-sync的容器化部署方案，旨在将AirPlay音频流与Philips Hue智能灯同步，使灯光根据音频的节奏、频率或内容动态调整，为用户打造沉浸式的音频视觉体验。

核心功能

1. 接收AirPlay音频流并解析音频特征
2. 与Philips Hue桥接器建立安全通信
3. 控制指定Hue灯同步调整亮度、颜色等参数
4. 支持自定义AirPlay设备名称、Hue桥IP、目标灯组等配置项

使用场景

• 家庭音乐派对：灯光随音乐节奏变化，增强现场氛围
• 影视观看：灯光随影视音频同步调整，提升沉浸感
• 个人休闲：营造与音乐匹配的舒适灯光环境

配置说明

构建镜像

bash
# 构建master版本
docker build -t knapoc/hue-sync .

# 构建指定版本
docker build --build-arg SHAIRPORT_VERSION=master -t knapoc/hue-sync:master .

运行容器

bash
docker run -d \
    --name=hue-sync-container \
    --net=host \
    --device=/dev/snd:/dev/snd \
    -e "HUE_BRIDGE_IP=你的Hue桥IP" \
    -e "BRIDGE_ACCESS_IDENTIFIER=你的开发者标识符" \
    -e "HUE_LAMP_COUNT=1,2,3" \
    -e "AIRPLAY_NAME=hue-sync-docker" \
    docker.xuanyuan.run/knapoc/hue-sync

Docker Compose部署

yaml
version: '2'
services:
  hue-sync:
    restart: always
    image: docker.xuanyuan.run/knapoc/hue-sync
    network_mode: host
    environment:
      - "HUE_BRIDGE_IP=你的Hue桥IP"
      - "BRIDGE_ACCESS_IDENTIFIER=你的开发者标识符"
      - "HUE_LAMP_COUNT=1,2,3"
      - "AIRPLAY_NAME=hue-sync-docker"
    devices:
      - "/dev/snd:/dev/snd"

参数说明

• --net=host：必须使用主机网络模式以确保AirPlay和Hue通信正常
• --device=/dev/snd:/dev/snd：共享主机ALSA音频系统，无需--privileged权限
• 环境变量：
  • HUE_BRIDGE_IP：Philips Hue桥接器的IP地址
  • BRIDGE_ACCESS_IDENTIFIER：Hue开发者标识符（获取方式参考Hue开发者文档）
  • HUE_LAMP_COUNT：需要控制的Hue灯编号（以Hue App中显示的编号为准，用逗号分隔）
  • AIRPLAY_NAME：AirPlay设备名称，默认值为hue-sync-docker
  • HUE_SYNC_PORT：监听播放请求的端口，默认值为5001