Skip to content
PSPixelPSPixel

Web UI / Web API

A browser-based dashboard and configuration page, served by the device itself — no app, no cloud account, nothing to install. It works over your normal Wi-Fi network, and also over the device’s own setup network if it can’t join yours, so there’s always a way in.

Reaching it

Section titled “Reaching it”

Open the device’s IP address (or http://192.168.4.1/ if you’re connected to its setup network) in a browser:

  • / — the dashboard: current mode, on/off, brightness, speed, color.
  • /modes — settings specific to each lighting mode (e.g. the runner’s length, the off-fade duration).
  • /config — device/network/system configuration, grouped into three sections: Default (device, Wi-Fi, LEDs), Channels (MQTT, button, IR remote, Web API), and Others (logging, watchdog), plus a separate Device control section with the restart button. Changes take effect as soon as you hit Save — most settings apply immediately, a few need a restart (see the Applies column in the Development guide) — Wi-Fi network settings always need a restart, see Network.

Some sections have their own action button beyond Save:

  • LEDs → Test lights the strip using whatever count is currently typed in the form, so you can confirm it before saving.
  • Wi-Fi → Network → Scan for networks lists nearby networks with signal strength as suggestions on the Network name field — useful for getting the exact name right, especially while connected to the device’s own setup network.
  • MQTT → SSL → Certificate → Upload certificate sends a CA certificate file straight to the device’s certs/ folder and selects it in the Certificate name dropdown for you — see Secure connections.

Both pages are just a thin layer over the same JSON API every other integration uses (GET/POST /json/state) — nothing you can do here that you couldn’t do with a raw HTTP request, it’s just easier.

Settings

Section titled “Settings”

Configured in the webapi section of config.json:

SettingDefaultWhat it does
webapi.wifi_accesstrueSet to false to restrict the dashboard/API to the device’s own setup AP — they stay unreachable over your configured Wi-Fi network, but always reachable on the setup AP. true (default) allows both.