Matter  

Developer: Simon's Plugins
Category: Hubs and Protocol Bridges
Github: Github Repo
License: MIT License
Assistance: Get help!   
Plugin ID: com.simons-plugins.indigo-matter
Latest release: v2026.26.0 released on Aug. 23, 2026
Release downloaded: 5 times
Requires: Indigo v2024.2.0 or higher
(Check the Releases tab below for older releases that may have different requirements)
  Download release v2026.4.2

indigo-matter

Matter device support for the Indigo home automation server — in both directions.

Matter in (the controller). Add Matter devices from the Domio iOS app or the plugin's own menu; control them as first-class Indigo devices (triggers, schedules, action groups, control pages, API). The plugin manages a matter-server instance, holds the Indigo-owned Matter fabric, translates Matter clusters ↔ Indigo device types, and owns runtime control for each device's lifetime.

Matter out (the bridge). Publish selected Indigo devices — Z-Wave, Insteon, Zigbee, MQTT, anything with a device record — outward as Matter accessories, so Apple Home can see and control them locally. Opt-in per device, nothing exported by default, from a second managed process. Apple Home is validated end-to-end. Alexa pairs and controls too, with a known caveat: newly-exported accessories can show stale/unresponsive in Alexa for some minutes before converging (issue #143). Google Home and SmartThings remain untested and unclaimed. See Exporting Indigo devices.

This is an independent, uncertified implementation. It is not certified by the Connectivity Standards Alliance (CSA), and is not affiliated with or endorsed by them. It works, and is validated against real hardware — but it carries none of the interoperability guarantees that come with a certified Matter controller. See Trademarks and certification.

Domio (iOS) ─┐
             ├── setup code ──▶ indigo-matter ──WebSocket──▶ matter-server ──IP──▶ Wi-Fi + Thread devices
plugin menu ─┘                       │
                                     └──WebSocket──▶ bridge node ──Matter──▶ Apple Home
                                        (export, opt-in)

Adding devices

The two entry points are equivalent, for Wi-Fi and Thread alike. There are three ways a device reaches one of them:

  • Share model — the usual path. An ecosystem you already own (Apple Home, Alexa, Google Home) does the out-of-box Bluetooth onboarding: the one step a headless Mac can't, since matter-server runs without BLE. The device is then shared to Indigo over plain IP, and the plugin joins as a second admin.
  • Factory-fresh Thread, via Domio — iOS commissions the device to the iPhone as part of that flow, which is what supplies the Thread credentials.
  • Already on your network, never commissioned — its printed code works directly, from either entry point.

Exporting Indigo devices (Matter out)

The plugin can also wear the Matter device role: a set of Indigo devices you choose is published as accessories on a Matter bridge that Apple Home commissions like any other accessory. One bridge, one pairing, however many devices.

  • Opt-in per device, default empty. A fresh install exports nothing, pairs nothing and runs no bridge process. Exporting is publishing — the device becomes operable from every ecosystem the bridge is paired with — so it is always a deliberate act.
  • You declare what each device is. Indigo cannot tell a plug from a lamp from a lock, so the export dialog asks, and suggests a role from the device's name. Relays, dimmers, colour and colour-temperature lights, window coverings, locks, thermostats and twelve sensor types — occupancy (PIR/motion), contact, water leak, freeze, rain, smoke, carbon monoxide, temperature, humidity, light, pressure and flow — are supported. Valves, fans, garage doors, sprinklers, heat alarms and MultiIO are not, and appear in the picker with the reason.
  • Devices whose plugin keeps the reading in a state of its own can be exported too. Alarm-panel zones are the common case: every zone is a "custom" device with no on/off flag Indigo can read, so the dialog asks which of its states is the reading. Map the first zone of a panel and the rest pre-select the same state. Only on/off states can be mapped in this version.
  • Expect an "uncertified accessory" prompt and choose Add Anyway. The bridge presents a development attestation certificate — as Homebridge, matterbridge and Home Assistant's bridge all do — and outbound attestation is the commissioning ecosystem's policy, not something this plugin can change.
  • Apple Home and Alexa validated; Google Home and SmartThings untested. Apple Home works end-to-end. Alexa pairs and controls too, with a known caveat: newly-exported accessories can show stale/unresponsive in Alexa for some minutes before converging (issue #143). Google Home and SmartThings remain untested and unclaimed; nothing here says they will or won't work.
  • A second npm package (indigo-matter-bridge), on the npm registry and installed from its own menu item.

Setup, pairing, recovery and troubleshooting: full install guide. How it works and what it can represent: MATTER.md → Indigo as a Matter bridge, or the typeset version: Field Notes № 3 → The bridge.

Status

Matter in — built and live-validated, including with real hardware. The full device-class catalogue is shipped — lighting (on/off/dimmer/colour), sensors, thermostats, fans, window coverings, locks, valves, buttons, smoke/CO, air quality, energy metering, battery levels, and bridges — plus failure hardening, fabric backup/restore, and a managed launchd LaunchAgent for matter-server. A real Tapo energy plug has been commissioned end-to-end through Domio and reports live power/energy to Indigo.

Validated with both Wi-Fi and Thread devices, and from both entry points — Domio and the plugin's own commission-by-setup-code menu. Thread provisioning is done by a device with a BLE radio and the network credentials (an admin-1 ecosystem, or the iPhone itself during the Domio flow); the plugin then joins over IP via that ecosystem's border router (HomePod/Apple TV, TBR-capable Echo, Nest Hub). See Field Notes № 2 — The controller for how the pieces fit.

Matter out — built, unit-tested on both sides, and validated live across every leg but one. The allow-list, the role mapping, endpoint persistence, pairing and fabric management, and the managed LaunchAgent are all in place, and the bridge node's own suite stands up a real Matter stack. On live hardware the bridge has been commissioned into Apple Home (uncertified prompt and all), pairing driven from the plugin's own menu has worked end to end, a second controller has joined alongside Apple Home — Alexa, as fabric #3 — an on/off light and a dimmer have been controlled in both directions, the one-click managed LaunchAgent chain has installed and run the bridge without hand intervention, and accessory identity has survived an upgrade without duplicating (2026-08-04 → 06, on the reference server), and accessory identity has survived a full reboot of the host — 50 exported accessories back on the same endpoint numbers under the same identities, no re-commissioning, both LaunchAgents up unattended and the bridge serving 17 seconds after the plugin started, with Apple Home showing every one of them in its own room and no duplicates (2026-08-19). Treat the export half as new. See MATTER.md for how it works.

Setup

Install the plugin from the Indigo Plugin Store (or download the .indigoPlugin.zip from Releases and double-click it), then set it up. It doesn't speak Matter directly — it drives matter-server, a separate Node.js process holding the Indigo-owned fabric. In local mode the plugin installs and manages that for you, so setup from here is three steps and no Terminal beyond installing Node:

1. Install Node.js 22 (≥ 22.13.0):

brew install node@22
brew link node@22
node --version          # confirm v22.x

Leave Node bin directory blank in the plugin config — auto-detect finds Homebrew first. (nvm works too; pin nodeBinDir explicitly if you use it.)

2. Install the Matter controller: Plugins ▸ Matter ▸ Install/update the Matter controller (matter-server). This installs the pinned version with the same Node it will run the server with, and pins that Node — which avoids the most common failure, installing with one Node and running with another whose native modules won't load.

3. Verify — the Indigo event log should show:

connected to matter-server, listening
reconciled N Matter node(s)

N is 0 on a fresh install; that's fine. If you instead see Connect call failed ('127.0.0.1', 5580), matter-server isn't running — that, plus the "On another computer" mode, fabric backups, upgrading and uninstalling, is covered in the full install guide.

To export Indigo devices as well, add a fourth step — Plugins ▸ Matter ▸ Install/update the Matter bridge — and then pick your devices in Manage Matter Exports…. The bridge starts itself once something is exported. Full walkthrough in the install guide.

Requirements

  • Indigo 2025.2+ on macOS.
  • Node.js ≥ 22.13.0 (Homebrew is the paved road; nvm works too) and the matter-server npm package — Beta, exact-pinned to 1.2.2 (DEFAULT_INSTALL_SPEC; the Install action uses this).
  • For export only: a second npm package, indigo-matter-bridge — on the npm registry (0.5.0 onward), exact-pinned to 0.8.0 (DEFAULT_INSTALL_SPEC) — installed by its own menu item.
  • Python dep: websockets (see Contents/Server Plugin/requirements.txt).
  • The Domio iOS app for adding devices — optional: the plugin menu's Commission device by setup code… does the same job from Indigo.

Documentation

Field Notes — the guides, properly typeset. Start here.

  • № 1 — What is Matter — the protocol primer: transports and Thread, border routers, commissioning, fabrics and multi-admin, and what "uncertified" really means.
  • № 2 — The controller — Matter in: the share model, adding and removing devices, what lands in Indigo, and troubleshooting.
  • № 3 — The bridge — Matter out: the separate bridge node, opt-in exports, pairing into an ecosystem, and what has and hasn't been validated.
  • № 4 — The Proving Ground — how this plugin is tested: the unit suites (plugin + bridge node), the device zoo, the virtual matter.js fleet, and live validation on a production server.

Setup is covered above; the full install guide has the "On another computer" mode, backups, upgrading and troubleshooting.

  • docs/DEVICE-NOTES.md — behaviours of specific hardware that are not obvious from the spec: the Tapo reset holds (one keeps your fabrics, one wipes them), the BILRESA channel → endpoint map, and why a sleepy Thread device takes seconds to answer.

Development

pytest          # full unit suite; matter-server (WebSocket) and Indigo are mocked

Developer reference, in the repo — not intended as user documentation:

Trademarks and certification

This plugin is an independent, unofficial integration. It is not certified by the Connectivity Standards Alliance, and has no affiliation with, sponsorship from, or endorsement by the CSA.

"Matter" and the Matter logo are trademarks of the Connectivity Standards Alliance. They are certification marks — on a certified product they signal that it passed CSA testing. This plugin has not been through that process, so nothing here should be read as a claim that it has. For contrast, Home Assistant may display Matter branding because it holds two CSA certifications (Home Assistant as a certified user interface component, and the Open Home Foundation Matter Server as a certified software component).

What that means in practice:

  • The plugin speaks the Matter protocol via matter-server and works with real, certified devices — but it has not been tested against the CSA's certification suite, so device-by-device interoperability is not guaranteed.
  • Commissioning uses the share model, so the device is first commissioned by a certified ecosystem (Apple Home, Alexa, Google Home); this plugin joins as a second admin. Your device's own certification is unaffected by anything here.
  • The optional Allow test/development device certificates setting relaxes device attestation so uncertified devices (development boards, Homebridge/Matterbridge bridges) can be commissioned. It is off by default, warns on every start, and should be turned off once the device is paired.
  • The Matter bridge is uncertified in the other direction, and visibly so. It advertises with the specification's test vendor ID, so every ecosystem shows an "uncertified accessory" warning when you add it and you choose Add Anyway. That is the normal state for this class of software — Homebridge, matterbridge and Home Assistant's bridge all ship the same way — and it is not something the plugin can change: outbound, the trust policy belongs to the ecosystem doing the commissioning.

The icon bundles the Matter symbol from Wikimedia Commons, which is public domain for copyright purposes. See docs/branding/README.md for provenance.

License

MIT — see LICENSE.

Release details
Released on: Aug. 23, 2026
Requires: Indigo v2024.2.0+
Downloaded: 5 times 
Changes in this release

New: Bridge Health at a glance — with notifications when a voice assistant goes stale

A new "Matter Bridge Health" device appears automatically once you are exporting devices to Apple Home, Alexa or other ecosystems. It shows:

  • Overall connection healthhealthy, churning, or unknown — for the controllers connected to your bridge.
  • Each connected ecosystem in its own slot — for example "Apple Home", "Apple Keychain", "Amazon Alexa" — each with its own health reading, so when something goes wrong you can see exactly which ecosystem is affected.

Build notifications with ordinary Indigo triggers. Some controllers — Amazon Echo devices in particular — can quietly stop receiving updates: devices show as "unresponsive" in the Alexa app while everything looks fine in Indigo, and the cure is a bridge restart. Until now the only way to spot this was reading log files. Now you can:

  • Trigger on Controller Subscription Health becomes churning → send yourself a push or email saying the Matter bridge needs a restart.
  • Trigger on becomes healthy → know it has recovered.
  • The Churn Detail state names the affected controller, and the per-ecosystem slots show who is healthy and who isn't.

One extra step to switch the monitoring on: after updating the plugin, run Plugins ▸ Matter ▸ Install/update the Matter bridge to update the bridge itself. Until then the health device simply (and honestly) reads unknown.

Bug fixes

  • Manual colour and colour-temperature changes on exported RGBW bulbs no longer flash blue, flick off, or fail to stick.
Release details
Released on: Aug. 22, 2026
Requires: Indigo v2024.2.0+
Downloaded: 6 times 
Changes in this release

What's Changed

  • fix(occupancy): emit OccupancyChanged — enable the OccupancyEvent feature (#276) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/277
  • fix(export): warn when exporting a leak/freeze/rain sensor to Alexa (#278) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/279
  • chore(bridge-node): release 0.14.0 — ships the #276 OccupancyChanged fix [release] by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/280

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.24.2...v2026.24.5

Release details
Released on: Aug. 19, 2026
Requires: Indigo v2024.2.0+
Downloaded: 4 times 
Changes in this release

What's Changed

  • fix(reconcile): name a device Indigo has hidden from us (#62) [release] by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/272

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.24.1...v2026.24.2

Release details
Released on: Aug. 19, 2026
Requires: Indigo v2024.2.0+
Downloaded: 12 times 
Changes in this release

What's Changed

  • fix(readopt): sort exported and name-matching devices to the top of the picker (#247) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/266
  • fix(node): re-validate the pinned nodeBinDir instead of trusting it forever (#101) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/267
  • fix(generic-switch): a momentary-only switch's InitialPress is the press (#231) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/268
  • chore: ignore .scratch-* design docs by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/269
  • fix(fan): turn on by writing PercentSetting, not FanMode=On (#46) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/271

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.23.8...v2026.24.1

Release details
Released on: Aug. 19, 2026
Requires: Indigo v2024.2.0+
Downloaded: 9 times 
Changes in this release

What's Changed

  • docs: renaming an exported device does not rename it in the ecosystem (#221) [release] by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/265

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.23.7...v2026.23.8

Release details
Released on: Aug. 19, 2026
Requires: Indigo v2024.2.0+
Downloaded: 8 times 
Changes in this release

What's Changed

  • docs: the reboot leg of the accessory-identity check is validated [release] by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/263

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.23.6...v2026.23.7

Release details
Released on: Aug. 19, 2026
Requires: Indigo v2024.2.0+
Downloaded: 11 times 
Changes in this release

What's Changed

  • docs: the sensor arc's documentation catches up (#252) [release] by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/262

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.23.5...v2026.23.6

Release details
Released on: Aug. 19, 2026
Requires: Indigo v2024.2.0+
Downloaded: 9 times 
Changes in this release

What's Changed

  • fix(export): contact sensors read the right way round, and every binary sensor gets a polarity tick (#252) [release] by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/261

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.23.4...v2026.23.5

Release details
Released on: Aug. 19, 2026
Requires: Indigo v2024.2.0+
Downloaded: 8 times 
Changes in this release

What's Changed

  • fix(export): suggest the role when the state is pre-chosen, and read plural zone names (#252) [release] by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/260

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.23.3...v2026.23.4

Release details
Released on: Aug. 18, 2026
Requires: Indigo v2024.2.0+
Downloaded: 8 times 
Changes in this release

What's Changed

  • fix(export): migrate onto a device that already carries a state mapping (#252) [release] by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/259

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.23.2...v2026.23.3

Release details
Released on: Aug. 18, 2026
Requires: Indigo v2024.2.0+
Downloaded: 8 times 
Changes in this release

What's Changed

  • fix(export): mappable devices vanished from the migrate and re-adopt pickers (#252) [release] by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/258

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.23.1...v2026.23.2

Release details
Released on: Aug. 18, 2026
Requires: Indigo v2024.2.0+
Downloaded: 8 times 
Changes in this release

What's Changed

  • chore(bridge-node): release 0.13.0 — the node that knows the new sensor roles [release] by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/257

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.23.0...v2026.23.1

Release details
Released on: Aug. 18, 2026
Requires: Indigo v2024.2.0+
Downloaded: 7 times 
Changes in this release

What's Changed

  • docs(export): occupancy role is labelled PIR/motion — Matter has no motion type (#252) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/253
  • feat(export): water leak, freeze and rain roles; binary default read from the name (#236) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/254
  • feat(export): smoke and carbon monoxide alarm roles (#179) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/255
  • feat(export): map a plugin-named state, and export the devices Indigo does not type (#252) [release] by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/256

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.22.1...v2026.23.0

Release details
Released on: Aug. 18, 2026
Requires: Indigo v2024.2.0+
Downloaded: 8 times 
Changes in this release

What's Changed

  • feat(export): migrate an exported accessory to another Indigo device (#246) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/249
  • chore(bridge-node): release 0.12.0 — bump package and pinned install spec by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/250

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.21.1...v2026.22.1

Release details
Released on: Aug. 18, 2026
Requires: Indigo v2024.2.0+
Downloaded: 8 times 
Changes in this release

What's Changed

  • fix(#227) + feat(#226): commissions fail out loud and narrate in plain English by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/228
  • Export hardening PR1: conformance guards, port-bind verification, forget() keeps re-adopt evidence by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/229
  • Export: invocation-driven onOff (#143 half A) + countdown-safe pushes (#201) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/230
  • Export: battery level on bridged accessories (#220) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/232
  • chore(bridge-node): release 0.9.0 — bump package and pinned install spec by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/233
  • Export: dimmers and colour wait for Indigo — invocation-driven LevelControl/ColorControl (#143) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/234
  • Export: colour-while-off forwards, like brightness (#235) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/237
  • chore(bridge-node): release 0.10.0 — bump package and pinned install spec by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/238
  • Export: slider-up emits setLevel alone — Indigo does the turn-on (#239) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/241
  • chore(bridge-node): release 0.10.1 — bump package and pinned install spec by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/242
  • feat(export): plugin-owned published identity — re-adopt (#219) and role-change supersede (#240) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/244
  • chore(bridge-node): release 0.11.0 — pin the protocol-v2 node by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/245

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.16.0...v2026.21.1

Release details
Released on: Aug. 15, 2026
Requires: Indigo v2024.2.0+
Downloaded: 11 times 
Changes in this release

Share a Matter device with another ecosystem

Devices commissioned directly by Indigo (for example through Domio) previously existed only in Indigo. They can now be shared to Apple Home, Alexa, Google Home, or any other Matter ecosystem — while staying fully under Indigo's control.

  • Plugins ▸ Matter ▸ Share a Matter device with another ecosystem… — pick the device, choose how long the pairing window stays open, and click Open sharing window. The pairing code appears in the Indigo event log; enter it in the other ecosystem's app (Apple Home: Add Accessory → More options → Enter code manually).
  • The same action is available on each Matter node device (Share this device with another ecosystem), so it can also be driven from triggers, schedules, and control pages.
  • The log entry includes the code, its approximate expiry, and how many fabric slots the device has free — useful to know before sharing, since an Apple Home pairing uses two.

A Matter pairing code is single-use and short-lived: once used, or once the window expires (up to 15 minutes), it cannot be read back — just run the share again for a fresh one.

Bug fixes and improvements

  • Sharing failures always leave a clear record in the event log, including the matter-server error that caused them.
  • A pairing code that arrives after a slow (battery/Thread) device misses its deadline is no longer lost — it is logged as soon as it lands.
  • The per-device share action runs in the background, so a busy matter-server cannot delay other device commands queued behind it.
  • Two different device-grouping warnings no longer suppress each other in the log.
  • When a standalone energy-meter device becomes redundant (its readings start appearing on the actuator device it belongs to), the plugin now says so once — deleting it remains your choice.
Release details
Released on: Aug. 12, 2026
Requires: Indigo v2024.2.0+
Downloaded: 10 times 
Changes in this release

Every Matter product you have paired now gets a device in Indigo representing the product itself, alongside the devices for the things it does. A motion sensor that gave you four Indigo devices now gives you five: the four sensors, plus the sensor unit they all belong to. Everything else in this release follows from that.

What you will see after upgrading

  • A new device for each Matter product. It shows the product's name, its firmware version (which the plugin has never been able to show you until now), whether it is currently reachable, and its battery level if it has one.
  • A product's devices are grouped together in the device list and filed in the same folder, so a multi-sensor reads as one family instead of four unrelated rows.
  • Some devices are renamed so the family reads consistently: a plug called Office Plug becomes Office Plug - Switch, and Office Plug becomes the name of the new product-level device. Devices you renamed yourself are never renamed — only names the plugin itself invented are changed.
  • Energy readings that used to vanish now appear. Some products report power and energy for the product as a whole rather than for the socket; those readings were being dropped, and now land on the socket they measure, or on the product device when there is no way to tell which part they belong to.

Worth knowing before you upgrade

  • Renaming does not affect your automations. Triggers, schedules, action groups and control pages all track devices by their internal id, not their name, so they keep working. What a rename does affect is a Python script that looks a device up by name — indigo.devices["Office Plug"] — and any outside integration matching on names. Worth a check if you have those.
  • Deleting a device is now riskier, because devices are grouped. Delete one in Indigo and it will offer to delete the whole family; if you agree, the plugin recreates them and they come back as new devices, so anything pointing at the old ones quietly stops working.
    • To hide a device you do not want: move it to a folder you do not look at.
    • To get rid of the hardware for real: decommission it (Remove from Indigo).
    • The product-level device is the exception — delete that one and it stays deleted, with Plugins → Matter → Recreate Matter node devices… as the way back.
  • Battery levels now come from what the device actually says. Matter devices declare which of their parts a battery powers, and the plugin now reads that instead of guessing. On most hardware nothing changes. If you have a hub with several battery-powered devices behind it, one of them may stop showing a battery level it was never really entitled to — the plugin writes a line in the log naming any device this affects, rather than leaving a frozen number sitting there.

Also new

  • "Recreate Matter node devices…" in the plugin menu — the way back if you delete a product-level device and change your mind.
  • "Report this node's settable attributes" as a device action, so you can ask a single product what it will let you configure, and the answer is shown on the device itself.

Fixed

  • Battery readings can no longer leak between different devices behind the same hub.
  • Removing a Matter device and adding it back later now works properly.
  • Restarting the Matter server can no longer leave a stale power reading stuck on a device.

Full technical detail: CHANGELOG.md. User guide: docs/MATTER.md.

Pull requests in this release * fix(docs): ADR template's placeholder date broke the entire Pages build — #207 * fix(#205): PowerSource.EndpointList is the battery-routing authority — #208 * feat(#204): a Matter node is an Indigo device — #209 * feat(#204): node device as group root + naming/folder true-up — #211 * feat(#204 arc): endpoint-0 energy has a home + survey surfaced on the node device — #213 * [release] 2026.15.0 — #214

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.12.0...v2026.15.0

Release details
Released on: Aug. 11, 2026
Requires: Indigo v2024.2.0+
Downloaded: 9 times 
Changes in this release

What's Changed

  • fix(#190): two corrections — fixtures named the wrong plug, and the lock-free rationale overclaimed by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/194
  • chore: untrack docs/research/ — committed by mistake in #194 by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/195
  • feat(#191): settable-attribute report + read-only attribute explorer by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/196
  • docs: move the module table out of CLAUDE.md into docs/ARCHITECTURE.md by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/198
  • docs: repo-local ADRs + device notes by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/199
  • [release] fix(#197): command parameters are not settings — retire "Auto-off after" by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/200

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.10.1...v2026.12.0

Release details
Released on: Aug. 11, 2026
Requires: Indigo v2024.2.0+
Downloaded: 10 times 
Changes in this release

What's Changed

  • docs: outbound mapping table on the bridge field-notes page by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/174
  • fix(#182): a pid is not health — detect a foreign holder of our matter-server port by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/183
  • fix(#184): NodeNotExists is a completed decommission, not an offline device by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/185
  • feat(#186): edit writable Matter device settings from the Edit Device dialog by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/189
  • [release] fix(#190,#192): device states follow the device's AttributeList; capability caches are rebuilt by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/193

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.9.4...v2026.10.1

Release details
Released on: Aug. 10, 2026
Requires: Indigo v2024.2.0+
Downloaded: 18 times 
Changes in this release

What's Changed

  • fix(commission): node ownership guard + reconcile claim discipline (#21, #22) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/164
  • feat(commission): fold late matter-server responses into the job table (#23) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/165
  • feat(commission): log and clean up when the reconcile window closes unclaimed (#24) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/166
  • docs(handover): commissioning quartet #21–#24 landed by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/168
  • feat(backup): restore extracts the bridge node's storage too (#136) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/169
  • fix(commission): harden the quartet — TOCTOU removal gate, node-id normalization, watchdog guard, honest logging (#21 #22 #23 #24 follow-up) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/170
  • refactor: split plugin.py behind the XML wiring (#146) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/172
  • docs: close and retire the handover — refs removed, HANDOVER.md gitignored by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/171
  • docs: release-prep — field-notes restructure + announcement blocker fixes [release] by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/173

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.8.20...v2026.9.4

Release details
Released on: Aug. 4, 2026
Requires: Indigo v2024.2.0+
Downloaded: 14 times 
Changes in this release

What's Changed

  • feat(export): E0 bridge-node skeleton (validation gate) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/119

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.7.22...v2026.7.23

Release details
Released on: Aug. 4, 2026
Requires: Indigo v2024.2.0+
Downloaded: 12 times 
Changes in this release

What's Changed

  • docs(export): PRD research pass + bridge protocol spec by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/118

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.7.21...v2026.7.22

Release details
Released on: Aug. 4, 2026
Requires: Indigo v2024.2.0+
Downloaded: 13 times 
Changes in this release

What's Changed

  • ci: fail the build if CFBundleVersion is too long for the Plugin Store by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/117

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.7.20...v2026.7.21

Release details
Released on: Aug. 4, 2026
Requires: Indigo v2024.2.0+
Downloaded: 19 times 
Changes in this release

What's Changed

  • docs(readme): lift the uncertified notice into the lede; fix the opening by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/116

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.7.19...v2026.7.20

Release details
Released on: Aug. 4, 2026
Requires: Indigo v2024.2.0+
Downloaded: 17 times 
Changes in this release

What's Changed

  • docs: user-facing docs pass — typeset guides, inline setup, correct commissioning by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/115

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.7.18...v2026.7.19

Release details
Released on: Aug. 4, 2026
Requires: Indigo v2024.2.0+
Downloaded: 17 times 
Changes in this release

What's Changed

  • chore(docs): drop the issue #79 working plan, now resolved by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/114

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.7.17...v2026.7.18

Release details
Released on: Aug. 4, 2026
Requires: Indigo v2024.2.0+
Downloaded: 18 times 
Changes in this release

What's Changed

  • feat(branding): add plugin store icon by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/113

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.7.16...v2026.7.17

Release details
Released on: Aug. 4, 2026
Requires: Indigo v2024.2.0+
Downloaded: 16 times 
Changes in this release

What's Changed

  • fix(ui): list nodes that created no devices, so empty bridges can be decommissioned by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/112

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.7.15...v2026.7.16

Release details
Released on: Aug. 3, 2026
Requires: Indigo v2024.2.0+
Downloaded: 17 times 
Changes in this release

What's Changed

  • docs(prd): Indigo Matter Export — Indigo as a Matter bridge by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/110

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.7.14...v2026.7.15

Release details
Released on: Aug. 3, 2026
Requires: Indigo v2024.2.0+
Downloaded: 16 times 
Changes in this release

What's Changed

  • docs(handover): 2026-08-03 afternoon — #105 diagnostic, #236, and a live Thread outage by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/109

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.7.13...v2026.7.14

Release details
Released on: Aug. 3, 2026
Requires: Indigo v2024.2.0+
Downloaded: 18 times 
Changes in this release

What's Changed

  • feat(bridges): explain a bridge that commissions but exposes nothing by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/108

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.7.12...v2026.7.13

Release details
Released on: Aug. 3, 2026
Requires: Indigo v2024.2.0+
Downloaded: 15 times 
Changes in this release

What's Changed

  • fix(server): matter-server supervision — reap on port, revive dead jobs, flag argument drift by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/107

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.7.11...v2026.7.12

Release details
Released on: Aug. 3, 2026
Requires: Indigo v2024.2.0+
Downloaded: 15 times 
Changes in this release

What's Changed

  • docs(handover): 2026-08-02/03 session — test-net DCL and the faults it exposed by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/106

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.7.10...v2026.7.11

Release details
Released on: Aug. 3, 2026
Requires: Indigo v2024.2.0+
Downloaded: 18 times 
Changes in this release

What's Changed

  • feat(server): opt-in --enable-test-net-dcl for dev/test device certificates by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/103

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.7.9...v2026.7.10

Release details
Released on: July 13, 2026
Requires: Indigo v2024.2.0+
Downloaded: 33 times 
Changes in this release

What's Changed

  • fix: CFBundleVersion must be 1.0.0 (plugin-store validation) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/102

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.7.8...v2026.7.9

Release details
Released on: July 12, 2026
Requires: Indigo v2024.2.0+
Downloaded: 27 times 
Changes in this release

What's Changed

  • fix(server): reap orphaned matter-servers holding the storage lock + clean reinstall by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/100

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.7.7...v2026.7.8

Release details
Released on: July 11, 2026
Requires: Indigo v2024.2.0+
Downloaded: 10 times 
Changes in this release

What's Changed

  • fix(server): reload LaunchAgent so a stale --port "" job actually clears by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/99

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.7.6...v2026.7.7

Release details
Released on: July 11, 2026
Requires: Indigo v2024.2.0+
Downloaded: 9 times 
Changes in this release

What's Changed

  • docs(readme): matter-server 1.2.2 + Node 22.13 + Install action (v2026.7.6) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/98

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.7.5...v2026.7.6

Release details
Released on: July 11, 2026
Requires: Indigo v2024.2.0+
Downloaded: 27 times 
Changes in this release

What's Changed

  • Fix post-2026.7.4 review: restart diagnostic + restart-fail + node gate (v2026.7.5) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/97

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.7.4...v2026.7.5

Release details
Released on: July 11, 2026
Requires: Indigo v2024.2.0+
Downloaded: 23 times 
Changes in this release

What's Changed

  • Install auto-restarts matter-server + log server version (v2026.7.4) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/96

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.7.3...v2026.7.4

Release details
Released on: July 11, 2026
Requires: Indigo v2024.2.0+
Downloaded: 21 times 
Changes in this release

What's Changed

  • Default matter-server to pinned 1.2.2 (v2026.7.3) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/95

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.7.2...v2026.7.3

Release details
Released on: July 11, 2026
Requires: Indigo v2024.2.0+
Downloaded: 23 times 
Changes in this release

What's Changed

  • Fix: node on PATH for matter-server install subprocess (v2026.7.2) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/94

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.7.1...v2026.7.2

Release details
Released on: July 11, 2026
Requires: Indigo v2024.2.0+
Downloaded: 24 times 
Changes in this release

What's Changed

  • Recover stranded port fix + harden matter-server install (v2026.7.1) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/93

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.7.0...v2026.7.1

Release details
Released on: July 10, 2026
Requires: Indigo v2024.2.0+
Downloaded: 19 times 
Changes in this release

What's Changed

  • Install/update matter-server from the plugin + pin the node (v2026.7.0) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/92

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.6.2...v2026.7.0

Release details
Released on: July 10, 2026
Requires: Indigo v2024.2.0+
Downloaded: 24 times 
Changes in this release

What's Changed

  • Surface matter-server startup failures instead of a silent crash-loop (v2026.6.2) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/91

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.6.1...v2026.6.2

Release details
Released on: July 9, 2026
Requires: Indigo v2024.2.0+
Downloaded: 25 times 
Changes in this release

What's Changed

  • fix+feat(config): "is matter-server on this Mac?" — simplify config, kill the :80 trap by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/88

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.5.0...v2026.6.1

Release details
Released on: July 6, 2026
Requires: Indigo v2024.2.0+
Downloaded: 21 times 
Changes in this release

What's Changed

  • Boolean State Configuration (0x0080): sensitivity state + Set Sensitivity action by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/87

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.4.2...v2026.5.0

Release details
Released on: July 6, 2026
Requires: Indigo v2024.2.0+
Downloaded: 32 times 
Changes in this release

What's Changed

  • test: zoo invariant pinning the PR #73 native-state class by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/86

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.4.1...v2026.4.2

Release details
Released on: July 6, 2026
Requires: Indigo v2024.2.0+
Downloaded: 30 times 
Changes in this release

What's Changed

  • Remove redundant native-state declarations from sensor device types by @Highsteads in https://github.com/simons-plugins/indigo-matter/pull/73

New Contributors

  • @Highsteads made their first contribution in https://github.com/simons-plugins/indigo-matter/pull/73

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.4.0...v2026.4.1

Release details
Released on: July 6, 2026
Requires: Indigo v2024.2.0+
Downloaded: 29 times 
Changes in this release

What's Changed

  • Split-endpoint energy measurement attribution (IKEA GRILLPLATS) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/80

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.3.2...v2026.4.0

Release details
Released on: July 5, 2026
Requires: Indigo v2024.2.0+
Downloaded: 30 times 
Changes in this release

What's Changed

  • feat: expectedFabricSlots warning + C3 direct-commissioning docs by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/78

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.3.1...v2026.3.2

Release details
Released on: June 13, 2026
Requires: Indigo v2024.2.0+
Downloaded: 47 times 
Changes in this release

What's Changed

  • chore: sync CFBundleVersion with PluginVersion at 2026.3.1 by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/69

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.3.0...v2026.3.1

Release details
Released on: June 10, 2026
Requires: Indigo v2024.2.0+
Downloaded: 19 times 
Changes in this release

What's Changed

  • feat(matter): Generic Switch cluster + node_event plumbing (#4) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/41

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.2.8...v2026.2.9

Release details
Released on: June 10, 2026
Requires: Indigo v2024.2.0+
Downloaded: 17 times 
Changes in this release

What's Changed

  • feat(matter): Pressure + Flow measurement sensors (#13) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/35

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.2.7...v2026.2.8

Release details
Released on: June 10, 2026
Requires: Indigo v2024.2.0+
Downloaded: 16 times 
Changes in this release

What's Changed

  • feat(matter): Valve cluster — water shut-off and irrigation valves (#12) by @simons-plugins in https://github.com/simons-plugins/indigo-matter/pull/39

Full Changelog: https://github.com/simons-plugins/indigo-matter/compare/v2026.2.6...v2026.2.7