matterbridge-iotas
v1.2.3
Published
Matterbridge plugin for IOTAS smart home devices
Maintainers
Readme
matterbridge-iotas
Matterbridge plugin for IOTAS smart home devices. Bridges IOTAS devices to the Matter protocol via Matterbridge, making them accessible from Apple Home, Google Home, Amazon Alexa, Home Assistant, and any Matter-compatible controller.
Features
- Automatic device discovery by unit
- Supports lights, switches, outlets, locks, thermostats, and sensors
- Background polling with cached state
- Allow/deny list filtering for device exposure
- Uses iotas-ts shared library
Supported Devices
| IOTAS Device | Matter Device Type | Clusters | | --------------- | ------------------ | --------------------------- | | Dimmer | Dimmable Light | OnOff, LevelControl | | Switch (light) | On/Off Light | OnOff | | Switch (outlet) | On/Off Outlet | OnOff | | Door Lock | Door Lock | DoorLock | | Thermostat | Thermostat | Thermostat | | Humidity Sensor | Humidity Sensor | RelativeHumidityMeasurement | | Motion Sensor | Occupancy Sensor | OccupancySensing | | Door Sensor | Contact Sensor | BooleanState |
Installation
From npm
matterbridge -add matterbridge-iotasFrom GitHub (development)
cd ~/Matterbridge
git clone https://github.com/mezaugusto/matterbridge-iotas
cd matterbridge-iotas
npm install
npm link matterbridge
npm run build
matterbridge -add .Configuration
Configure via the Matterbridge web UI or edit matterbridge-iotas.config.json:
| Field | Type | Required | Default | Description |
| ----------------- | -------- | -------- | ------- | ---------------------------------------------- |
| username | string | Yes | | IOTAS account email |
| password | string | Yes | | IOTAS account password |
| unit | string | No | | Unit name (defaults to first found) |
| whiteList | string[] | No | [] | Only expose these devices (empty = expose all) |
| blackList | string[] | No | [] | Exclude these devices (empty = exclude none) |
| pollingInterval | number | No | 5 | Polling interval in seconds (5–300) |
| debug | boolean | No | false | Enable verbose debug logging |
Development
npm install
npm link matterbridge
npm run build
npm run lint
npm test