Narwal Freo
homebridge-narwal-freo · v0.6.1
Adds the original Narwal Freo as a native Matter robot vacuum with room selection and consumable sensors.
What it says it supports
Brands
- Narwal
Devices it names
- Narwal Freo (YJCC012)
Shows up in Apple Home as from its README
Sensor readings in its code
What people report
Narwal Freo robot vacuum over Matter; setup instructions need Matter enabled on child bridge.
- Works1
| Device | Status | What they said | Source |
|---|---|---|---|
| Narwal Freo robot vacuum | Works | Used via Matter on Homebridge 2.4.0; README setup PRs openSaved copy… README doesn't spell out: 1. Enabling Matter (externals only) on the child bridge. Without it the log says `Matter is not enabled for this bridge` and no vacuum is published. 2. The log's "waiting for the room list" message: open the Narwal app on the robot's map for about a minute. 3. Where the Matter pairing code appears (the Homebridge log, as `Commissioning codes for …`) and that it's paired separately via Home app > + > Add Accessory. Docs only, no code changes. Verified against plugin v0.4.2 and the original Freo. Excerpt saved from GitHub on 2026-10-22. | PR #1 · 2026-10 |
Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Cloud
Narwal cloud REST sign-in plus MQTT; no local API
You’ll need
- Narwal account
- Homebridge Matter
Compatibility
| Verified by Homebridge | Yes |
|---|---|
| Homebridge versions | ^2.4.0 |
| Homebridge 2.0 | Yes |
| Node.js | ^22.0.0 || ^24.0.0 |
| Settings in Homebridge UI | Yes |
| Matter | Yes (uses the Homebridge 2 Matter API) |
| Platform name | NarwalPlatform |
| License | MIT |
Community signals
| Downloads a week | 462 |
|---|---|
| Downloads a month | 462 |
| GitHub stars | 0 |
| Open issues | 0 |
| Closed issues | 0 |
| Last code push | 2026-10-22 |
| Latest version | 0.6.1 (2026-10-22) |
| First published | 2026-10-16 |
| Releases | 7 |
In ReReHome
Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.
Bridges get their own settings page listing the accessories behind them.
Caveats from the README
- Only original Freo supported
- Unofficial
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- FilterMaintenance
- OccupancySensor
- Switch
