matterbridge-govee-lan

A Matterbridge plugin that exposes compatible Govee lights to Matter controllers by using Govee's local LAN Control protocol. No Govee cloud account, API key, or internet connection is required after LAN Control is enabled.

Features

• Automatic discovery using Govee multicast and IPv4 broadcast.
• On/off, brightness, RGB color, and color temperature.
• Periodic state synchronization.
• Multiple devices, include/exclude lists, and custom device names.
• Local-only communication over UDP.

The first tested model is Govee H6046. Other Govee models that implement the same LAN Control commands may work, but should be reported as tested before being listed here.

Requirements

• Matterbridge 3.10.0 or newer.
• A Govee device with LAN Control enabled in the Govee Home app.
• Matterbridge and the Govee device on the same IPv4 LAN.
• UDP ports 4001, 4002, and 4003 available on the Matterbridge host.

Only one application on a host can normally listen for Govee responses on UDP port 4002. Stop other Govee LAN integrations on the same host if discovery cannot start.

Installation

In the Matterbridge frontend, open Plugins, search for matterbridge-govee-lan, and select Install. Restart Matterbridge when prompted.

Or install from a terminal:

npm install -g matterbridge-govee-lan

Configuration

The default configuration discovers all compatible devices automatically:

{
  "name": "matterbridge-govee-lan",
  "type": "DynamicPlatform",
  "whiteList": [],
  "blackList": [],
  "names": {},
  "broadcastAddresses": [],
  "discoveryInterval": 300,
  "statusInterval": 30,
  "debug": false,
  "unregisterOnShutdown": false
}

Custom names can use either the Govee LAN device ID or its IP address:

"names": {
  "44:88:AA:BB:CC:DD:EE:FF": "TV LEDs",
  "192.168.1.20": "Desk lamp"
}

If your router blocks multicast, the plugin also calculates the subnet broadcast automatically. broadcastAddresses can add another explicit IPv4 broadcast address when needed.

Privacy and limitations

The plugin does not request or store Govee credentials. LAN Control supports the basic light controls above, but not DreamView, scenes, music modes, or per-segment effects.

This community project is not affiliated with or endorsed by Govee.

License

Apache-2.0