Setup · from zero
Set up a panel, step by step.
From HACS to a powered-on, licensed panel — install the integration, restart Home Assistant, push the app over ADB, connect it, and build your pages in the visual editor. Driven by the real admin GUI, no cables, no touching the panel by hand.
Before you start
requirementsA Sonoff NSPanel Pro
The wall panel (480×480, Android 8.1) the app runs on.
ADB, one-time. Enable ADB over network on the panel and accept the RSA key once — then Home Assistant installs and updates the app for you, pure Python, no PC or cables.
The full walkthrough
25 steps · real GUIInstall
HACS
Add the custom repository
In HACS → ⋮ → Custom repositories, add the DomoDreams repository with category Integration.
https://github.com/domodreams/home-assistant-nspanel-pro
Install the integration
Download “DomoDreams Panel” from HACS.
HACS → search “DomoDreams Panel” → Download.
Restart Home Assistant
Restart HA so the freshly-installed integration is loaded.
Settings → System → top-right ⋮ → Restart Home Assistant.
Integration
Home Assistant
Starting point
No DomoDreams panel configured yet.
Add the integration
Search for “DomoDreams Panel” among the brands.
Filter by brand
The search hides this instance’s other, private integrations.
New panel
No panel is online yet, so the flow goes straight to the manual form.
Panel identity
Device id “nspanel-salone” — it must match the app’s instanceName.
Device created
The integration registers the device in Home Assistant.
Configured
“DomoDreams Panel” is now among the active integrations.
App install
The panel
Bare panel
The panel’s Android launcher, with our app not yet installed.
Config panel · offline
“Panel offline”: the device exists in HA but the app isn’t there yet.
Setup / Update tool
Brings a new panel online over ADB, before it even speaks MQTT.
Panel address
The panel’s IP on the local network.
Connected
px30_evb · Android 8.1.0 · app not installed.
Installing
The v1.1.0 APK is downloaded from the GitHub release and installed on the panel.
Installed
“Installed v1.1.0 — up to date.” Signed with the new release key.
First boot
The app on the panel
First boot
“Waiting for configuration…” with a provisional id. Swipe down for settings.
Settings · to fill in
Panel name and MQTT address / credentials — the password is masked.
Filled in and connected
instanceName “nspanel-salone” (same as the HA device id) → “Connected”.
Build
Lay out your pages
From the “NSPanel Pro” sidebar editor — visual, admin-only: pages on the left, a live panel preview in the middle, settings on the right.
Open the editor
“NSPanel Pro” in the HA sidebar: the pages list, a live preview of the panel, and the panel settings — theme, home page, timeouts, sizes.
Build a grid page
Click a cell to drop a tile, then set its icon, label and what it controls. Drag to move, drag a corner to resize.
Add any page type
Add clock, alarm, camera or music pages and set the swipe order — here a camera page with its live view and PTZ pad.
Style, sensors & licence
The Device tab: screensaver, presence and light-sensor behaviour, auto-brightness, diagnostics and the licence card.
Verify
The result
Live and licensed
Full licence applied: the grid is clean, no watermark.
Panel live — now dress it up.
Pick a style, then take the watermark off with a licence.