https://github.com/krobipd/iobroker.homeassistant-bridge
Home Assistant fake Server für IoBroker
https://github.com/krobipd/iobroker.homeassistant-bridge
homeassistant iobroker-adapter shelly smart-home vis wall-display
Last synced: 2 months ago
JSON representation
Home Assistant fake Server für IoBroker
- Host: GitHub
- URL: https://github.com/krobipd/iobroker.homeassistant-bridge
- Owner: krobipd
- License: mit
- Created: 2026-02-22T14:36:33.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-04-03T21:53:56.000Z (3 months ago)
- Last Synced: 2026-04-03T23:27:07.213Z (3 months ago)
- Topics: homeassistant, iobroker-adapter, shelly, smart-home, vis, wall-display
- Language: TypeScript
- Size: 588 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# ioBroker.homeassistant-bridge
[](https://www.npmjs.com/package/iobroker.homeassistant-bridge)
[](LICENSE)
[](https://www.npmjs.com/package/iobroker.homeassistant-bridge)
[](https://ko-fi.com/krobipd)
[](https://paypal.me/krobipd)
> ## ⚠️ Deprecated — please migrate to [ioBroker.hassemu](https://github.com/krobipd/ioBroker.hassemu)
>
> Development 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](https://github.com/krobipd/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](https://www.home-assistant.io) server so that devices like the [Shelly Wall Display XL](https://www.shelly.com) can be redirected to any custom web URL — without running a real Home Assistant Core.
---
## Features
- **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
---
## Requirements
- **Node.js >= 20**
- **ioBroker js-controller >= 7.0.0**
- **ioBroker Admin >= 7.6.20**
---
## Ports
| Port | Protocol | Purpose | Configurable |
|------|----------|---------|--------------|
| 8123 | TCP/HTTP | Home Assistant emulation (Shelly requires exactly this port) | No — fixed |
---
## Configuration
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!
---
## State Tree
```
homeassistant-bridge.0.
└── info.connection — Server is running (bool)
```
---
## Troubleshooting
### Display cannot find the server (mDNS)
The adapter broadcasts a `_home-assistant._tcp` mDNS service. If the display does not find the server automatically, configure it manually:
```
IP:
Port: 8123
```
1. Check if the adapter log shows "mDNS: Broadcasting" on startup.
2. Verify the service is visible on the network:
```bash
# macOS
dns-sd -B _home-assistant._tcp
# Linux (if avahi-utils installed)
avahi-browse _home-assistant._tcp -r -t
```
3. Make sure mDNS port 5353/UDP is not blocked by a firewall.
4. If mDNS doesn't work, use manual configuration on the display with the ioBroker server's IP address.
### Health Check
The adapter provides a health endpoint:
```
http://:8123/health
```
---
## Changelog
### 0.9.3 (2026-04-08)
- Restore standard GitHub-based tests, remove CHANGELOG.md
### 0.9.2 (2026-04-05)
- Compact startup log (single info line instead of three)
- Move mDNS and web server detail logs to debug level
### 0.9.1 (2026-04-05)
- Fix UUID inconsistency between WebServer and mDNS (now shared)
- Remove redundant scripts
### 0.9.0 (2026-04-04)
- Replace Avahi mDNS with bonjour-service for cross-platform support (Linux, macOS, Windows)
### 0.8.12 (2026-04-03)
- Modernize dev tooling (esbuild, TypeScript 5.9 pin, testing-action-check v2)
Older changelog: [CHANGELOG_OLD.md](CHANGELOG_OLD.md)
---
## Support
- [ioBroker Forum](https://forum.iobroker.net/)
- [GitHub Issues](https://github.com/krobipd/ioBroker.homeassistant-bridge/issues)
### Support Development
This adapter is free and open source. If you find it useful, consider buying me a coffee:
[](https://ko-fi.com/krobipd)
[](https://paypal.me/krobipd)
---
## License
MIT License
Copyright (c) 2026 krobi
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*