Matterbridge Roborock Platform Plugin
---
**Matterbridge Roborock Platform Plugin** is a dynamic platform plugin for [Matterbridge](https://www.npmjs.com/package/matterbridge) that integrates Roborock vacuums into the Matter ecosystem, enabling control via Apple Home and other Matter-compatible apps.
> ⭐ If you find this project useful, please consider starring the repository on GitHub:
> [https://github.com/RinDevJunior/matterbridge-roborock-vacuum-plugin](https://github.com/RinDevJunior/matterbridge-roborock-vacuum-plugin)
---
### ⚠️ Important Notes
Requires matterbridge@3.6.1
- **Matterbridge must be run in child bridge mode** for proper operation.
- **By default, one Matterbridge instance supports one Roborock vacuum.**
If you have more than one vacuum, you can either:
- Run separate Matterbridge instances (one per vacuum), or
- **Enable Server Mode** in the plugin configuration — this allows a single Matterbridge instance to host multiple vacuums at once.
- To control which device(s) are exposed, add their **DUID(s)** to the **White List** in the plugin configuration. If the list is empty, all supported devices are exposed (limited to one unless Server Mode is enabled).
More details available here: [Discussion #264](https://github.com/Luligu/matterbridge/discussions/264)
---
### 🆔 How to Get Your DUID
To get the **DUID** for your devices, you have two options:
**Option 1: From Matterbridge Logs**
1. **Start Matterbridge** with the plugin enabled.
2. **Watch the Docker console logs directly** (not the Matterbridge UI logs, as they may be truncated).
3. Look for the log message that says:
```text
Initializing - devices: [...]
```
**Option 2: From the Roborock App**
1. Open the **Roborock app** on your phone.
2. Go to your **Device**.
3. Tap **Settings** > **Product Info**.
4. Find the **DID** field. The value will look like `rr_xxxxxxx`.
5. **Remove the `rr_` prefix** from the DID value. The remaining string is your DUID.
---
### 🚧 Project Status
- **Under active development**
- Requires **`matterbridge@3.5.5`**
---
### ➡️ [See Supported & Tested Roborock Devices](./README_SUPPORTED.md)
📋 **Apple Home ↔️ Roborock Clean Mode Mapping:**
For a detailed table of how Apple Home clean modes map to Roborock settings, see 👉 [Apple Home ↔️ Roborock Clean Mode Mapping](./README_CLEANMODE.md)
---
### 📦 Prerequisites
- A working installation of [Matterbridge](https://github.com/Luligu/matterbridge)
- Compatible Roborock vacuum model (not all models supported yet)
---
### ⚙️ Matterbridge setting
---
### 💬 Need Help?
🛠️ **Reporting an Issue**
Before opening an issue, please make sure to read the instructions here:
[📄 How to Report an Issue](./README_REPORT_ISSUE.md)
💬 **Community Support**
Join our Discord for support, updates, and community discussions:
👉 [Join the Matterbridge Roborock Discord](https://discord.gg/favqExHGn4)
---
### 🧱 Built With
This plugin is built on top of the official dynamic platform example:
🔗 [matterbridge-example-dynamic-platform](https://github.com/Luligu/matterbridge-example-dynamic-platform)
---
### 📸 Screenshot
