Use an Apple HomePod (or any AirPlay speaker) as a speaker for your Windows PC, and keep web video in sync with it.
AirPlay audio plays ~2.5 s behind real time and that delay can't be removed, so a companion browser extension delays the on-screen video by the same amount to match the sound. Works on YouTube, Plex, anime sites, and most HTML5 players.
Platform: the audio side is Windows-only (uses WASAPI/DirectShow capture and Windows process control). The browser extension targets Firefox / Zen (and works in Chromium/Edge). DRM-protected video (Netflix, etc.) can't be delayed - the browser blocks frame capture.
There are two halves:
| Half | What it does |
|---|---|
| Audio streamer (Python) | Captures a Windows audio device and streams it to the HomePod over AirPlay (via pyatv + ffmpeg). A small local HTTP server lets the extension start/stop it and scan for HomePods. |
| Browser extension | Delays the page's video to match the audio, syncs subtitles, and gives you a popup to connect/disconnect, pick the HomePod, tune the delay, and disable per-site. |
You can use the extension's video-delay on its own, but the HomePod connect/scan buttons need the local server running.
homepod-av-sync/
├─ extension/ Browser extension (load this in Firefox/Zen/Edge)
│ ├─ manifest.json background.js content.js popup.html popup.js
│ └─ icons/ icon.svg (adaptive) + icon-white.svg
├─ server/ Windows audio side (Python)
│ ├─ homepod_server.py Local control server (scan/start/stop)
│ ├─ homepod_stream.py Captures audio -> streams to HomePod
│ ├─ atvremote_lowlatency.py Low-latency pyatv wrapper
│ ├─ requirements.txt
│ └─ Start-*.bat / Tune-Latency.bat Manual launchers
├─ Install.bat / Uninstall.bat One-click setup (-> setup.ps1 / uninstall.ps1)
├─ build-extension.ps1 Zips the extension for signing/distribution
└─ README.md LICENSE
- Windows 10/11
- Python 3.9+ on PATH (
python --version) - ffmpeg on PATH (
ffmpeg -version) -winget install ffmpegor https://ffmpeg.org - A HomePod / AirPlay speaker on the same network
- A virtual audio device to route what you want to the HomePod. Either:
- Elgato Wave Link (capture its Stream Mix), or
- VB-Audio Virtual Cable (capture CABLE Output)
- Firefox or Zen (or Chromium/Edge)
-
Double-click
Install.bat. It checks Python/ffmpeg, installs the Python deps, and registers the control server to auto-start (hidden) at every login. Runs in your user session - a real Windows Service can't reach audio devices (they're per-session). No admin needed. Remove any time withUninstall.bat.Prefer manual?
pip install -r server/requirements.txt, then runserver\Start-HomePodServer.bat(visible window) when you want it. -
Install the extension (see Installing the extension).
-
Pick your HomePod: open the popup -> Scan -> click your device.
-
Pick the audio source: open the popup -> Audio -> click the capture device to stream (e.g. the Wave Link Stream Mix or CABLE Output (VB-Audio Virtual Cable)). Both choices persist in
server/homepod_config.json.
The source lives in extension/ (manifest.json at its root).
- Temporary (quickest, dev): Firefox/Zen ->
about:debugging#/runtime/this-firefox-> Load Temporary Add-on -> selectextension/manifest.json. Removed when the browser restarts. - Permanent on Edge/Chromium:
edge://extensions-> Developer mode -> Load unpacked -> select theextensionfolder. Stays installed. - Permanent on Firefox/Zen (signed): Firefox only runs signed add-ons
permanently. Sign it for self-distribution (free):
Get API credentials at https://addons.mozilla.org/developers/addon/api/key/. This produces a signed
npm install -g web-ext web-ext sign --source-dir extension --channel unlisted ` --api-key <JWT_ISSUER> --api-secret <JWT_SECRET>
.xpi(attach it to a GitHub Release); install it viaabout:addons-> gear -> Install Add-on From File.
build-extension.ps1 zips the extension into dist/ for uploading/signing.
Open the toolbar popup:
- Delay + tune buttons - adjust until lips match the HomePod.
- Sync - turn the video delay on/off.
- HomePod - connect/disconnect the audio stream (needs the server).
- Vol - slider to set the HomePod's volume (needs a selected HomePod).
- Device + Scan - find and select which HomePod to use.
- Audio - list and select which capture device to stream from.
- Disable here / Enable here - blacklist the current site (per-host, live).
If another device takes over the HomePod (e.g. AirPlays music to it), the stream yields and the video auto-pauses with a notice. Press play to reclaim the HomePod and resume in sync.
The streamer also has standalone scripts in server/:
Start-HomePodStream.bat (stream without the extension) and Tune-Latency.bat
(find your lowest stable latency).
- The extension captures each video frame into a ~2.5 s ring buffer and draws it
back delayed onto an overlay canvas; the real
<video>stays hidden but keeps playing so its audio reaches the HomePod live. - Subtitles are delayed too (textTracks, Plex/libjass DOM, and jassub/Octopus canvas subs are all handled).
- Won't work on: DRM-protected media (Netflix/Disney+, some Plex titles) -
the browser returns black frames. YouTube ambient mode also breaks capture,
so the extension auto-disables it while syncing. On Firefox/Windows, the
GPU hardware video overlay can hide frames from capture (grey picture) - see
Troubleshooting for the one-time
about:configfix. - Latency is inherent to AirPlay (~2.5 s); fine for music, and matched for video.
- Capture quality/FPS:
CFG.maxWidth(1920) andCFG.maxCaptureFps(60) at the top ofextension/content.js. Higher = sharper/smoother but more RAM (~1.3 GB at 1080p60). Drop to 1280/30 for ~280 MB. - Server port / token:
server/homepod_server.py(PORT,TOKEN) must matchSERVER/TOKENinextension/background.js. The token only stops other local pages from poking the localhost server; change it if you like. - Latency / device / bitrate: top of
server/homepod_stream.py(or CLI flags;python server\homepod_stream.py --help).
-
Popup says "server off" / scan fails: the control server isn't running - run
Install.bat(orserver\Start-HomePodServer.bat). Verify athttp://127.0.0.1:17645/status. -
Video is black on a site: DRM-protected media (can't capture) - use Disable here. On YouTube, ambient mode is handled automatically.
-
Grey video on Firefox (esp. Plex after a window resize or using its mini-player): Firefox's hardware video overlay (DirectComposition) keeps the decoded frames in GPU memory where no canvas read can reach them, so the delayed picture comes out flat grey. The extension auto-detects this and, after a couple seconds, restores the live (un-delayed) video and shows a one-time notice rather than leaving a grey screen. To get the delayed picture back, apply this one-time browser setting:
- Open
about:config(accept the warning). - Search
gfx.webrender.dcomp-video-overlay-winand set it to false. (If your build also lists...dcomp-video-hw-overlay-win/...dcomp-video-sw-overlay-win, set those to false too.) - Restart Firefox/Zen.
This disables only the video overlay (hardware decoding/acceleration stay on), so the cost is negligible. Chromium/Edge isn't affected by this overlay.
- Open
-
No audio on HomePod: check the capture device (
python server\homepod_stream.py --list) and that audio is actually routed to it (Wave Link Stream Mix / VB-Cable), or pick it in the popup's Audio list. -
Lag: lower
CFG.maxWidth/maxCaptureFps.
MIT - see LICENSE. Uses pyatv (MIT) and ffmpeg (LGPL/GPL).
Toolbar icon: "HomePod" by James Henry from the Noun Project
(noun-homepod-1600397), adapted to the toolbar theme via context-fill.