ha-paneld
0.9.9 · GitHub
More about this app
Home Assistant wall-panel dashboard with entity filtering, MQTT device controls and Shizuku/root-powered provisioning and verified installs.
Home Assistant, on the wall, done properly.
The Panel Assistant app for Android wall panels: your Home Assistant dashboard on the wall, the panel's screen, sensors and buttons as Home Assistant entities, and an Assist voice satellite on panels with a microphone.
It runs on ARM wall panels with Android 8.0 or newer and debugging access, from Sonoff (NSPanel Pro), Shelly, Tuya, Meta, Electron and Smatek, and on any other panel that meets those requirements. You do not install it yourself: the Panel Assistant integration installs it from Home Assistant, over the network or over USB from your browser, and delivers every update.
Everything happens in Home Assistant
- Install, update and repair from Home Assistant. You add a panel from Settings, update it from its update entity, and put problems right from the Repairs Home Assistant raises, which name the panel and say what to do.
- Nothing to install on your computer. No Android developer tools and no command line. A USB install runs from Home Assistant in Chrome or Edge, and a network install needs only the panel's address. The one step on the panel itself is switching on debugging in its own Settings; the hardware page for your model says where that switch is. Two vendor limits remain: some Sonoff NSPanel Pro firmware hides the switch, and a Tuya TPA10 needs its WebView replaced once by hand; both can still call for a computer.
- Repeatable results. An interrupted install is safe to run again: it checks what already happened on the panel before it changes anything, and carries on from there. Every update arrives the same way, through Panel Assistant, which backs up the panel's settings first and confirms the panel came back healthy.
Get started: add Panel Assistant to Home Assistant through HACS, then follow Getting started. Choose a panel says what to expect from each model, and Updates and recovery covers what happens if an installation stops.
Development
This repository contains the Android app, its root helper and developer tooling. Start with CONTRIBUTING.md.
- Building from source and local development.
- Control and Home Assistant reference: the panel's entities, its pages and endpoints, and the deprecated REST API.
- Panel-profile development, with example and community profiles.
- Browser test harness.
- Root-helper protocol and development.
- Release process and changelog.
- Security policy.
Licence
Apache-2.0. See LICENSE.
How Shizuku is used
Can take screenshots, simulate taps and keys, adjust display density and text size, read room climate and install verified apps via `Shizuku UserService`.
This is an AI-assisted analysis of Shizuku-related usages in the app's public source code. It is best effort, so it may not catch every single usage.
How this app uses Shizuku
Shizuku runs a privileged helper that performs fixed device operations for this wall panel dashboard.
- Capture screenshots: take a panel screenshot for dashboard previews and for tap then capture verification, using the system screenshot tool through Shizuku.
- Simulate taps: tap at chosen screen coordinates for remote control from the panel server, using the system input tool through Shizuku.
- Press system keys: send Back and Recents key presses for navigation and remote control actions, using the system input tool through Shizuku.
- Adjust display density: read the current density and set, apply recommended or reset the density override so the dashboard layout matches the screen, using the
wm densitycommand through Shizuku. - Adjust text size: read the current font scale and set, apply recommended or restore the system font scale so text matches the chosen size, using system settings commands through Shizuku.
- Read room climate: report room temperature and humidity from attached input sensors for sensors and diagnostics through Shizuku.
- Install verified apps: install downloaded updates for the panel app itself and curated companion apps after package and signer verification, using a streamed package install through Shizuku.
Android APIs or commands used
screencap -pinput keyeventinput tapwm densitysettings get system font_scalesettings put system font_scalesettings delete system font_scalegetevent -lp/proc/bus/input/devicespm install
Notable details
Installs through Shizuku are not generic: only explicitly allowed packages proceed after package name and certificate checks. The privileged helper accepts only typed values such as key codes, coordinates, density and font scale, with no generic command runner.
Changelog
What's new for version 0.9.9
Installation
Install and update ha-paneld through the Panel Assistant integration for Home Assistant: add a panel from Settings, Devices & services, and Panel Assistant installs the right app for it. The files attached to this release are for Panel Assistant to use; they are not meant to be installed by hand.
This release finishes handing the running of your panels to Panel Assistant. It is the last ha-paneld release that supports MQTT and the last one that can move an MQTT panel over to Panel Assistant's own connection, so if your panels still use MQTT, please move them with this release. Updates now come only through Panel Assistant, and so does the move to the new app. Sorry, Sonoff NSPanel Pro owners: in 0.9.8 the panel moved itself and needed the root helper in a system partition that is full on some NSPanel Pros. If yours got stuck, refused to install, or Panel Assistant 0.6.3 told you "The release did not match its signature, so nothing was installed", that was my approach, not your panel, and you should never need Magisk or to delete anything from the system partition. Thank you to everyone who reported it and sent logs.
Pairs with Panel Assistant 0.7.0.
Moving off MQTT
Move now, while this release can still do it for you. Update the panel, add it to Panel Assistant, then choose Configure on the panel in Home Assistant and set Control to Panel Assistant. Panels that have used MQTT also get a Repair that does the same. MQTT still works in this release, but future feature releases need Panel Assistant and its connection, so MQTT set-ups will not get new features after this.
Moving from the old app
The panel app has a new Android app id, io.panelassistant.android. In 0.9.8 a panel tried to hand itself over to the new app. It no longer does. Panel Assistant moves each panel instead: open the panel's "Move to the new app" Repair under Settings, Repairs in Home Assistant, and one click backs the panel up, installs the new app over your network and carries its settings, identity and entities across. If the panel asks whether to allow USB debugging, tap Allow. The Repair also finishes panels caught halfway by an earlier attempt. Once the new app is running the panel, Panel Assistant removes the old app automatically.
Move before v1.0. Moving panels to the new app is supported through the 0.x releases only. v1.0 will not move panels, so please move yours before then.
New
- Voice assistant preview. Panels with a microphone can be a Home Assistant Assist satellite: turn on Voice assistant on the Configure page and pick your wake words. It works on the Sonoff NSPanel Pro, the Electron WF1589T and WF2489T, and the Shelly Wall Display X2i. It is an early preview and may change.
- Your panel's camera and speaker appear in Home Assistant. The camera is a native camera entity and the speaker is a media player with its volume, ready for announcements, all with no MQTT. Snapshot preferences carry over through backups and restores.
- Screen off when nobody touches it. Auto-sleep can now switch the screen off after a set time without a touch.
- A ceiling for automatic brightness. A new Maximum level setting under Display stops automatic brightness going brighter than you want, while it still dims as the room darkens. You can still turn it up by hand.
- One notice for Home Assistant restarts, on every screen. When Home Assistant restarts, updates or drops off, the dashboard and the panel's own screens show the same notice, with an estimate of how long it usually takes on your system. Panel Assistant tells the panel what Home Assistant is doing, so the panel no longer guesses.
Changed
- Updates come only through Panel Assistant. The app no longer updates itself. Home Assistant offers each panel's update, and the panel takes its update channel and pre-release choice from Panel Assistant. Each build a panel is offered carries its own signed description, so an offer cannot point at the wrong file.
Improved
- A shorter, easier Configure page. Every setting has a one-line summary, the basics show first, and the full help opens from an info button. You can type any value in range, not just the arrow steps, and when the panel refuses a setting, including an auto-sleep source it cannot use, Configure tells you why.
- The web interface works on a phone in every language. Every tab, card and dialog fits a portrait phone screen, and the language you choose wins in the Panel Assistant sidebar.
- Reconnects when Home Assistant's address changes. The panel can fall back to other trusted addresses for your Home Assistant and tells Panel Assistant its current network addresses.
- The Shelly Wall Display X2i profile covers firmware 2.7.4, the version new owners receive.
Fixed
- Back to the dashboard after a restart or update. The panel takes back the home screen when it starts instead of leaving Android's fallback screen up, a sleeping screen stays asleep, and the navigation bar comes back reliably with your latest setting.
- On Shelly Wall Display panels, Launcher and Back stay out of Shelly's home screen. Launcher opens the Android launcher, and Back no longer drops you out of the dashboard.
- A wake tap no longer also presses whatever is under your finger.
- Network debugging comes back on its own when the app has it switched on and nothing is listening on its port any more, so Home Assistant can keep updating the panel.
- Installs finish on Sonoff NSPanel Pro panels with no room for the root helper. The app can use root by itself there, so the installer warns and finishes without the helper. Full system storage is no longer reported as read-only, a freshly installed helper is used straight away, and the installer will not put the new app beside an old one whose data it cannot read; it stops and says why.
- A panel set up without MQTT no longer asks for MQTT.
- Panels on a fresh Home Assistant account find their dashboard.
- Missing permissions are put back when the app starts, and the camera stays available while Android is still listing cameras.
- Proximity setup gives up after 30 seconds when the sensor sends nothing, says what to check and keeps your previous calibration.
- A brightness you set by hand survives a restart until it would have expired anyway.
- A saved dashboard shown while offline says so, and the notice stays until the live connection returns.
- A button backlight that has never been set shows as off instead of unknown.
- Fewer stray connection warnings in the logs.
- Translation corrections from a review of every language against the English.
Permissions
20 permissions requested
Sources
2 sources
Sources
2 sources