iobroker.roborock
v0.7.4
Published
roborock
Readme

ioBroker.roborock
Tests:
Roborock adapter for ioBroker
This adapter allows you the control, get states, cleaning history and view the map of a Roborock vacuum cleaner which is set up in the Roborock app.
This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers. For more details and for information how to disable the error reporting see Sentry-Plugin Documentation! Sentry reporting is used starting with js-controller 3.0.
Requirements
- Node.js >= 22.0.0
- ioBroker.admin >= 7.6.17
- ioBroker.js-controller >= 6.0.11
Supported robots
- S-Series: S4, S4 Max, S5 Max, S6, S6 Pure, S6 MaxV, S7, S7 MaxV (Pro/Ultra), S7 Pro Ultra, S7 Max Ultra, S8, S8+, S8 Pro Ultra, S8 MaxV Ultra
- Q-Series: Q5 Pro, Q7, Q7 Max, Q7 L5, Q8 Max
- Q Revo: Q Revo, Q Revo Pro
- Qrevo: Qrevo Slim, Qrevo S, Qrevo Curve, Qrevo Curv Series, Qrevo Edge, Qrevo Edge Series, Qrevo L, Qrevo Master, Qrevo MaxV
- Saros: Saros 10, Saros 10R, Saros 20 / Saros 20X, Saros Z70
Zone cleaning
This feature only works when map creation is enabled in the adapter options. Open the map from the adapter’s web UI tab in the ioBroker admin interface; no manual URL needed.
Map creation does not work on raspberry pi
- Draw your square meant for cleaning. Roborock supports up to 4 cleaning zones at once.

Changelog
0.7.4 (2026-06-07)
- (copystring) Documented tested Roborock S8+ support.
- (copystring) Fixed consumable percentage values for devices where Roborock reports maintenance data via HomeData.
- (copystring) Re-enabled macOS support and added macOS test coverage.
- (copystring) Improved dependency update automation so updates are checked weekly and merged only after successful checks.
- (copystring) Updated
p-queueto 9.3.0 andprotobufjsto 8.5.0. - (copystring) Improved CI performance for Linux, macOS and Windows adapter tests without reducing test coverage.
0.7.3 (2026-05-22)
- (copystring) Fixed V1 auto-empty dust collection to use the AppPlugin-verified
app_start_collect_dustcommand.
0.7.2 (2026-05-20)
- (copystring) Fixed missing auto-empty command for Roborock Qrevo MaxV (#1272).
- (copystring) Fixed local endpoint refresh after temporary MQTT outages so stale local IP recovery retries immediately again.
- (copystring) Require bug reports to upload a
.txtdebug log file.
0.7.1 (2026-05-19)
- (copystring) Fixed local TCP recovery when a Roborock device gets a new LAN IP address.
- (copystring) Updated dependencies:
@napi-rs/canvasto 1.0.0,protobufjsto 8.2.0 andzodto 4.4.3. - (copystring) Resolved npm audit security advisories in transitive dependencies and documented the temporary dependency overrides.
0.7.0 (2026-05-04)
- (copystring) Added support for Roborock Q10, including map handling for this model.
- (copystring) Added support for Roborock Saros Z70.
- (copystring) Improved local connections for newer Roborock models so reconnects, keepalive checks and map transfers are more reliable.
- (copystring) Fixed empty images in
mapBase64andmapBase64Truncated.
Older changelog entries are available in CHANGELOG_OLD.md.
License
MIT License
Copyright (c) 2026 copystring [email protected]
See LICENSE for the full license text.

