FROM THE FIRST CLICK

A panel that feels like yours.

Install the integration. Connect the app. Build your first room. Follow the steps below — at your own pace.

01 · NSPanel Pro

An Android NSPanel Pro on the same local network as Home Assistant.

02 · Home Assistant

A working HA installation, MQTT integration and optionally HACS.

03 · MQTT & ADB

WebSocket access to your MQTT broker; network ADB for first installation.

HOME ASSISTANT

Start with the integration.

Add the repository to HACS

In HACS, open the menu → Custom repositories. Paste the repository URL, choose Integration and add it. Find Aurelvi and download it.

https://github.com/sonics007/aurelvi-ha

Open HACS repository setup

Restart Home Assistant

Restart HA to load the installed integration. For an update, keep your existing Aurelvi integration entry.

Add Aurelvi

Go to Settings → Devices & services → Add integration and search for Aurelvi. MQTT must already be configured. Open Aurelvi Studio in the sidebar.

Add the integration

Installing without HACS?

Download aurelvi.zip, extract it and copy its aurelvi folder to /config/custom_components/aurelvi. Keep the folder name without a version number, then restart HA.

Download integration ZIP

A FIRST HELLO

Bring your panel online.

Enable network ADB on the panel

Enable ADB/network debugging using the supported procedure for your panel firmware. Find the panel IP in your router or Android network settings. The exact menu varies by firmware.

Open Setup / Update

In Studio, click Setup / Update. Enter the local panel IP and port 5555, then Connect / test ADB. On the panel, accept the RSA authorization prompt.

Aurelvi · Setup / Update

Panel IP192.168.1.50

ADB port5555

Connect / test ADBInstall latest Aurelvi APK

Illustration · use your own panel IP address

Install and open Aurelvi

Click Install latest Aurelvi APK. HA downloads and verifies the official APK, installs it and opens the app. Set Aurelvi as Home if you want it to be the Android launcher.

Prefer a terminal?

Use your own panel IP and the path to the downloaded APK. Accept the authorization prompt on the panel.

adb connect 192.168.1.50:5555
adb install -r Aurelvi.apk
adb shell am start -n sk.openpanel.nspanel/.MainActivity

THE LOCAL CONNECTION

Meet Home Assistant.

Configure MQTT in the app

Open the app settings. Set the MQTT WebSocket address and broker credentials, and select Aurelvi integration mode. Use the WebSocket port configured on your broker, not its regular MQTT TCP port.

ws://YOUR_BROKER_IP:YOUR_WEBSOCKET_PORT

Add the discovered panel

Return to Aurelvi Studio. The panel should appear after it connects to the same MQTT broker. Add the panel to allow its control actions. If you add it manually, use the exact device ID shown by the app.

MAKE IT PERSONAL

Build your first room.

Start with Build room

Choose an HA area using Build room. Studio creates an editable draft from supported entities. Check the assigned entities, button actions and fan capabilities before saving.

Actual Aurelvi Studio editor — Actual editor screenshot · Studio 0.3.4

Choose a skin and wallpaper

In Appearance and wallpaper, choose a skin, one of the backgrounds or your own image. Adjust clock, screensaver and night settings in Display.

Browse all 80 skins

Save, then test on the panel

Click Save to panel. Try one control and confirm its real entity state in HA. Preview buttons on this website are illustrative; only the paired panel controls your home.

Keep both parts up to date

Update the HA integration through HACS or the release ZIP, then restart HA. Update the APK through Studio ADB or the app updater. The integration and APK have separate version numbers.

Integration 0.3.7 · APK 0.3.7

A LITTLE HELP

If something needs a nudge.

ADB does not connect

Check that network debugging is enabled, HA can reach the panel IP/port, and the authorization prompt has been accepted. Firmware or network rules can block ADB.

The panel stays offline in Studio

Check MQTT WebSocket address, credentials, Aurelvi integration mode and exact device ID. HA and the panel must connect to the same broker.

The old editor is still shown

Integration fails with brightness: null

Update to integration 0.3.6 or later and restart HA. The fix safely omits missing light readings while preserving valid states. Keep the existing integration entry.