https://github.com/homebridge-plugins/homebridge-ecovacs
Homebridge plugin to integrate Ecovacs Deebot devices into HomeKit.
https://github.com/homebridge-plugins/homebridge-ecovacs
deebot ecovacs homebridge homebridge-deebot homebridge-plugin homekit hoobs hoobs-plugin hoover siri vacuum
Last synced: 4 days ago
JSON representation
Homebridge plugin to integrate Ecovacs Deebot devices into HomeKit.
- Host: GitHub
- URL: https://github.com/homebridge-plugins/homebridge-ecovacs
- Owner: homebridge-plugins
- License: mit
- Created: 2020-09-12T21:30:21.000Z (over 5 years ago)
- Default Branch: latest
- Last Pushed: 2026-04-19T12:03:17.000Z (about 2 months ago)
- Last Synced: 2026-04-19T14:13:01.852Z (about 2 months ago)
- Topics: deebot, ecovacs, homebridge, homebridge-deebot, homebridge-plugin, homekit, hoobs, hoobs-plugin, hoover, siri, vacuum
- Language: JavaScript
- Homepage:
- Size: 971 KB
- Stars: 72
- Watchers: 7
- Forks: 7
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
## homebridge-ecovacs
Homebridge plugin to integrate Ecovacs Deebot or Yeedi devices into HomeKit
[](https://www.npmjs.com/package/@homebridge-plugins/homebridge-ecovacs)
[](https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Beta-Version)
[](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)
[](https://plugins.hoobs.org/plugin/homebridge-ecovacs)
[](https://www.npmjs.com/package/@homebridge-plugins/homebridge-ecovacs)
[](https://discord.com/channels/432663330281226270/742733745743855627)
### Plugin Information
- This plugin allows you to view and control your Ecovacs or Yeedi devices within HomeKit. The plugin:
- requires your Ecovacs or Yeedi credentials to function
- uses a cloud-based connection (i.e. requires the internet)
> I'm looking for some lovely people to help maintain this plugin, please get in touch on GitHub or Discord if you'd like to help out 😄
### Prerequisites
- To use this plugin, you will need to already have:
- [Node](https://nodejs.org): latest version of `v22` or `v24` - any other major version is not supported.
- [Homebridge](https://homebridge.io): `v1.6` - refer to link for more information and installation instructions.
### Setup
- [Installation](https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Installation)
- [Configuration](https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Configuration)
- [Beta Version](https://github.com/homebridge/homebridge/wiki/How-to-Install-Alternate-Plugin-Versions)
- [Node Version](https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Node-Version)
### Features
- [Supported Devices](https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Supported-Devices)
- [Speed Control](https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Speed-Control)
- [Predefined Areas](https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Predefined-Areas)
### Help/About
- [Common Errors](https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Common-Errors)
- [Support Request](https://github.com/homebridge-plugins/homebridge-ecovacs/issues/new/choose)
- [Changelog](https://github.com/homebridge-plugins/homebridge-ecovacs/blob/latest/CHANGELOG.md)
- [About Me](https://github.com/sponsors/bwp91)
### Credits
- To the owner of [ecovacs-deebot.js](https://github.com/mrbungle64/ecovacs-deebot.js) client: [@mrbungle64](https://github.com/mrbungle64).
- To the owner of [homebridge-deebotEcovacs](https://github.com/nicoduj/homebridge-deebotEcovacs): [@nicoduj](https://github.com/nicoduj).
- To the creator of the awesome plugin header logo: [Keryan Belahcene](https://www.instagram.com/keryan.me).
- To the creators/contributors of [Homebridge](https://homebridge.io) who make this plugin possible.
### Disclaimer
- I am in no way affiliated with Ecovacs/Deebot/Yeedi and this plugin is a personal project that I maintain in my free time.
- Use this plugin entirely at your own risk - please see licence for more information.