LightElf is a DJ/party laser controller solution sold to Chinese device makers with an accompanying app to control over bluetooth. If you search Amazon or Ali etc for "bluetooth dj laser" you'll find a lot of options, look for the "LightElf" link and it'll probably work with this integration. Here's an inexpensive example on Amazon (affiliate link)
I've developed several HA solutions over the past decade, but this one is 100% vibe coded between Codex and Claude, then tested on my hardware. Just want to get that out there right up front: I have written 0% of this code.
All features from the original app are covered, this integration should allow you to setup and use a compatible laser without ever having to install a chinese mobile app. This requires that Home Assistant has one or more Bluetooth radios available to it, tested using ESPhome proxy devices.
There are couple key additional features not found in the original mobile app:
- There are 200 built-in animations, the app provides no preview so you get four sets of 50 blank, unlabeled buttons to click on. I setup a global shutter camera on a clean wall, captured all 200 animations, looped and cleaned up, and now all animations have working previews. This component is a little big to download as it's coming with 200 WebP preview animations.
- The app supports drawing pictures, instead we support uploading an SVG. These lasers are very limited, keep the SVG super simple, a couple examples are included and you can upload more through the config flow.
- The app supports adding motion effect to drawn pictures, this integration extends that feature to support text and shapes too, this is a huge unlock over the stock application.
With all that said here's the repo: GitHub - aderusha/lightelf_laser: Home Assistant component for LightElf BLE controlled RGB party lasers · GitHub
LightElf Laser
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.
Control projector power, SVGs, text, built-in shapes, and firmware-native animations from Home Assistant, with previews before you light the wall.
Features
- 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.
Installation
HACS custom repository
- 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.
Manual install
Copy custom_components/lightelf_laser into your Home Assistant custom_components directory, restart Home Assistant, then add LightElf Laser from Settings > Devices & services.
Setup Notes
The projector supports one BLE connection at a time. If setup cannot find the device, disconnect any other BLE controller and try again. Once configured, the BLE connection switch controls whether Home Assistant holds the connection or releases it.
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.
Documentation
Safety
This controls laser hardware. Aim the projector at a safe projection surface, avoid eye exposure, and follow the safety instructions for your device.
License
The integration code is released under the MIT License.
Bundled Hershey font data is permissively redistributable with acknowledgements; see Third-Party Notices.