01 · App
Get the app
The free lightControl LED iPhone app is available on the App Store. It needs iOS 17 or later and Bluetooth. It has no accounts and nothing to sign in to.
The app has two tabs. Lights finds lightControl lights near you; tap one to change its name, power, brightness, mode and mode settings, LED Setup and more. Wi-Fi stores your home Wi-Fi on the phone so you can send it to a light, which is optional.
02 · Firmware
Install the firmware
- Open the installer in Chrome or Edge on a Mac, Windows or Linux computer. Safari, Firefox and phone browsers can't install firmware, because they don't support Web Serial.
- Plug the ESP32-C3 into the computer with a data USB cable. Some cables only charge; if no port appears, try another cable.
- Press Connect and install, pick the port that appears and follow the steps. It takes about a minute.
- When it finishes, the light glows warm white on its first 30 LEDs. That proves the wiring before any app setup.
If the port doesn't appear, hold the board's BOOT button while plugging it in, then try again.
Prefer to build it yourself? The firmware is an Arduino sketch for the ESP32-C3 (board package esp32 by Espressif, ESP32C3 Dev Module, Huge APP partition scheme, USB CDC On Boot enabled).
03 · Troubleshooting
My light doesn't appear in the app
- Bluetooth is off or not allowed. Turn Bluetooth on in Control Center, and allow Bluetooth for lightControl in iOS Settings. The app tells you on the Lights tab if either is the problem.
- The light has no power or no firmware. A freshly installed light glows warm white. If it stays dark, check the 5 V supply, the common ground and the data wire to GPIO 3, then reinstall the firmware.
- Too far away. Bring the phone close to the light. A new light is called lightControl until you rename it.
- It just restarted. After a change of LED count or colour order, or a restart or factory reset, the light comes back in a few seconds and the app reconnects by itself.
- Only lightControl lights are listed. The app ignores every other Bluetooth device, so you won't see your light in iOS Settings > Bluetooth. That is normal.
Still nothing? Connect the board to a computer and open a serial monitor at 115200 baud. At boot the firmware prints its version, name, LED layout, mode and Wi-Fi state, which helps when you email for help.
04 · LED Setup
LED Setup
Open your light in the app, then LED Setup.
LED count
Enter how many LEDs your strip has, up to 600, and apply. The light saves it and restarts; the app reconnects by itself.
Colour order (Test colours)
Tap Test colours. The first three LEDs should light red, green and blue for 20 seconds. If you see other colours, choose another colour order, apply, and test again. Most WS2812B strips are GRB. Changing the order also restarts the light.
Loop or strip
Choose Loop if the strip forms a closed shape, such as a square or circle. Bars and sunrises then climb up both sides from the start LED and meet at the top. Choose Strip for a single run; bars rise from the start LED in one direction.
Start LED
Step the start LED until the lit LED sits where you want bars and sunrises to begin, such as the bottom middle of a square. The selected LED lights white for 20 seconds so you can see it. This applies straight away.
Power limit
Each LED draws about 60 mA at full white. Set the limit a little under what your 5 V supply is rated for (the default is 1500 mA); the light dims itself to stay under it. USB from a computer gives about 500 mA, a phone charger usually 1000 to 2000 mA.
05 · Wi-Fi
Do I need Wi-Fi?
No. The light works over Bluetooth alone. Wi-Fi is used only for the Sunrise clock: the app sets the light's clock every time it connects, and Wi-Fi keeps that clock right after a power cut, so scheduled sunrises still start on time.
To add it, save your home network in the app's Wi-Fi tab, open your light and send the saved Wi-Fi to it. The light shows its connection status. Forget Wi-Fi on this light removes it again. Bluetooth stays on either way.
06 · Reset
Factory reset
Open your light in the app, then Advanced > Factory reset. This erases the name, LED setup, every mode setting and the saved Wi-Fi, then restarts the light with the defaults: warm white, 30 LEDs, loop, GRB, 1500 mA. Restart light in the same section reboots without erasing anything.
If the app can't connect to the light, reinstall the firmware from the installer and choose to erase the device when asked.
07 · Build
Parts and wiring
- ESP32-C3 board (any with native USB, such as the ESP32-C3 SuperMini)
- WS2812B LED strip (up to 600 LEDs)
- INMP441 I2S microphone (only for Bar Spectrum)
- 5 V power supply sized for your strip: about 60 mA per LED at full white
- 330 Ω resistor for the LED data line
| From | To ESP32-C3 |
|---|---|
| LED strip DIN (through 330 Ω) | GPIO 3 |
| LED strip 5V / GND | 5 V supply; supply GND also to the board's GND |
| INMP441 SCK | GPIO 5 |
| INMP441 WS | GPIO 4 |
| INMP441 SD | GPIO 10 |
| INMP441 L/R | GND |
| INMP441 VDD / GND | 3V3 / GND |
Power long strips from the supply, not through the board's USB. For long strips, feed 5 V in at both ends.
08 · Contact
Still need help?
Email [email protected]. Tell us your board, LED strip and count, the firmware version (shown in the app under Advanced) and what you see. A photo of the wiring helps.
See also the privacy policy.