homebridge-dummy-vacuum

A Homebridge 2 Matter-only dummy robot vacuum plugin.

This plugin creates a native Matter RoboticVacuumCleaner accessory. It does not create a classic HomeKit/HAP switch.

Requirements

• Homebridge ^2.0.0
• Node.js ^22 || ^24
• Matter enabled in Homebridge

Install from npm

npm install -g homebridge-dummy-vacuum

Then restart Homebridge and search for homebridge-dummy-vacuum in the Homebridge UI.

Local build

npm install
npm run build
npm pack

Install the packed file on your Homebridge machine:

npm install -g ./homebridge-dummy-vacuum-0.1.0.tgz

Example config

{
  "platform": "DummyVacuum",
  "name": "DummyVacuum",
  "vacuumName": "Dummy Vacuum",
  "serialNumber": "DUMMY-VACUUM-001",
  "manufacturer": "Dummy",
  "model": "Matter Dummy Vacuum",
  "batteryLevel": 100,
  "commandStart": "echo start",
  "commandStop": "echo stop",
  "commandPause": "echo pause",
  "commandResume": "echo resume",
  "commandDock": "echo dock"
}

All command fields are optional.

Publish to npm

First edit package.json and replace:

YOUR_GITHUB_USER

Then:

npm login
npm publish --access public

After npm indexes the package, Homebridge UI should be able to find it because the package includes:

• homebridge-plugin keyword
• homebridge.platform metadata
• config.schema.json