⚠️ Deprecated — please migrate to ioBroker.hassemuDevelopment of this adapter has moved to hassemu under a clearer name. ioBroker.hassemu provides the same Home Assistant emulation for Shelly Wall Displays plus active maintenance. This adapter receives no further updates.
Veraltet — bitte zu ioBroker.hassemu wechseln. Die Weiterentwicklung läuft unter dem klareren Namen hassemu. Gleiche Home-Assistant-Emulation für Shelly Wall Displays, dort aktiv gepflegt. Dieser Adapter bekommt keine weiteren Updates.
Emulates a minimal Home Assistant server so that devices like the Shelly Wall Display XL can be redirected to any custom web URL — without running a real Home Assistant Core.
- Home Assistant Emulation — minimal HA API compatible with Shelly Wall Display XL
- mDNS Discovery — automatic detection via
_home-assistant._tcp(cross-platform) - OAuth2-like Auth Flow — full login flow emulation, optional credential validation
- Flexible Redirect — send the display to any ioBroker VIS, VIS-2, or custom web URL
- Modern Admin UI — JSON-Config for easy configuration
- Node.js >= 20
- ioBroker js-controller >= 7.0.0
- ioBroker Admin >= 7.6.20
| Port | Protocol | Purpose | Configurable |
|---|---|---|---|
| 8123 | TCP/HTTP | Home Assistant emulation (Shelly requires exactly this port) | No — fixed |
Configuration is done via the Admin UI (jsonConfig):
| Option | Description | Default |
|---|---|---|
| Bind to Interface | Network interface to listen on | 0.0.0.0 (all) |
| Redirect URL | Target URL for the display (e.g., VIS) | must be set |
| mDNS Enabled | mDNS Service Discovery | enabled |
| Service Name | Name in the network | "ioBroker" |
| Auth Required | Validate credentials | disabled |
| Username | Login name (if auth enabled) | "admin" |
| Password | Login password (stored encrypted) | - |
Important: Port 8123 is mandatory. The adapter always listens on port 8123 — this is hardcoded and cannot be changed. Shelly displays and other Home Assistant-compatible devices expect exactly this port. Make sure port 8123 is not already in use on your ioBroker server.
Important: The redirect URL must be a network-accessible address, e.g.:
http://192.168.1.100:8082/vis/index.html
localhost will not work because the display calls the URL!
homeassistant-bridge.0.
└── info.connection — Server is running (bool)
The adapter broadcasts a _home-assistant._tcp mDNS service. If the display does not find the server automatically, configure it manually:
IP: <ioBroker-IP>
Port: 8123
-
Check if the adapter log shows "mDNS: Broadcasting" on startup.
-
Verify the service is visible on the network:
# macOS dns-sd -B _home-assistant._tcp # Linux (if avahi-utils installed) avahi-browse _home-assistant._tcp -r -t
-
Make sure mDNS port 5353/UDP is not blocked by a firewall.
-
If mDNS doesn't work, use manual configuration on the display with the ioBroker server's IP address.
The adapter provides a health endpoint:
http://<IP>:8123/health
- Restore standard GitHub-based tests, remove CHANGELOG.md
- Compact startup log (single info line instead of three)
- Move mDNS and web server detail logs to debug level
- Fix UUID inconsistency between WebServer and mDNS (now shared)
- Remove redundant scripts
- Replace Avahi mDNS with bonjour-service for cross-platform support (Linux, macOS, Windows)
- Modernize dev tooling (esbuild, TypeScript 5.9 pin, testing-action-check v2)
Older changelog: CHANGELOG_OLD.md
This adapter is free and open source. If you find it useful, consider buying me a coffee:
MIT License
Copyright (c) 2026 krobi krobi@power-dreams.com
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Developed with assistance from Claude.ai
