Skip to content
Ben edited this page Nov 1, 2026 · 5 revisions

homebridge-smarthq

homebridge-smarthq

Homebridge plugin to integrate SmartHQ appliances into HomeKit

npm npm
verified-by-homebridge
npm Discord

Plugin Information

  • This plugin allows you to view and control your SmartHQ appliances within HomeKit. The plugin:
    • requires your SmartHQ account credentials to work
    • connects to the SmartHQ cloud to discover and control your appliances

Prerequisites

  • To use this plugin, you will need to already have:
    • Node: latest version of v22, v24 or v26 - any other major version is not supported.
    • Homebridge: v2 - refer to link for more information and installation instructions.

Setup

Supported Appliances

  • Dishwashers, including Fisher & Paykel DishDrawers
  • Ovens
  • Refrigerators, including a built-in Keurig K-Cup brewer
  • Opal Nugget Ice Makers
  • Air conditioners, including portable, split and through-the-wall units
  • Hoods
  • Clothes washers, clothes dryers and combination washer dryers
  • Water filters
  • Water softeners
  • Water heaters
  • Advantium ovens
  • Microwaves
  • Coffee and espresso makers
  • Beverage centers
  • Smokers
  • Induction cooktops

Features

  • HomeKit Controller notifications are supported for the Opal Ice Maker. To set up, install the HomeKit Controller app and configure notifications for each respective event. Put your HomeKit Controller client secret in the plugin advanced options, and the path associated with each available notification in the Opal device options. Supported events:
    • Ice Bucket Full
    • Production Progress Complete
    • Filter Maintenance Change Alert
    • Descale Needed Alert
    • Add Water Alert

Help/About

Credits

  • To @donavanbecker: the original creator and maintainer of this plugin.
  • To the creators/contributors of Homebridge who make this plugin possible.

Disclaimer

  • I am in no way affiliated with SmartHQ or GE Appliances and this plugin is a personal project that I maintain in my free time.
  • Use this plugin entirely at your own risk - please see licence for more information.

Clone this wiki locally