Home Assistant custom integration for LightElf-compatible BLE RGB laser projectors, such as this inexpensive example on Amazon (affiliate link).
This integration runs locally through Home Assistant's native Bluetooth stack, no cloud service or mobile app required for setup nor operation. Plug in your laser, HA detects it, you import it, and you're ready to party!
Control projector power, SVGs, text, built-in shapes, and firmware-native animations from Home Assistant, all with native HA control surfaces and previews before you light the wall.
- Local BLE control with live device-state polling.
- SVG drawing with a native Home Assistant upload flow.
- Vector text with bundled Hershey fonts, solid colors, or rainbow strokes.
- Firmware scrolling text without host-side frame streaming.
- Built-in static shapes with live previews.
- Firmware-native animations with captured previews.
- Sound-reactive mode that drives the active effect from the projector's onboard microphone, with an adjustable sensitivity.
- Live transforms for your drawings — spin, flip, tumble, cylinder-wrap, and more — plus a static size control, all firmware-driven.
- BLE Connection Control so Home Assistant can release the projector for mobile app access.
- Open HACS in Home Assistant.
- Add this GitHub repository as a custom repository with category Integration.
- Install LightElf Laser.
- Restart Home Assistant.
- Go to Settings > Devices & services > Add integration and choose LightElf Laser.
Copy custom_components/lightelf_laser into your Home Assistant
custom_components directory, restart Home Assistant, then add LightElf Laser from Settings > Devices & services.
The projector supports one BLE connection at a time. If setup cannot find the device, disconnect any other BLE controller (such as the mobile app) and try again. Once configured, the BLE connection switch controls whether Home Assistant holds the connection or releases it. Turn that switch off to re-enable mobile app connections.
The integration seeds a few starter SVGs into Home Assistant local media on first run. Upload your own from Settings > Devices & services > LightElf Laser > Configure; the integration saves the file, refreshes the SVG picker, and selects it automatically.
This controls laser hardware. Aim the projector at a safe projection surface, avoid eye exposure, and follow the safety instructions for your device.
The integration code is released under the MIT License.
Bundled Hershey font data is permissively redistributable with acknowledgements; see Third-Party Notices and the bundled
custom_components/lightelf_laser/fonts/NOTICE.md.
