Skip to content
A Neato vacuum robot plugin for homebridge.
JavaScript
Branch: master
Clone or download
Latest commit 0338580 Aug 14, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore Added gitignore Jul 20, 2019
CHANGELOG.md Version 0.6.3 Aug 14, 2019
LICENSE Initial commit Apr 17, 2017
README.md Added contributor and bumped version to v0.6.0 Jul 14, 2019
_config.yml Set theme jekyll-theme-cayman Apr 30, 2017
config.schema.json Add Schema for Config Apr 8, 2019
index.js Fixed homebridge crash when 2 zones have the same name Aug 14, 2019
package.json Version 0.6.3 Aug 14, 2019

README.md

homebridge-neato

npm npm GitHub last commit

This is a plugin for homebridge to control your Neato vacuum robot. You can download it via npm.

Feel free to leave any feedback here.

Features

  • Start and pause cleaning
  • Return to dock
  • Scheduling
  • Eco mode
  • Extra care navigation
  • Nogo lines
  • Zone cleaning
  • Get battery info
  • Get dock info
  • Periodic refresh of robot state
  • Support for multiple robots

Installation

  1. Install homebridge using: npm install -g homebridge
  2. Install this plugin using: npm install -g homebridge-neato
  3. If you don't have a Neato account yet create one here.
  4. Update your configuration file. See the sample below.

Configuration

Add the following information to your config file. Change the values for email and password.

Simple

"platforms": [
	{
		"platform": "NeatoVacuumRobot",
		"email": "YourEmail",
		"password": "YourPassword"
	}
]

Advanced

The following config contains advanced optional settings.

The parameter refresh sets an interval in seconds that is used to update the robot state in the background. This is only required for automations based on the robot state. The default value is auto which means that the update is automatically enabled while cleaning and disabled while not cleaning. You can set a value in seconds e.g. 120 to enable background updates even when the robot is not cleaning. You can also disable background updates completely by setting the value 0. This might be required if you experience timeouts in the app because you have other home automation apps that are connected to your robot.

The parameter disabled accepts a list of switches/sensors that can be disabled in the neato homekit plugin (e.g. dock, dockstate, eco, schedule).

"platforms": [
	{
		"platform": "NeatoVacuumRobot",
		"email": "YourEmail",
		"password": "YourPassword",
		"refresh": "120",
		"disabled": ["dock", "dockstate", "eco", "nogolines", "extracare", "schedule"]
	}
]

Tested robots

  • BotVac Connected (Firmware 2.2.0)
  • BotVac D3 Connected
  • BotVac D5 Connected (Firmware 4.0.0, 4.3.0)
  • BotVac D7 Connected

The plugin should work with D4 and D6 as well. If you have connected neato robot, please tell me about your experience with this plugin.

Contributors

Many thanks go to

  • ghulands for finding and fixing a bug when no robot is associated with the neato account
  • Berkay for adding the schema file to use the plugin with homebridge-config-ui-x
  • Antoine de Maleprade for adding the zone cleaning feature
You can’t perform that action at this time.