Settings in 1.0.0-rc1

These are the settings on the Configure page of version 1.0.0-rc1, in the order the app shows them. Settings marked Advanced are hidden while the page is set to Basic.

Other versions

Identity

Panel ID

Basic · panel_id

Stable id used in entity IDs (lowercase, digits, underscores; 63 characters maximum).

Friendly name

Basic · friendly_name

HA device display name.

This is the name shown:

• on the panel’s device card in Home Assistant;
• for this panel in other panels’ header switcher.

Left blank, it uses the Android device name and falls back to the model when the device has no name. Unlike Panel ID it is only a label, so you can rename it at any time without affecting entity IDs. It is never copied when settings are applied to another panel.

Manufacturer

Advanced · manufacturer

HA device-card manufacturer override (blank = profile/auto).

Model

Advanced · model

HA device-card model override (blank = profile/auto).

Area in Home Assistant

Basic · ha_area

Where this panel lives, by Home Assistant area name. This can only be changed in Panel Assistant if your HA user has admin permissions, otherwise change it on your device in HA.

Dashboard

Home Assistant WebSocket address family

Advanced · network_address_family

Applies to the panel’s Home Assistant WebSocket connections; plain HTTPS reads always try every published address. Automatic learns a working route and falls back between IPv6 and IPv4. Prefer IPv4 keeps IPv6 as a fallback; Force IPv4 rejects endpoints with no IPv4 address.

Dashboard app

Advanced · dashboard_package

App used for the dashboard. Blank uses ha-paneld’s built-in renderer.

This chooses which app draws the dashboard on the panel. The list always starts with Auto and Built-in renderer, followed by any supported Home Assistant Companion app installed on the panel. Using the Companion app as the dashboard is retired: it is listed only so a panel already set up that way keeps working, and Panel Assistant never removes it for you. Other launchable apps are not offered. If the panel is already set to an app the list does not recognise, that choice stays in the list rather than being dropped silently.

Choice	Stored value	What happens	When to pick it
Auto	blank	Uses Panel Assistant’s own renderer.	The usual choice.
Built-in renderer	builtin	Uses Panel Assistant’s own renderer, named explicitly.	When you want the choice spelled out in a backup or script.
A Companion app	its Android package name	Hands the dashboard to that app.	Retired as a panel dashboard. A panel already using it keeps working; switch to Auto once the panel is in Panel Assistant.

A change takes effect immediately: the panel launches the newly selected app as soon as the setting is saved. Selecting the built-in renderer needs a working Home Assistant connection first, so connect with Browser sign-in before choosing it.

Note

Most settings on this card apply only to the built-in renderer, including Home dashboard idle return, Dashboard theme, Entity filtering and Zoom (%). Saving an idle return time while a Companion app is selected is refused.

Related: The built-in renderer

Entity filtering

Basic · Default off · dashboard_entity_learning

Built-in renderer: limit Home Assistant’s state stream to dashboard-used entities and learn runtime dependencies. Manage sources and pins in Entities.

Home dashboard

Basic · home_dashboard

Dashboard used by reload and idle return.

• Auto lets Home Assistant choose.
• Custom accepts a specific view, e.g. /dashboard-name/tab-name.

Dashboard theme

Basic · Home Assistant select · dashboard_theme

Built-in renderer only.

• Follow Home Assistant leaves the dashboard’s light/dark choice to Home Assistant, which is what the Dark mode setting supplies a default for.
• Dark and Light choose it on this panel when Home Assistant is set to Auto, for a kiosk dashboard with no sidebar to reach the Home Assistant profile page from.
• Ambient chooses Dark or Light from the room’s light as the auto-brightness model sees it, and changes only after the room has stayed darker or lighter for a minute; it needs Auto-brightness on, and follows Home Assistant until it has a reading.

An explicit Light or Dark choice in Home Assistant still wins; use Auto or a separate panel user. Returning to Follow Home Assistant hands the choice back exactly as it was found.

Hide Android system bars

Advanced · Default on · dashboard_fullscreen

Built-in renderer only. Hides Android’s status and navigation bars while the dashboard is in front; swipe from an edge to reveal them temporarily.

It does not lock the panel or hide Home Assistant navigation.

Hide Home Assistant navigation (native)

Advanced · Default off · dashboard_native_kiosk

Built-in renderer only. After Home Assistant 2026.4.2+ connects, asks its native frontend to hide its navigation.

Off by default; an unsupported or failed request leaves the dashboard unchanged. It does not lock Android or inject CSS into the dashboard.

This uses Home Assistant’s own kiosk mode rather than altering the page. Once the frontend has loaded and connected, the built-in renderer sends it a kiosk_mode/set request to hide its navigation. If the request fails, the panel retries a few times; a Home Assistant version without the feature leaves the dashboard as it is. Turning the setting on or off applies to the dashboard already on screen, without a reload.

State	Use it when
On	The panel should show only the dashboard.
Off	People need Home Assistant’s navigation on the panel, for example to reach other dashboards or their profile page.

Hide Android system bars is the separate control for Android’s own bars.

Related: The built-in renderer

Idle return to home (min)

Basic · Default 0 · 0 to 1440 · Home Assistant number · dashboard_idle_return_min

Home Assistant URL

Basic · ha_url

Built-in renderer: Home Assistant base URL, e.g. http://homeassistant.local:8123. Blank disables it.

Long-lived access token

Advanced · ha_token

Use browser sign-in when possible. This fallback can be created in your Home Assistant user profile.

Zoom (%)

Advanced · Default 100 · 50 to 300 · dashboard_zoom

Browser zoom.

Behaviour

Auto-sleep activity source

Basic · auto_sleep_source

Use the panel’s calibrated proximity sensor, Home Assistant Area devices, or touch inactivity.

• Presence modes pause if their source is unavailable.
• Touch inactivity needs no presence setup.

Touch inactivity delay (seconds)

Basic · Default 30 · 5 to 86400 · auto_sleep_touch_delay_seconds

When Touch inactivity is selected, switch the screen fully off after this many seconds without a touch.

Auto sleep

Basic · Default off · Home Assistant switch · auto_sleep

Switch the screen off after the selected presence mode’s learned delay or the chosen touch inactivity delay. Manual screen control remains separate.

Navbar mode

Basic · Home Assistant select · navbar_mode

Soft on-screen navigation bar for panels with no native navbar. Native leaves navigation to the panel’s own Android bar and draws nothing.

Hiding the Android system bars, from the built-in renderer’s fullscreen setting or the Android dashboard lock, still hides a native bar.

Wake on wave

Basic · Default off · Home Assistant switch · wake_on_wave

Wake after a calibrated clear-to-near-to-clear wave. Set up proximity on the panel; touch-to-wake remains available.

Lock Android to dashboard (experimental)

Advanced · Default off · Home Assistant switch · kiosk_lock

Root-only casual-use lock. Hides Android system bars and returns to the selected dashboard within about 3 seconds when another app or Recents opens. It does not hide Home Assistant navigation.

Release it:

• here, or from Home Assistant
• through adb
• with 7 rapid top-left taps
• during the 60-second unlocked window after reboot

App watchdog

Advanced · Default off · watchdog_enabled

Self-heal the dashboard app: relaunch if it dies, return if backgrounded too long.

When the watchdog is on, Panel Assistant checks the dashboard app every 30 seconds and acts on two situations. It never acts while the dashboard is in front.

Situation	What the watchdog does
The app’s process is dead on two checks in a row	Starts the app again
The app is running but has not been in front for five minutes, for example because someone opened Settings and walked away	Brings the dashboard back to the front
The app keeps crashing as soon as it starts	Backs off instead of relaunching over and over, and shows a health warning; this clears when the dashboard comes back to the front

Someone leaves the dashboard at 0. The watchdog leaves them alone until the app has been in the background for five minutes.

The watchdog needs root or the Panel Assistant helper to see the dashboard’s state, and does nothing on panels with neither.

Tip

Leave it off if you often use other apps on the panel for longer than five minutes. For a faster return that also hides the Android bars, use Lock Android to dashboard instead.

Touch sound

Basic · Default on · Home Assistant switch · touch_sound

Silence boot chime

Basic · silence_boot_chime

Prevent idle dim

Basic · Default on · prevent_idle_dim

Keep panel responsive

Advanced · Default on · keep_awake

Keep the network and background services running while the screen is off.

With this on, Panel Assistant holds two Android locks:

• one that stops the processor from going into deep sleep;
• one that stops the Wi-Fi radio from going into power saving.

Without them, a panel with its screen off can stop answering on the network, drop its connection to Home Assistant or miss commands. The screen can still turn off as normal.

It is on by default because wall panels run on mains power. Turn it off only on a battery-powered device where standby time matters more than staying reachable.

Note

In Hardened security mode, turning it off from the network needs approval at the panel.

Related: Security mode

Display

Dark mode

Basic · Default on · dark_mode

Themes Panel Assistant’s own screens and sets the dashboard’s default colour scheme on panels without a system dark-mode setting (Android 9 and older).

A theme picked inside Home Assistant overrides the dashboard default; this web UI always follows the viewing browser’s own preference.

Ambient light source

Advanced · auto_brightness_ha_entity

Blank uses the panel light sensor. Select a Home Assistant illuminance sensor when the panel has no suitable sensor.

Auto-brightness

Basic · Default off · Home Assistant switch · auto_brightness

On-panel engine maps a lux stream to the backlight (off = HA drives the screen).

Minimum level

Advanced · auto_brightness_minimum_percent

Lowest automatic screen level as a percentage. Proposals scale between the minimum and maximum; manual brightness can still go lower.

Maximum level

Advanced · Default 100 · auto_brightness_maximum_percent

Highest automatic screen level as a percentage. Proposals scale between the minimum and maximum; manual brightness can still go higher.

Sensitivity

Advanced · Default 50 · 0 to 100 · auto_brightness_response_percent

How much of the difference from the learned ambient-light pattern is applied to the screen, once the engine has decided a change is real.

• Lower values keep the screen closer to its learned daily pattern.
• While the pattern is still being learned the screen follows the measured light directly.

System

Show network warning on dashboard

Advanced · Default on · dashboard_network_warning

Show the network connection warning on this panel’s dashboard. Network checks and status remain available when this is off.

CPU profile

Advanced · Home Assistant select · cpu_governor

Live CPU scaling profile until reboot; Auto = the SoC’s dynamic governor.

Zigbee router

Advanced · Default off · zigbee_router

Run the on-board Zigbee gateway as a router/repeater (NSPanel Pro).

This setting appears only on a panel with a built-in Zigbee gateway, such as the Sonoff NSPanel Pro. Turning it on starts the vendor gateway if it is not already running and switches it to the Repeater role, so the panel can extend an existing Zigbee network run by your own coordinator. To join it to that network:

1. Turn this switch on.
2. Open permit-join on your coordinator.
3. Use Request join in the Join Zigbee network row that appears under the switch. The button stays disabled once the router has joined.

Turning it off stops the gateway and frees the radio. Stock firmware often starts the gateway at boot by itself, and Panel Assistant only stops it when you have set this switch explicitly, so a gateway you already rely on is left alone by default.

Caution

On some stock firmware the vendor gateway cannot be stopped from the app and keeps running until the next restart.

While the router is on, Panel Assistant samples the gateway once a minute. After a 15-minute start-up grace period it treats the gateway as a runaway if either of these happens:

• it restarts three or more times within ten minutes;
• it stays unjoined while using more than half a CPU core for five consecutive samples.

A runaway gateway is stopped and this setting is turned off, to protect the panel’s responsiveness.

Samples during the grace period never count; only after minute 15 can five high readings in a row contain the gateway.

Related: Performance, Sonoff NSPanel Pro

Interface language

Basic · ui_language

Language used by Panel Assistant’s own interface.

Automatic uses an explicit page override first. Configure setting labels and help can then follow the connected Home Assistant user’s language; browser, device and English are the remaining fallbacks.

Launcher app

Advanced · launcher_package

App the Launcher button brings forward. Blank auto-picks an app. Selecting Panel launcher (Panel Assistant) also makes and keeps Panel Assistant the Android Home app.

The picker lists apps that register as an Android Home app. When the field is blank, Panel Assistant resolves the launcher in this order, and the Configure page shows which app it landed on:

1. the panel’s default Home app, if it is a real launcher;
2. otherwise another installed launcher;
3. otherwise its own Panel launcher, an app drawer for panel maintenance.

Apps that register as a Home app without being a launcher, such as Android Settings and some vendor control panels, are never picked automatically, because opening them would hide the dashboard rather than open an app drawer.

Choosing Panel launcher makes Panel Assistant the Android Home app and keeps it so, restoring it if something else takes over. If you later hand the panel back to its own launcher, Panel Assistant clears this setting first.

Caution

If you disable vendor packages, do not disable the launcher you choose here.

Related: Vendor packages

Network ADB

Advanced · Default off · Home Assistant switch · network_adb

Security risk: keeps classic ADB listening on TCP port 5555 across boots and reconnects.

Enable only during active maintenance on a trusted network. If ADB was enabled outside Panel Assistant, it must also be disabled there.

Camera

Camera

Basic · Default off · camera_enabled

Off by default. Serves RTSP video with room audio where a microphone is available and permitted, and JPEG snapshots for Home Assistant. Capture starts only when a client requests media, and the panel shows a red light while the camera is open.

Resolution

Basic · camera_resolution

What a stream gets when its URL does not ask for something else. A stream URL can override it with ?res=, in either direction.

Frame rate

Advanced · Default 15 · 1 to 30 · camera_fps

What a stream gets when its URL does not ask for something else. A stream URL can override it with ?fps=, in either direction.

Bitrate (kbps)

Advanced · Default 2000 · 250 to 8000 · camera_kbps

What a stream gets when its URL does not ask for something else. A stream URL can override it with ?kbps=, in either direction.

Exposure

Advanced · Default 0 · -2 to 2 · camera_exposure

Exposure bias in stops, for a camera that reads a room darker or brighter than it looks. 0 leaves the camera’s own automatic exposure alone; the panel clamps this to whatever range the sensor actually supports.

Voice

Voice assistant

Basic · Default off · voice_enabled

Wake words

Basic · voice_wake_words

The wake words to listen for: the bundled Okay Nabu, Hey Jarvis, Hey Mycroft and Alexa, and any you import below.

Wake word pipelines

Advanced · voice_pipelines

Which Home Assistant Assist pipeline each wake word runs. A wake word left on the preferred pipeline follows whichever pipeline Home Assistant prefers.

Audio source

Advanced · voice_audio_source

Wake sensitivity

Advanced · voice_sensitivity

Wake-word detector threshold, applied as an offset to the model’s cutoff score.

• Low requires a clearer match: fewer false wakes, more likely to miss a quiet or distant call.
• Normal applies no offset.
• High matches more readily: faster to wake, more false triggers.

Microphone gain (dB)

Advanced · Default 0 · voice_mic_gain_db

Amplifies the audio sent to Home Assistant for transcription.

These panels expose no platform noise suppression or automatic gain control, so a panel heard from across the room may wake reliably and still transcribe poorly: wake-word detection adapts to a quiet signal on its own and speech-to-text does not.

Raise this if commands are missed or mistranscribed while the wake word works. Wake-word detection is deliberately left on the unamplified signal.

Stop word

Advanced · Default on · voice_stop_word

Logging

Ship logs

Advanced · Default off · log_ship_enabled

Forward Panel Assistant’s own process log — not the full system log — to a central sink (LAN-only, tokens and passwords redacted).

Ship system logs

Advanced · Default off · log_ship_system_enabled

Forward Android system logs to the same sink when Ship logs is on.

• Off by default.
• Requires TCP or HTTP, and root or the installed helper.
• Entries are redacted; high-volume output may be dropped.

Sink host

Advanced · log_ship_host

Log-collector host; blank keeps shipping inert. A scheme or :port here is honoured (udp://collector, collector:1514).

Sink port

Advanced · Default 514 · 1 to 65535 · log_ship_port

Protocol

Advanced · log_ship_protocol

TCP is the default because it reports a sink that is refusing or unreachable; UDP cannot, so a wrong setting there fails silently. Port 514 serves both.

Sensors

Screen brightness

Basic · Home Assistant light · screen

Current screen state and brightness. Home Assistant presents the light’s native 0–255 brightness as a percentage.

Panel volume

Advanced · Home Assistant number · volume

Current panel media volume reported on its native 0–100 percent scale.

Ambient light

Basic · Home Assistant sensor · illuminance

Proximity

Basic · Home Assistant binary sensor · proximity

Proximity level

Basic · Home Assistant sensor · proximity_level

Normalized learned proximity level from 0 to 100 percent; binary sources report 0 or 100.

Auto-sleep activity

Advanced · Home Assistant binary sensor · auto_sleep_activity

Whether the auto-sleep policy is currently holding the panel awake. The Home Assistant entity provides the activity history timeline.

Temperature

Basic · Home Assistant sensor · temperature

Humidity

Basic · Home Assistant sensor · humidity

Room temperature

Advanced · Home Assistant sensor · room_temp

Room air temperature from the panel’s supported climate sensor (calibration offset applied).

Room humidity

Advanced · Home Assistant sensor · room_humidity

Room temperature offset

Advanced · Default 0 · -20 to 20 · room_temp_offset

Correction (°C) added to the reported room temperature — usually negative, since panel self-heating reads high. Per-panel (depends on mounting), so not cloned by a fleet push.

Diagnostics

IP address

Basic · Home Assistant sensor · diag_ip

CPU usage

Basic · Home Assistant sensor · diag_cpu

Overall CPU busy percentage (root/su panels; unavailable on sandbox-walled panels).

Memory usage

Basic · Home Assistant sensor · diag_memory

SoC temperature

Basic · Home Assistant sensor · diag_soc_temp

System-on-chip temperature (root/su panels; unavailable on sandbox-walled panels).

Last boot time

Advanced · Home Assistant sensor · diag_boot

When the panel last booted (a timestamp — HA shows the elapsed uptime).

Wi-Fi network

Advanced · Home Assistant sensor · diag_wifi_ssid

Current Wi-Fi network name while Wi-Fi is the active connection. This can identify a location and enters HA history when exposed; Android may hide it unless network-information permission is available.

Wi-Fi signal strength

Advanced · diag_wifi_rssi

Current Wi-Fi received signal strength in dBm while Wi-Fi is the active connection.

Wi-Fi outages (24 h)

Advanced · diag_wifi_outages_24h

Short Wi-Fi dropouts in the rolling last 24 hours. Counts loss of the panel’s active Wi-Fi connection only — Home Assistant outages are never counted. If the panel had to cap what it stores, the sensor’s is_lower_bound attribute says the value is a floor.