homebridge-irobot
Version:
A homebridge plugin for controlling iRobot devices
96 lines (70 loc) • 4.29 kB
Markdown
<p align="center">
<a href="https://github.com/bloomkd46/homebridge-iRobot"><img alt="Homebridge iRobot" src="https://user-images.githubusercontent.com/75853497/143301930-e2f3bc9a-9f0d-4e03-95f8-c69769712ca5.png" width="600px"></a>
</p>
<span align="center">
# homebridge-iRobot
Homebridge plugin to integrate iRobot roombas into HomeKit
(Wiki Links Don't Work Yet)
[](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)
[](https://npmcharts.com/compare/homebridge-irobot?log=true&interval=1&minimal=true)
[](https://www.npmjs.com/package/homebridge-irobot)
[](../../wiki/Beta-Version)
[](../../actions/workflows/build.yml)
[](/LICENSE)
</span>
### 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](https://github.com/bloomkd46/homebridge-iRobot/issues/new?assignees=bloomkd46&labels=enchancment&template=add-supported-device.yml&title=Supported+Device%3A+)
| Model | Supported | Reported By |
|-|-|-|
| braava jet m6 | No | [ghazel](https://github.com/ghazel) |
| J7 | No | [spurzack](https://github.com/spurzack) |
| j7 | No | [franciswernet](https://github.com/franciswernet) |
| j7 | No | [franciswernet](https://github.com/franciswernet) |
| j7 | No | [VinceBab](https://github.com/VinceBab) |
| i7 | Yes | [Clouder59](https://github.com/Clouder59) |
| 606 | No | [PvdGulik](https://github.com/PvdGulik) |
| Braava m6 | No | [Jer-emy](https://github.com/Jer-emy) |
| m6 | Yes | [ginoledesma](https://github.com/ginoledesma) |
| j7 | Yes | [ginoledesma](https://github.com/ginoledesma) |
| i3 | No | [rminear68](https://github.com/rminear68) |
| 980 | No | [jeanchrijaz](https://github.com/jeanchrijaz) |
| i9 | Yes | [douginoz](https://github.com/douginoz) |
| 960 | Yes | [NateUT99](https://github.com/NateUT99) |
| 965 | Yes | [bloomkd46](https://github.com/bloomkd46) |
| i8 | Yes | [bloomkd46](https://github.com/bloomkd46) |
## Features:
- [x] Approved By Homebridge
- [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
## TODO:
- [ ] Add ability for rooms to show up with names instead of id number
### Prerequisites
- To use this plugin, you will need to already have [Homebridge](https://homebridge.io) (at least v1.3.5) or [HOOBS](https://hoobs.org) (at least v4) installed. Refer to the links for more information and installation instructions.
### Setup
- [Installation](../../wiki/Installation)
- [Configuration](../../wiki/Configuration)
- [Beta Version](../../wiki/Beta-Version)
- [Node Version](../../wiki/Node-Version)
- [Uninstallation](../../wiki/Uninstallation)
### Help/About
- [Common Errors](../../wiki/Common-Errors)
- [Support Request](../../issues/new/choose)
- [Changelog](/CHANGELOG.md)
### Credits
- To the creators/contributors of [Homebridge](https://homebridge.io) who make this plugin possible.
- To [homebridge-Meross](https://github.com/bwp91/homebridge-meross) of which I based this readme, wiki, and homebridge-ui off of
- To [Dorita980](https://github.com/koalazak/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.