Back to all devices

HOBEIAN ZG-IR01 in Home Assistant

Buttons & remotes · Zigbee · Smart IR remote switch

Zigbee2MQTT Quirk proposed, not merged yet 2 open reports

Zigbee device – see the note above on what ZHA needs for it.

Brand: HOBEIAN
Model: ZG-IR01
Device type: Buttons & remotes
Radio: Zigbee
Power: Battery
Reports itself as: ZG-IR01
Zigbee2MQTT: Device page on zigbee2mqtt.io

How the device gets into Home Assistant

official ZHA – with a Zigbee coordinator and the ZHA integration; for all its functions it needs a custom quirk, see above. Integration
add-on Zigbee2MQTT – Zigbee2MQTT runs as an add-on and passes the device on to Home Assistant over MQTT. Integration · Source

Known problems and fixes

Open problems

open The HOBEIAN Zigbee IR blaster is not supported in Home Assistant. The issue requests adding a quirk to enable IR control through the app. since June 30, 2026 · zha-device-handlers #5133

Requests for ZHA support

support requested A request asks for support for the YH002-ZB blind motor, which is not currently working with ZHA, preventing users from controlling it through Home Assistant. since October 11, 2026 · zha-device-handlers #5446

Changes proposed for ZHA

pull request A HOBEIAN IR blaster is not yet supported. The proposed change would allow ZHA to control devices via this IR blaster. since September 25, 2026 · zha-device-handlers #5376

ZHA quirks for this device

Quirk proposed, not merged yet Recommended quirk

Proposed to ZHA and waiting for review – the maintainers check it before it becomes part of Home Assistant.

Source: zha-device-handlers · pull request #5376 · by @emrikol · September 25, 2026
Signature: HOBEIAN / ZG-IR01

The quirk is not part of ZHA yet. You can use it as a custom quirk until it is:

Tell ZHA where custom quirks are kept – in configuration.yaml:
```
zha:
  custom_quirks_path: /config/custom_zha_quirks/
```
Create that folder and save the quirk as a .py file in it.
Restart Home Assistant. If the device was paired before, reconfigure it or remove and pair it again so the quirk is applied.
Check it worked: the device page shows the quirk under Zigbee info.

A custom quirk has not been reviewed by the ZHA maintainers. Delete the file once the quirk is part of a Home Assistant release – otherwise the old copy takes precedence.

All quirks in the ZHA quirk database →

Alternatives

The same job from other makers – devices of the same type and radio that work with Home Assistant too.

Nedis ZBRC10WT Buttons & remotes · Zigbee, Wi-Fi · Security remote control Zigbee2MQTT Tuya Local (HACS) Custom quirk needed Review
Aqara WXKG11LM Buttons & remotes · Zigbee · Wireless mini switch Zigbee2MQTT ZHA quirk 3 open reports Review
Philips 929003017102 Buttons & remotes · Zigbee · Hue wall switch module Zigbee2MQTT ZHA quirk 3 open reports Review
Innr RC 250 Buttons & remotes · Zigbee · Remote control Zigbee2MQTT 1 open report Review

Sources: Zigbee2MQTT, ZHA quirks, Z-Wave JS, the Matter certification database, Shelly, ESPHome, Tasmota, Tuya Local and the issue trackers on GitHub. Reports are assigned to a device by the identifiers they contain; the sentences come from the integration pages, where a language model writes them from the titles.