Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/oznu/homebridge-config-ui-x
The Homebridge UI. Monitor, configure and backup Homebridge from a browser.
https://github.com/oznu/homebridge-config-ui-x
gui hb-service homebridge homebridge-plugin homebridge-server homebridge-webserver smart-home supervisor ui web-interface
Last synced: about 2 months ago
JSON representation
The Homebridge UI. Monitor, configure and backup Homebridge from a browser.
- Host: GitHub
- URL: https://github.com/oznu/homebridge-config-ui-x
- Owner: homebridge
- License: mit
- Created: 2017-12-21T04:20:54.000Z (almost 7 years ago)
- Default Branch: latest
- Last Pushed: 2024-04-13T18:31:28.000Z (5 months ago)
- Last Synced: 2024-04-14T01:00:08.878Z (5 months ago)
- Topics: gui, hb-service, homebridge, homebridge-plugin, homebridge-server, homebridge-webserver, smart-home, supervisor, ui, web-interface
- Language: TypeScript
- Homepage: https://homebridge.io
- Size: 47.5 MB
- Stars: 2,573
- Watchers: 71
- Forks: 365
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Security: .github/SECURITY.md
Awesome Lists containing this project
- awesome-homebridge - Config-UI-X
README
# Homebridge UI
[](https://www.npmjs.com/package/homebridge-config-ui-x)
[](https://www.npmjs.com/package/homebridge-config-ui-x)
[](https://discord.gg/C87Pvq3)
[](https://paypal.me/oznu)
:gb: :de: :fr: :poland: :czech_republic: :ru: :cn: :hungary: :jp: :es: :netherlands: :tr: :it: :bulgaria: :sweden: :norway: :slovenia: :brazil: :portugal: :indonesia: :kr: :macedonia: :thailand: :israel: :ukraine:
**Homebridge UI** is a web based management tool for [Homebridge](https://github.com/homebridge/homebridge) that allows you to manage all aspects of your Homebridge setup.
* Install and configure Homebridge plugins
* Edit the Homebridge `config.json` with advanced JSON syntax checking and structure validation
* Visual configuration for over 450 plugins (no manual config.json editing required)
* Monitor your Homebridge server via a fully customisable widget-based dashboard
* View the Homebridge logs
* View and control Homebridge accessories
* Restart Homebridge
* Backup and Restore your Homebridge instance
* Set up and manage your Homebridge plugins as [child bridges](https://github.com/homebridge/homebridge/wiki/Child-Bridges)
* and more...
Homebridge UI also provides a tool called [`hb-service`](https://github.com/homebridge/homebridge-config-ui-x/wiki/Homebridge-Service-Command) which makes it easy to set up Homebridge as a service on Linux/Raspbian, macOS and Windows 10.
[](#usage)
## Installation Instructions
For detailed instructions on how to set up Node.js and Homebridge with Homebridge UI as a service, see the guides on the wiki:
* 
[Setup Homebridge using the official Homebridge Raspberry Pi Image](https://github.com/homebridge/homebridge-raspbian-image/wiki/Getting-Started)
* 
[Setup Homebridge on a Raspberry Pi (Raspbian)](https://github.com/homebridge/homebridge/wiki/Install-Homebridge-on-Raspbian)
* 
[Setup Homebridge on Debian or Ubuntu Linux](https://github.com/homebridge/homebridge/wiki/Install-Homebridge-on-Debian-or-Ubuntu-Linux)
* 
[Setup Homebridge on Windows 10](https://github.com/homebridge/homebridge/wiki/Install-Homebridge-on-Windows-10)
* 
[Setup Homebridge on macOS](https://github.com/homebridge/homebridge/wiki/Install-Homebridge-on-macOS)
* 
[Setup Homebridge using Docker](https://github.com/homebridge/homebridge/wiki/Install-Homebridge-on-Docker)
* 
[Setup Homebridge on a Synology NAS](https://github.com/homebridge/homebridge/wiki/Install-Homebridge-on-Synology-DSM)
If your platform is not listed above, or you want to use your own service manager, see the [Manual Configuration](https://github.com/homebridge/homebridge-config-ui-x/wiki/Manual-Configuration) wiki article for instructions on setting up the Homebridge UI to run as a Homebridge plugin instead of a service.
The default username is `admin` and the default password is `admin`.
The UI can be accessed via web browser by default on port `8581` (e.g. `http://localhost:8581`).
## Usage
### Status Screen
This shows an overview of your Homebridge system. The dashboard is widget-based and completely customisable with a number of themes available.
### Plugin Screen
This shows you the currently installed plugins and allows you to install, remove and upgrade plugins.
You can configure supported plugins using the graphical settings editor, removing the need to manually edit the `config.json`. Over 165 popular plugins have implemented support for this feature.
### Configuration Screen
The configuration screen allows you to modify your Homebridge `config.json`. The built-in editor automatically syntax-checks your JSON and makes a backup of your config every time you make a change.
### Log Screen
This shows you the Homebridge rolling log. This is helpful for troubleshooting.
### Accessories Screen
This shows you the Homebridge accessories for all the Homebridge instances on your network. You can use this to control accessories from a web browser and works well on mobile devices which allows users to control Homebridge from non-Apple devices.
## Supported Browsers
The following browsers are supported by the Homebridge UI:
* Chrome - latest
* Edge - latest
* Firefox - latest
* Safari - 2 most recent major versions
* iOS - 2 most recent major versions
MS Internet Explorer (any version) is not supported!
## Supported Node.js Version
The Homebridge UI follows the same Node.js support schedule as Homebridge. See the [How-To-Update-Node.js](https://github.com/homebridge/homebridge/wiki/How-To-Update-Node.js) page in the Homebridge wiki for currently supported versions.
You can check your current versions using these commands:
```shell
# check node version
node -v
# check npm version
npm -v
```
## Plugin Development
The https://developers.homebridge.io website contains the Homebridge API reference, available service and characteristic types, and plugin examples.
The [Homebridge Plugin Template](https://github.com/homebridge/homebridge-plugin-template) project provides a base you can use to create your own *platform* plugin.
There are many existing plugins you can study; you might start with the [Homebridge Example Plugins](https://github.com/homebridge/homebridge-examples) or a plugin that already implements the device type you need.
## Common Issues
### Errors during installation
Make sure you installed the package with `sudo` and used the `--unsafe-perm` flag. Most installation errors can be fixed by removing the Homebridge UI and reinstalling:
```shell
# cleanup
sudo npm uninstall -g homebridge-config-ui-x
# reinstall
sudo npm install -g --unsafe-perm homebridge-config-ui-x
```
Make sure you are running [supported versions of node and npm](#supported-nodejs-and-npm-versions).
### Home App Says Accessory Already Added
To fix this, [Reset Homebridge](https://github.com/homebridge/homebridge/wiki/Connecting-Homebridge-To-HomeKit#how-to-reset-homebridge).
### My iOS App Can't Find Homebridge
Try the following:
1. Swap between the `Bonjour HAP` and `Ciao` mDNS Advertiser options. See [the wiki](https://github.com/homebridge/homebridge/wiki/mDNS-Options) for more details.
2. iOS DNS cache has gone stale or gotten misconfigured. To fix this, turn airplane mode on and back off to flush the DNS cache.
## Community
The official Homebridge Discord server and Reddit community are where users can discuss Homebridge and ask for help.
[](https://discord.gg/kqNCe2D) [](https://www.reddit.com/r/homebridge/)
HomeKit communities can also be found on both [Discord](https://discord.gg/RcV7fa8) and [Reddit](https://www.reddit.com/r/homekit).
## Limitations
* One bridge can only expose 150 accessories due to a HomeKit limit. You can however run your plugins as a [Child Bridge](https://github.com/homebridge/homebridge/wiki/Child-Bridges) or run [Multiple Homebridge Instances](https://github.com/oznu/homebridge-config-ui-x/wiki/Homebridge-Service-Command#multiple-instances) to get around this limitation.
* Once an accessory has been added to the Home app, changing its name via Homebridge won't be automatically reflected in iOS. You must change it via the Home app as well.
## Credits
- Homebridge was originally created by [Nick Farina](https://twitter.com/nfarina).
- The original HomeKit API work was done by [Khaos Tian](https://twitter.com/khaost) in his [HAP-NodeJS](https://github.com/homebridge/HAP-NodeJS) project.
- Homebridge UI was originally created by [oznu](https://github.com/oznu).