Add language support to README.md

.github/workflows/npm.yml

@@ -1,19 +0,0 @@
-name: npm
-on:
-  workflow_dispatch:
-  release:
-    types: [created]
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@v2
-    # Setup .npmrc file to publish to npm
-    - uses: actions/setup-node@v2
-      with:
-        node-version: '12.x'
-        registry-url: 'https://registry.npmjs.org'
-    - run: npm install
-    - run: npm publish
-      env:
-        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

CHANGELOG.md

@@ -118,18 +118,5 @@
 ## 0.7.2
 * Fixed homebridge crash with multiple robots per account
 
-## 0.8.0
+## 0.7.3
-* Add German plugin language (for example, this gives you a "Sauge Küche" Siri command for a zone called "Küche")
+* Fixed warnings since homebridge 1.3.0
-* Added possibility to toggle between languages (English/German) in Homebridge UI Plugin Settings
-
-## 0.8.1
-* Include Robot name in Homekit battery service name
-
-## 0.8.2
-* Eliminate warnings on Homebridge >= 1.3.0 (77945f8 and 877c3d7 on `naofireblade/homebridge-neato`)
-
-## 0.8.3
-* Add French plugin language (for example, this gives you a "Aspirer la cuisine" Siri command for a zone called "La cuisine")
-
-## 0.8.4
-* Link to token getter tool in homebridge UI 

LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2020 Luis Riegger
+Copyright (c) 2017 Arne Blumentritt
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,14 +1,15 @@
-[![Latest NPM release](https://img.shields.io/npm/v/homebridge-kobold.svg)](https://www.npmjs.com/package/homebridge-kobold)
+# homebridge-neato
-[![NPM Downloads](https://img.shields.io/npm/dt/homebridge-kobold.svg)](https://www.npmjs.com/package/homebridge-kobold?activeTab=versions)
+[![npm](https://img.shields.io/npm/v/homebridge-neato)](https://www.npmjs.com/package/homebridge-neato)
+[![npm](https://img.shields.io/npm/dt/homebridge-neato)](https://www.npmjs.com/package/homebridge-neato?activeTab=versions)
+[![GitHub last commit](https://img.shields.io/github/last-commit/naofireblade/homebridge-neato)](https://github.com/naofireblade/homebridge-neato)
 
+This is a plugin for [homebridge](https://github.com/nfarina/homebridge) to control your [Neato](https://www.neatorobotics.com/) vacuum robot. You can download it via [npm](https://www.npmjs.com/package/homebridge-neato).
 
-# homebridge-kobold
+If you like this plugin and find it useful, I would be forever grateful for your support:
 
-This is a plugin for [homebridge](https://github.com/nfarina/homebridge) to control your [Vorwerk Kobold](https://kobold.vorwerk.de/saugroboter/) VR300 vacuum robot. You can download it via [npm](https://www.npmjs.com/package/homebridge-kobold).
+<a href="https://www.buymeacoffee.com/naofireblade" target="_blank"><img width="140" src="https://bmc-cdn.nyc3.digitaloceanspaces.com/BMC-button-images/custom_images/orange_img.png" alt="Buy Me A Coffee"></a>
 
-It is based on a fork of naofireblade's [homebridge-neato](https://github.com/naofireblade/homebridge-neato), merged with the oAuth authentication mechanism from nicoh88's [homebridge-vorwerk](https://github.com/nicoh88/homebridge-vorwerk).
+Feel free to leave any feedback [here](https://github.com/naofireblade/homebridge-neato/issues).
-
-The interaction with the Server is handled by the underlying [node-kobold-control](https://github.com/himbeles/node-kobold-control) module.
 
 ## Features
 
@@ -16,10 +17,10 @@ The interaction with the Server is handled by the underlying [node-kobold-contro
   - Eco mode
   - Extra care navigation
   - Nogo lines
-- Zone cleaning <sup>[1](#change-room)</sup>
+- Zone cleaning <sup>[1](#d7)</sup><sup>, </sup><sup>[2](#change-room)</sup>
 - Spot cleaning
-  - Individual spot size <sup>[2](#eve)</sup>
+  - Individual spot size <sup>[1](#d7)</sup><sup>, </sup><sup>[3](#eve)</sup>
-  - Clean twice <sup>[2](#eve)</sup>
+  - Clean twice <sup>[3](#eve)</sup>
 - Return to dock
 - Find the robot
 - Schedule (de)activation
@@ -30,8 +31,9 @@ The interaction with the Server is handled by the underlying [node-kobold-contro
   - Model and firmware version
 - Automatic or periodic refresh of robot state
 - Multiple robots
+- Multiple language support (en, de, fr)
 
-- German, English or French Language Setting
+> <b name="d7">1</b> Only available on the Neato D7.  
 
 > <b name="change-room">2</b> You can send the robot from one room to another as well. He will return to the base, wait there some seconds and then starts cleaning the next room.
 
@@ -42,65 +44,27 @@ The interaction with the Server is handled by the underlying [node-kobold-contro
 ## Installation
 
 1. Install homebridge using: `npm install -g homebridge`
-2. Install this plugin using: `npm install -g homebridge-kobold`
+2. Install this plugin using: `npm install -g homebridge-neato`
-3. Update your configuration file. See the sample below.
+3. If you don't have a Neato account yet, create one [here](https://www.neatorobotics.com/create-account/).
+4. Update your configuration file. See the sample below.
 
 ## Configuration
 
-Add the following information to your config file. Adapt the value for `token`.
+Add the following information to your config file. Change the values for email and password.
 
 ### Simple
 
 ```json
 "platforms": [
-  {
+	{
-    "platform": "KoboldVacuumRobot",
+		"platform": "NeatoVacuumRobot",
-    "token": "YourToken",
+		"email": "YourEmail",
-    "language": "de"
+		"password": "YourPassword",
-  }
+		"language": "de"
+	}
 ]
 ```
 
-You can get a token using the GUI tool [Kobold Token Getter](https://github.com/himbeles/kobold-token-get) or using the following two curl commands:
-
-```bash
-# This will trigger the email sending
-curl -X "POST" "https://mykobold.eu.auth0.com/passwordless/start" \
-     -H 'Content-Type: application/json' \
-     -d '{
-  "send": "code",
-  "email": "ENTER_YOUR_EMAIL_HERE",
-  "client_id": "KY4YbVAvtgB7lp8vIbWQ7zLk3hssZlhR",
-  "connection": "email"
-}'
-```
-==== wait for the email to be received ====
-
-```bash
-# this will generate a token using the numbers you received via email
-# replace the value of otp 123456 with the value you received from the email
-curl -X "POST" "https://mykobold.eu.auth0.com/oauth/token" \
-     -H 'Content-Type: application/json' \
-     -d '{
-  "prompt": "login",
-  "grant_type": "http://auth0.com/oauth/grant-type/passwordless/otp",
-  "scope": "openid email profile read:current_user",
-  "locale": "en",
-  "otp": "123456",
-  "source": "vorwerk_auth0",
-  "platform": "ios",
-  "audience": "https://mykobold.eu.auth0.com/userinfo",
-  "username": "ENTER_YOUR_EMAIL_HERE",
-  "client_id": "KY4YbVAvtgB7lp8vIbWQ7zLk3hssZlhR",
-  "realm": "email",
-  "country_code": "DE"
-}'
-```
-
-From the output, you want to copy the `id_token` value.
-
-The `language` can be `de` for German, `en` for English, or `fr` for French.
-
 ### Advanced
 
 Below are explanations for advanced parameters to adjust the plugin to your needs. All parameters are *optional*.
@@ -116,16 +80,24 @@ List of plugin features that you don't want to use in homekit (e.g. `dock`, `doc
 
 ```json
 "platforms": [
-  {
+	{
-    "platform": "KoboldVacuumRobot",
+		"platform": "NeatoVacuumRobot",
-    "token": "YourToken",
+		"email": "YourEmail",
-    "refresh": "120",
+		"password": "YourPassword",
-    "hidden": ["dock", "dockstate", "eco", "nogolines", "extracare", "schedule", "find", "spot"],
+		"language": "de",
-    "language": "de"
+		"refresh": "120",
-  }
+		"hidden": ["dock", "dockstate", "eco", "nogolines", "extracare", "schedule", "find", "spot"]
+	}
 ]
 ```
 
 ## Tested robots
 
-- Vorwerk Kobold VR300
+The plugin is successfully tested with all Neato Connected Robots.
+
+## Contributors
+Many thanks go to
+- [ghulands](https://github.com/ghulands) for finding and fixing a bug when no robot is associated with the neato account
+- [Berkay](https://github.com/btutal) for adding the schema file to use the plugin with homebridge-config-ui-x
+- [Antoine de Maleprade](https://github.com/az0uz) for adding the zone cleaning feature
+- [DJay](https://github.com/DJay-X) for testing out tons of new beta versions

_config.yml

@@ -0,0 +1 @@
+theme: jekyll-theme-cayman

accessories/neatoVacuumRobot.js

@@ -1,4 +1,4 @@
-const debug = require('debug')('homebridge-kobold');
+const debug = require('debug')('homebridge-neato');
 const colors = require('colors');
 
 const CustomUUID = {
@@ -21,10 +21,10 @@ module.exports = function (_Service, _Characteristic)
 	SpotHeightCharacteristic = require('../characteristics/spotHeight')(Characteristic, CustomUUID);
 	SpotRepeatCharacteristic = require('../characteristics/spotRepeat')(Characteristic, CustomUUID);
 
-	return KoboldVacuumRobotAccessory;
+	return NeatoVacuumRobotAccessory;
 };
 
-function KoboldVacuumRobotAccessory(platform, robotObject)
+function NeatoVacuumRobotAccessory(platform, robotObject)
 {
 	this.platform = platform;
 	this.log = platform.log;
@@ -136,13 +136,12 @@ function KoboldVacuumRobotAccessory(platform, robotObject)
 			serviceName = this.dict["clean"] + " " + this.boundary.name;
 		}
 		this.cleanService = new Service.Switch(serviceName, "cleanBoundary:" + this.boundary.id);
-		this.cleanService = new Service.Switch(serviceName + "1", "cleanBoundary:" + this.boundary.id)
 	}
 
 	this.log("Added cleaning device named: " + this.name);
 }
 
-KoboldVacuumRobotAccessory.prototype = {
+NeatoVacuumRobotAccessory.prototype = {
 	identify: function (callback)
 	{
 		this.robot.getState((error, result) =>
@@ -164,7 +163,7 @@ KoboldVacuumRobotAccessory.prototype = {
 	{
 		this.informationService = new Service.AccessoryInformation();
 		this.informationService
-		.setCharacteristic(Characteristic.Manufacturer, "Vorwerk Deutschland Stiftung & Co. KG")
+		.setCharacteristic(Characteristic.Manufacturer, "Neato Robotics")
 		.setCharacteristic(Characteristic.Model, this.meta.modelName)
 		.setCharacteristic(Characteristic.SerialNumber, this.robot._serial)
 		.setCharacteristic(Characteristic.FirmwareRevision, this.meta.firmware)
@@ -282,7 +281,6 @@ KoboldVacuumRobotAccessory.prototype = {
 					// Start cleaning
 					else if (this.robot.canStart)
 					{
-						debug(this.name + ": ## Start cleaning");
 						this.clean(callback);
 					}
 					// Cannot start

config.schema.json

@@ -1,15 +1,22 @@
 {
-    "pluginAlias": "KoboldVacuumRobot",
+    "pluginAlias": "NeatoVacuumRobot",
     "pluginType": "platform",
-    "headerDisplay": "For Advanced settings like the refresh time interval or disabled switches/sensors. [Check Here](https://github.com/himbeles/homebridge-kobold#readme)",
+    "headerDisplay": "For Advanced settings like Refresh time interval or Disabled switches/sensors. [Check Here](https://github.com/naofireblade/homebridge-neato#readme)",
     "schema": {
       "type": "object",
       "properties": {
-        "token": {
+        "email": {
-            "title": "token",
+          "title": "email",
+          "type": "string",
+          "required": true,
+          "format": "email",
+          "description": "Your Email Address"
+        },
+        "password": {
+            "title": "password",
             "type": "string",
             "required": true,
-            "description": "Your Kobold Token (https://git.io/J3g1b)"
+            "description": "Your Password"
         },
         "language": {
           "title": "language",

index.js

@@ -1,25 +1,26 @@
 "use strict";
 let inherits = require('util').inherits,
-	debug = require('debug')('homebridge-kobold'),
+	debug = require('debug')('homebridge-neato'),
-	control = require('node-kobold-control'),
+	botvac = require('node-botvac'),
 
 	Service,
 	Characteristic,
-	KoboldVacuumRobotAccessory;
+	NeatoVacuumRobotAccessory;
 
 module.exports = function (homebridge)
 {
 	Service = homebridge.hap.Service;
 	Characteristic = homebridge.hap.Characteristic;
-	KoboldVacuumRobotAccessory = require('./accessories/koboldVacuumRobot')(Service, Characteristic);
+	NeatoVacuumRobotAccessory = require('./accessories/neatoVacuumRobot')(Service, Characteristic);
-	homebridge.registerPlatform("homebridge-kobold", "KoboldVacuumRobot", KoboldVacuumRobotPlatform);
+	homebridge.registerPlatform("homebridge-neato", "NeatoVacuumRobot", NeatoVacuumRobotPlatform);
 };
 
-function KoboldVacuumRobotPlatform(log, config)
+function NeatoVacuumRobotPlatform(log, config)
 {
 	this.log = log;
 	this.serial = "1-3-3-7";
-	this.token = config['token'];
+	this.email = config['email'];
+	this.password = config['password'];
 	this.language = config['language'];
 	this.hiddenServices = '';
 	this.hiddenServices = ('disabled' in config ? config['disabled'] : this.hiddenServices);
@@ -35,10 +36,10 @@ function KoboldVacuumRobotPlatform(log, config)
 		this.refresh = parseInt(config['refresh']);
 		// must be integer and positive
 		this.refresh = (typeof this.refresh !== 'number' || (this.refresh % 1) !== 0 || this.refresh < 0) ? 60 : this.refresh;
-		// minimum 60s to save some load on the Vorwerk servers
+		// minimum 60s to save some load on the neato servers
 		if (this.refresh > 0 && this.refresh < 60)
 		{
-			this.log.warn("Minimum refresh time is 60 seconds to not overload the Vorwerk servers");
+			this.log.warn("Minimum refresh time is 60 seconds to not overload the neato servers");
 			this.refresh = (this.refresh > 0 && this.refresh < 60) ? 60 : this.refresh;
 		}
 	}
@@ -50,7 +51,7 @@ function KoboldVacuumRobotPlatform(log, config)
 	this.log("Refresh is set to: " + this.refresh + (this.refresh !== 'auto' ? ' seconds' : ''));
 }
 
-KoboldVacuumRobotPlatform.prototype = {
+NeatoVacuumRobotPlatform.prototype = {
 	accessories: function (callback)
 	{
 		debug("Get robots");
@@ -60,8 +61,8 @@ KoboldVacuumRobotPlatform.prototype = {
 		this.getRobots(() =>
 		{
 			// // MOCK MULTIPLE ROBOTS START
-			// let client = new control.Client();
+			// let client = new botvac.Client();
-			// client.authorize(this.token, (error) =>
+			// client.authorize(this.email, this.password, false, (error) =>
 			// {
 			// 	client.getRobots((error, robs) =>
 			// 	{
@@ -76,7 +77,7 @@ KoboldVacuumRobotPlatform.prototype = {
 						{
 							this.log("Found robot #" + (i + 1) + " named \"" + robot.device.name + "\" with serial \"" + robot.device._serial.substring(0, 9) + "XXXXXXXXXXXX\"");
 
-							let mainAccessory = new KoboldVacuumRobotAccessory(this, robot);
+							let mainAccessory = new NeatoVacuumRobotAccessory(this, robot);
 							accessories.push(mainAccessory);
 
 							robot.mainAccessory = mainAccessory;
@@ -87,7 +88,7 @@ KoboldVacuumRobotPlatform.prototype = {
 
 							// // MOCK ZONE CLEANING START
 							// robot.boundary = {name: "Testroom", id: "1"};
-							// let roomAccessory = new KoboldVacuumRobotAccessory(this, robot);
+							// let roomAccessory = new NeatoVacuumRobotAccessory(this, robot);
 							// accessories.push(roomAccessory);
 							// robot.roomAccessories.push(roomAccessory);
 							// // MOCK ZONE CLEANING END
@@ -103,7 +104,7 @@ KoboldVacuumRobotPlatform.prototype = {
 											if (boundary.type === "polygon")
 											{
 												robot.boundary = boundary;
-												let roomAccessory = new KoboldVacuumRobotAccessory(this, robot);
+												let roomAccessory = new NeatoVacuumRobotAccessory(this, robot);
 												accessories.push(roomAccessory);
 
 												robot.roomAccessories.push(roomAccessory);
@@ -126,14 +127,14 @@ KoboldVacuumRobotPlatform.prototype = {
 	getRobots: function (callback)
 	{
 		debug("Loading your robots");
-		let client = new control.Client();
+		let client = new botvac.Client();
 
 		// Login
-		client.authorize(this.token, (error) =>
+		client.authorize(this.email, this.password, false, (error) =>
 		{
 			if (error)
 			{
-				this.log.error("Can't log on to Vorwerk cloud. Please check your internet connection and your token. Try again later if the Vorwerk servers have issues: " + error);
+				this.log.error("Can't log on to neato cloud. Please check your internet connection and your credentials. Try again later if the neato servers have issues: " + error);
 				callback();
 			}
 			else
@@ -143,7 +144,7 @@ KoboldVacuumRobotPlatform.prototype = {
 				{
 					if (error)
 					{
-						this.log.error("Successful login but can't connect to your Vorwerk robot: " + error);
+						this.log.error("Successful login but can't connect to your neato robot: " + error);
 						callback();
 					}
 					else if (robots.length === 0)

package.json

@@ -1,35 +1,43 @@
 {
-  "name": "homebridge-kobold",
+  "name": "homebridge-neato",
-  "version": "0.8.4",
+  "version": "0.7.3",
-  "description": "A Vorwerk Kobold vacuum robot plugin for homebridge.",
+  "description": "A Neato vacuum robot plugin for homebridge.",
   "license": "MIT",
   "keywords": [
     "homebridge-plugin",
-    "vorwerk",
+    "neato",
-    "kobold"
+    "botvac"
   ],
   "engines": {
     "node": ">=0.12.0",
     "homebridge": ">=0.2.0"
   },
   "author": {
-    "name": "Luis R.",
+    "name": "Arne Blumentritt",
-    "url2": "https://github.com/himbeles"
+    "url2": "https://github.com/naofireblade"
   },
   "contributors": [
     {
-      "name": "Alexandre L.",
+      "name": "ghulands",
-      "url": "https://github.com/aluini"
+      "url": "https://github.com/ghulands"
+    },
+    {
+      "name": "Berkay",
+      "url": "https://github.com/btutal"
+    },
+    {
+      "name": "Antoine de Maleprade",
+      "url": "https://github.com/az0uz"
     }
   ],
   "repository": {
     "type": "git",
-    "url": "git://github.com/himbeles/homebridge-kobold.git"
+    "url": "git://github.com/naofireblade/homebridge-neato.git"
   },
   "dependencies": {
     "colors": "^1.4.0",
     "debug": "^4.1.1",
-    "node-kobold-control": ">=0.4.2",
+    "node-botvac": ">=0.4.0",
     "uuid": "^3.3.2"
   }
 }