https://github.com/sshane/hue-sync
Sync your Hue lights to music with the Entertainment API
https://github.com/sshane/hue-sync
Last synced: 26 days ago
JSON representation
Sync your Hue lights to music with the Entertainment API
- Host: GitHub
- URL: https://github.com/sshane/hue-sync
- Owner: sshane
- Created: 2025-12-13T19:08:49.000Z (6 months ago)
- Default Branch: master
- Last Pushed: 2025-12-15T21:13:42.000Z (6 months ago)
- Last Synced: 2025-12-17T10:19:23.917Z (6 months ago)
- Language: Python
- Homepage:
- Size: 56.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## hue_sync
Streams Philips Hue **Entertainment** frames driven by audio analysis (system-audio or file playback).
### Security / publishing note
Do **NOT** commit Hue credentials to git.
- Local credentials live in `hue_creds.json` (ignored by `.gitignore`)
- If you use `pykit_auth_test.py`, it may write `data/auth.json` (also ignored)
If you accidentally committed secrets in the past, rotate them in the Hue app / re-auth and rewrite history.
### Install
```bash
pip install numpy sounddevice soundfile requests python-mbedtls pygame
```
### Authenticate (creates local `hue_creds.json`)
Press the physical Hue bridge button, then run:
```bash
python3 ./hue_sync.py --bridge-ip --auth
```
### Run (system audio)
```bash
python3 ./hue_sync.py \
--bridge-ip \
--ent-id \
--system-audio \
--input-device \
--preview
```
Tips:
- Use `python3 ./hue_sync.py --list-devices` to find a monitor/loopback input.
- If the preview/lights look early/late vs what you hear, use `--tune-delay` or `--audio-delay-ms`.