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.7.9 released on July 13, 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.3.1

indigo-matter

Matter device support for the Indigo home automation server.

Add Matter devices from the Domio iOS app; 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, and translates Matter clusters ↔ Indigo device types.

Domio (iOS) ──share code──▶ indigo-matter ──WebSocket──▶ matter-server ──IP──▶ Wi-Fi Matter devices

Commissioning uses the share model: Apple Home commissions the device first, Domio relays a share/pairing code to the plugin, and the plugin joins the device's fabric as a second admin over IP. The plugin owns runtime control for the device's lifetime.

Status

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 through the same share model — the admin-1 ecosystem (Apple Home, or equally Alexa / Google Home) does the Thread provisioning; the plugin joins over IP via that ecosystem's border router (HomePod/Apple TV, TBR-capable Echo, Nest Hub). See docs/MATTER.md for how the pieces fit; validation specifics live in docs/HANDOVER.md.

Setup

matter-server is a separate Node.js runtime. In local mode the plugin installs and manages it for you — Plugins ▸ Matter ▸ Install/update matter-server installs the pinned version with your Node and restarts onto it (no Terminal). See docs/INSTALL.md for the full guide (Node, matter-server, the two run modes, verification, backups, and troubleshooting).

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).
  • Python dep: websockets (see Contents/Server Plugin/requirements.txt).
  • The Domio iOS app for adding devices.

Documentation

  • docs/MATTER.md — Matter & Thread explained: how Indigo, Domio, matter-server and Apple Home fit together. Start here.
  • docs/INSTALL.md — matter-server install & plugin setup.
  • docs/TESTING.md — how the plugin is tested: unit suite, the device zoo, the virtual matter.js fleet, and live validation.
  • docs/PRD-indigo-matter-plugin.md — product requirements and milestones.
  • docs/IMPLEMENTATION.md — protocols, scaffold, setup, cluster handlers.
  • docs/API.md — the Domio ↔ plugin HTTP contract (v1.3, served over the Indigo Web Server).

Development

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

See CLAUDE.md for architecture and workspace conventions.

License

MIT — see LICENSE.

Release details
Released on: July 13, 2026
Requires: Indigo v2024.2.0+
Downloaded: 5 times 
Download this release
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: 3 times 
Download this release
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: 3 times 
Download this release
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: 4 times 
Download this release
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: 3 times 
Download this release
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: 3 times 
Download this release
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: 4 times 
Download this release
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: 3 times 
Download this release
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: 2 times 
Download this release
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: 6 times 
Download this release
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: 2 times 
Download this release
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: 5 times 
Download this release
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: 4 times 
Download this release
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: 4 times 
Download this release
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: 4 times 
Download this release
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: 25 times 
Download this release
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