Download Betterleaf for Windows

Unsigned builds

The installer is not code-signed, so Windows SmartScreen shows a notice the first time it runs: choose More info, then Run anyway. When GitHub reports the file's SHA-256, it is shown above so you can check what you downloaded: in PowerShell, Get-FileHash .\Betterleaf-Setup-*.exe.

Which lights

Betterleaf speaks Nanoleaf's local API, the one every controller answers on port 16021 of your own network. The Light Panels (the original triangles, model NL22) and the Canvas (NL29) are the models it was built and tested against, including their two different streaming protocols and the Light Panels' Rhythm module. Shapes, Elements and Lines speak the same API and are known to the app, but have not been tried on real hardware; if you have one, a note on the support page about what worked and what did not is welcome.

After installing

1. Launch it. Betterleaf searches your network at once. Lights it has not been paired with appear in the sidebar under Found, not paired; if your router keeps them hidden, Add by address takes the light's IP address.
2. Pair each light. Pick it, then hold the controller's power button for five to seven seconds until its light flashes. Betterleaf keeps trying for the whole thirty-second window.
3. Make rooms, schedules and app scenes as you like. Closing the window keeps Betterleaf running in the tray so they carry on; Quit is in the tray icon's menu.

The guide walks through every view: the light and room pages, the library, schedules, locks, app scenes and the command-line tool.