homebridge-config-ui-x

Homebridge UI

:gb: :de: :fr: :poland: :czech_republic: :ru: :cn: :hungary: :jp: :es: :netherlands: :tr: :it: :bulgaria: :sweden: :norway: :finland: :slovenia: :brazil: :portugal: :indonesia: :kr: :macedonia: :thailand: :israel: :ukraine:

Homebridge UI is a web based management tool for 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
• and more...

Homebridge UI also provides a tool called hb-service which makes it easy to set up Homebridge as a service on Linux/Raspbian, macOS and Windows 10.

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
• Setup Homebridge on a Raspberry Pi (Raspbian)
• Setup Homebridge on Debian or Ubuntu Linux
• Setup Homebridge on Windows 10
• Setup Homebridge on macOS
• Setup Homebridge using Docker
• Setup Homebridge on a Synology NAS

If your platform is not listed above, or you want to use your own service manager, see the 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, configure, update and remove plugins.

You can configure supported plugins using the graphical settings editor, or by editing the config JSON directly.

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.

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 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 or a plugin that already implements the device type you need.

Community

The official Homebridge Discord server and Reddit community are where users can discuss Homebridge and ask for help.

HomeKit communities can also be found on both Discord and Reddit.

Limitations

• One bridge can only expose 150 accessories due to a HomeKit limit. You can however run your plugins as a Child Bridge or run Multiple Homebridge 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.
• The original HomeKit API work was done by Khaos Tian in his HAP-NodeJS project.
• Homebridge UI was originally created by oznu.

Changelog

v4.63.0 (2024-11-17)

⚠️ Upcoming Deprecations:

• The next major version v5 of the Homebridge UI will drop support for:
  • Node.js v16 and earlier, so please update to v18 or v20 or v22 - more info on updating
  • Raspberry Pi devices running on the armv6 architecture (like the Pi 1 and Pi Zero) - please update your hardware
  • Instances using pnpm as the package manager - consider updating your Homebridge instance to use npm instead - more info on updating
• Note that these are not requirements for UI v4.63.0

UI Changes

• updates to the th.json language file (#2211) (@tomzt)
• updates to the nl.json language file (#2213) (@tooh)
• updates to the es.json language file (#2235) (@AxelDreemurr)
• updates to the fi.json language file (#2218, #2229) (@l1500s)
• fix widget config saving on dashboard
• use native language for validation messages where available
  • currently available for de en es fr it pt zh
• switch from a top menu to a sidebar menu
• show pairing status for bridges around the ui
• consistent labels for sensor-type accessories
• update default dashboard layout
• remove pnpm warning modal
• use smoke detector icon for carbon monoxide and dioxide sensors

Other Changes

• migrate @zajsf/* to @ng-formworks/* for plugin schema forms
• check for service mode when querying child bridge status
• perform a full restart when updating homebridge

Homebridge Dependencies

• @homebridge/hap-client @ v1.10.2
• @homebridge/node-pty-prebuilt-multiarch @ v0.11.14
• @homebridge/plugin-ui-utils @ v1.0.3