A native macOS client for WLED.
Menu bar for quick control, main window for everything else.
Built with SwiftUI. No third-party dependencies, no Xcode project, and no Apple Developer account needed.
- Menu bar — quick control, everything one click deep. All On / All Off, per-row power, brightness and an 11-colour spectrum strip. The overflow menu holds only what a row cannot already do: presets, open in the main window, open the controller's own web UI.
- Main window — an inline hue/saturation colour wheel, effects, palettes, speed and intensity, plus the white channel on RGBW strips. A sidebar of groups and controllers feeds one shared detail pane, and adding controllers and editing groups happens there too.
- Automatic discovery over Bonjour (
_wled._tcp) — no IP entry, no subnet sweep - Groups with synced power, brightness, colour, effect and palette
- Live state over WebSocket, so changes made from the phone app or a physical button show up here without polling
- Presets, including playlists
- White-channel slider on RGBW strips, hidden on strips without one
Rows collapse to name and toggle when a light is off, and a dropped request is retried rather than latched as an error.
- macOS 14 or later
- Command Line Tools (
xcode-select --install) — Xcode is not required
./build.sh && open ./build/WLED.appbuild.sh compiles with swiftc, assembles the .app by hand and ad-hoc signs
it. Nothing to install.
Ad-hoc signing is enough to run indefinitely on the machine that built it. It is not enough to distribute: another Mac needs Developer ID signing and notarization, or Gatekeeper blocks it.
The app launches as a menu bar accessory (LSUIElement), so it has no Dock icon
until a window is open.
macOS asks for Local Network access. Grant it — Bonjour discovery silently returns nothing if denied, which is why the popover shows a warning rather than an empty list. If discovery still finds nothing, open the window and add a controller by IP; that isolates whether the problem is Bonjour or HTTP.
| Purpose | Call |
|---|---|
| Read everything | GET /json — state, info, effects and palettes in one request |
| Write | POST /json/state — {"on":"t"}, {"bri":128}, {"fx":12}, {"ps":3} |
| Presets | GET /presets.json |
| Live updates | ws://<host>/ws — state pushed on change from any source |
| Discovery | mDNS _wled._tcp.local |
Continuous controls are debounced per host, so dragging a slider never floods a controller. Only the device list and group definitions are persisted; live state is always re-read, so the UI cannot report a stale idea of what the lights are doing.
AppIcon.icns is committed, so a normal build does not need this.
swift Tools/make-icon.swift Resources
iconutil -c icns Resources/AppIcon.iconset -o Resources/AppIcon.icnsRoom mapping and visualisation, Stream Deck automation, segment editing.