This system connects to any Bluetooth lighting device with a "QHM-" prefix in its Bluetooth name and runs on macOS. Is fully live and works very well with DJing too!
Here are the lights I used:
https://amzn.to/3Zw2HxQ or https://amzn.to/4dAwhrN
Support for Windows and Linux is coming soon!
Install the 2-channel virtual audio driver using Homebrew:
brew install blackhole-2ch
This enables audio loopback, allowing your system audio to be captured and analyzed in real-time.
Download the repository (code) to your computer
Make sure you have Python 3.8+ installed, then install the required packages:
pip install bleak
pip install numpy
pip install matplotlib
pip install sounddevice
To route system audio through BlackHole and still hear it through your speakers or headphones:
- Open Audio MIDI Setup (found in
/Applications/Utilities/) - Click the
+button and choose "Create Multi-Output Device" - In the right panel, check:
- ✅ BlackHole 2ch
- ✅ Your actual output device (e.g., MacBook Speakers, Headphones, etc.)
- Set the Multi-Output Device as the system output in System Settings > Sound
Run visualizer.py and you’re now ready to use the system! It will listen to your music and react with lights accordingly 🎵💡
Special thanks to Akashcraft for reverse engieering the bluetooth protocol for these type of lights. Your contributions helped light the way — literally.