Homebridge-roborock-vacuum NPM

homebridge-roborock-vacuum

A Homebridge plugin to integrate your Roborock vacuum cleaner with Apple HomeKit, allowing you to control it via the Home app and Siri.

Introduction

homebridge-roborock-vacuum brings your Roborock vacuum cleaner into Apple HomeKit. Using your Roborock app account credentials, this plugin automatically detects your vacuum, enabling you to control it directly from the Home app on your iPhone, iPad, or Mac, or with Siri voice commands.

This plugin is inspired by and adapted from the ioBroker.roborock project by copystring.

Features

Automatic Device Detection: No need to manually find or enter your vacuum's device ID.
Start/Stop Cleaning: Begin or end cleaning sessions.

The supported robots are:

Roborock S4 Roborock S4 Max Roborock S5 Max Roborock S6 Roborock S6 Pure Roborock S6 MaxV Roborock S7 Roborock S7 MaxV (Ultra) Roborock Q7 Roborock Q7 Max Roborock S7 Pro Ultra Roborock S7 Max Ultra Roborock S8 Roborock S8 Pro Ultra Roborock Q Revo Roborock Q8 Max Roborock Q5 Pro Roborock Q Revo Pro Roborock Qrevo S Roborock Qrevo Curve

Requirements

Before installing, ensure you have:

A Roborock vacuum cleaner compatible with the Roborock app.
A Roborock app account (email and password).
Homebridge installed on a server (e.g., Raspberry Pi).
Node.js and npm installed on your Homebridge server.

Installation

Follow these steps to install the plugin:

Install Homebridge (if not already installed):
- Refer to the official Homebridge installation guide.
Install the Plugin:
- Open a terminal and run:
```
npm install -g homebridge-roborock-vacuum
```