HomePodCast

把 Windows 电脑的声音实时推送到 HomePod（AirPlay 2），为打游戏和看视频做的低延迟方案。

TuneBlade 在 HomePod 软件 27 上已经无法出声；HomePodCast 是从头实现的原生 C# 版本，单个 exe 约 350 KB，不需要虚拟声卡。

实测

场景	数值
声音比画面晚（延迟设 120 ms，手机 60 帧录像实测）	156 ms
声音比画面晚（延迟设 105 ms，推算）	约 141 ms
推流统计（断音 / 迟发 / 重传）	0 / 0 / 0
内存（私有）	约 28 MB

测试设备：HomePod 第二代，HomePod 软件 27.0（24J361）。

功能

• AirPlay 2 实时音频：瞬时配对、全程加密，延迟 100–500 ms 可调（1 ms 粒度）
• 托盘程序：自动发现音箱、自动重连、睡眠唤醒恢复、被其他设备抢占时不抢回
• 混音器：每个程序单独的音量、静音和电平表
• 音画同步测试：屏幕闪光 + 「咔」声，直接看出声音比画面晚多少
• 浏览器插件（开发中）：把 YouTube、bilibili 的画面延后，和 HomePod 的声音对齐

使用

1. 安装 .NET 10 桌面运行时。
2. 运行 HomePodCast.exe，第一次会请求添加防火墙规则（只放行局域网、只在专用网络下生效）：HomePod 需要连回电脑对时和请求重传。
3. 程序会自动找到 HomePod 并连接。把电脑的默认输出设备静音也没关系：采集发生在系统音量之前，HomePod 照样有声。

命令行（排查问题用）：

HomePodCast.exe scan                         列出局域网里的 AirPlay 音箱
HomePodCast.exe stream --host <IP> --latency 120 --seconds 30
HomePodCast.exe mutetest                     确认静音后仍能采集

构建

需要 .NET 10 SDK。

dotnet build src -c Release          # 输出到 app\
dotnet test tests\HomePodCast.Tests  # 协议与音频单元测试

tools\measure_av.py 可以从手机录像里算出音画差；tests\vectors\gen_vectors.py 用 pyatv 所用的 srptools 生成配对算法的对照数据。

分支与发布

分支 / 标签	用途	规则
dev	日常开发	每次推送都会跑 CI 并产出预览包
main	在真实 HomePod 上验证过的代码	只接受来自 dev 的 PR，CI 必须通过
vX.Y.Z 标签	正式版本	打在 main 上，自动构建并发布 GitHub Release
release/x.y	给旧版本打补丁	需要时才从对应标签拉出

CI 无法连接 HomePod，所以 dev 合并到 main 之前要在真机上做一次音画同步测试。

代码签名政策

发布的 Windows 程序计划使用 SignPath.io 提供的免费开源代码签名，证书由 SignPath Foundation 签发。

• 只签署由本仓库公开源码、经 GitHub Actions 自动构建出来的文件。
• 提交者与审核者：仓库维护者（@qiyinxi）。
• 隐私：HomePodCast 只和你局域网里的 AirPlay 音箱通信，不收集、不上传任何数据；本机状态接口只监听 127.0.0.1。

English

HomePodCast streams Windows system audio to Apple HomePod speakers over AirPlay 2 with low latency (about 141 ms behind the picture at a 105 ms setting, measured), as a replacement for TuneBlade, which no longer produces sound on HomePod software 27. It is a native .NET 10 tray application with a per-app mixer, an audio/video sync test and automatic reconnection.

Code signing policy

Free code signing provided by SignPath.io, certificate by SignPath Foundation.

• Only binaries built by GitHub Actions from the source code in this public repository are signed.
• Committers and reviewers: @qiyinxi
• Approvers: @qiyinxi

Privacy policy

This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it. It talks only to the AirPlay speakers on the local network that the user selects, and its status endpoint listens on 127.0.0.1 only.

致谢

• pyatv（MIT）：协议流程参考，配对算法以其依赖 srptools 为对照。
• NAudio（MIT）：核对 Windows Core Audio 接口定义。
• AirFlash（GPL-3.0）：低延迟发包与缓冲的思路。

许可证

GPL-3.0-or-later。可以自由使用、修改和再发布；再发布修改版时必须同样以 GPL 开源。