homebridge-iRobot-v2

A Homebridge plugin to integrate iRobot Roombas into HomeKit.

This plugin is based on homebridge-IRobot, but since this plugin has not gotten any updates for a long time, I decided to create a new plugin based on the old one. This plugin is not compatible with the old one, so you have to remove the old plugin and install this one. The general idea for this new plugin is to make fix reported bugs and keep it up to date where necessary.

Once the latest iOS 18 update is released, I will update the plugin to support the new features (if possible).

Plugin Information

• This plugin allows you to view and control your iRobot roombas within HomeKit. The plugin:
  • downloads a device list if your iRobot credentials are supplied
  • controls your devices locally
  • listens for real-time device updates when controlled externally

Supported Devices

Don't See Your Device Below? Let Me Know If It Worked By Filling Out This Template

| Model | Supported | Reported By | |-----------|-----------|---------------------------------------------------| | i7 | Yes | Clouder59 | | 606 | No | PvdGulik | | 698 | No | jojoballa | | Braava m6 | Yes | taurgis | | m6 | Yes | ginoledesma | | j7 | Yes | ginoledesma | | j7 Combo | Yes | tomadimitrie | i3 | yes | taurgis | | 980 | No | jeanchrijaz | | i9 | Yes | douginoz | | s9+ | Yes | bigadron. | | 960 | No | MathiasBrendel | | 965 | Yes | bloomkd46 | | 965 | Yes | bloomkd46 | | i8 | Yes | bloomkd46 | | y0 | No | Oloman2A |

Features:

• [x] Custom UI For Viewing Devices
• [x] On/Off Control
• [x] Room-By-Room Control On Models That Support It (Only Tested When Using One Map)
• [x] Auto-Dicovery Of All Devices On Your Acount
• [x] Battery Percent/Charging ifo
• [x] Binfull Detection In The Form Of Filter/Contact/Motion Sensor
• [x] Stuck Sensor
• [x] Verified By Homebridge

TODO:

• [ ] Support iOS 18 Features

Prerequisites

• To use this plugin, you will need to already have Homebridge (at least v1.3.5) or HOOBS (at least v4) installed. Refer to the links for more information and installation instructions.

Setup

• Installation
• Configuration
• Beta Version
• Node Version
• Uninstallation

Help/About

• Common Errors
• Support Request
• Changelog

Credits

• To the creators/contributors of Homebridge who make this plugin possible.
• To homebridge-Meross of which I based this readme, wiki, and homebridge-ui off of
• To homebridge-IRobot which this plugin is based off of
• To Dorita980 Who cracked the iRobot API

Disclaimer

• I am in no way affiliated with iRobot 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.