{"analyzedAt":"2023-01-04T20:53:59.614Z","collected":{"metadata":{"name":"@hoobs/roborock","scope":"hoobs","version":"0.7.5","description":"Xiaomi/Roborock plugin for HOOBS.","keywords":["hoobs-certified","category-climate","hoobs-plugin","roborock","xiaomi","mi robot","vacuum cleaner","roborock s50","roborock s55","roborock s5","roborock s5 max","xiaomi vacuum gen1","xiaomi vacuum gen2","xiaomi vacuum gen3","roborock s6","roborock t6","roborock t4","xiaowa lite c10","xiaowa c10","mi robot 1s"],"date":"2020-04-19T23:32:43.635Z","publisher":{"username":"mkellsy","email":"mkellsy@gmail.com"},"maintainers":[{"username":"pfy","email":"david.gunzinger@smoca.ch"},{"username":"mkellsy","email":"mkellsy@gmail.com"},{"username":"askovi","email":"contact@askovi.com"},{"username":"bobbyslope","email":"bobby@hoobs.org"}],"repository":{"type":"git","url":"git+https://github.com/hoobs-org/homebridge-roborock.git"},"links":{"npm":"https://www.npmjs.com/package/%40hoobs%2Froborock","bugs":"https://github.com/nicoh88/homebridge-xiaomi-roborock-vacuum/issues"},"license":"MIT","dependencies":{"miio-nicoh88":">=0.1.0","semver":"^7.1.2","system-sleep":"^1.3.6"},"releases":[{"from":"2022-12-05T00:00:00.000Z","to":"2023-01-04T00:00:00.000Z","count":0},{"from":"2022-10-06T00:00:00.000Z","to":"2023-01-04T00:00:00.000Z","count":0},{"from":"2022-07-08T00:00:00.000Z","to":"2023-01-04T00:00:00.000Z","count":0},{"from":"2022-01-04T00:00:00.000Z","to":"2023-01-04T00:00:00.000Z","count":0},{"from":"2021-01-04T00:00:00.000Z","to":"2023-01-04T00:00:00.000Z","count":0}],"readme":"# homebridge-roborock\nWith this plugin can you control the xiaomi vacuum robots as fan in your Apple Home App (HomeKit).\n\nThis plugin use the new [miio](https://github.com/aholstenson/miio) version 0.15.6 or newer, not like the old ones 0.14.1. Timeouts and API errors are a thing of the past!\n\n## Features\n* **Fan** as On-/Off-Switch. When switching off, directly back to the charging station.\n   * [Fanspeed levels](https://github.com/nicoh88/homebridge-xiaomi-roborock-vacuum/blob/master/models/speedmodes.js) adjustable via 3D Touch / Force Touch.\n* Battery status and condition in the device details. Low battery alert.\n* Pause switch (optional).\n* Occupancy sensor (similar to motion sensor) for dock status (optional).\n* Seconds Fan for water box modes (optional).\n\n## Confiruration\n- Example `config.json` with one vacuum and room cleaning:\n\n```\n\"accessories\": [\n {\n  \"accessory\": \"XiaomiRoborockVacuum\",\n  \"name\": \"Xiaomi Mi Robot Vaccum 1st Generation\",\n  \"ip\": \"192.168.1.150\",\n  \"token\": \"abcdef1234567890abcdef1234567890\",\n  \"pause\": false,\n  \"dock\": true,\n  \"waterBox\": false,\n  \"cleanword\": \"cleaning\",\n  \"rooms\": [\n    {\n      \"id\": 16,\n      \"name\": \"Livingroom\"\n    },\n    {\n      \"id\": 17,\n      \"name\": \"Kitchen\"\n    }\n  ]\n }\n],\n```\n\n- Example `config.json` with two vacuums:\n\n```\n\"accessories\": [\n {\n  \"accessory\": \"XiaomiRoborockVacuum\",\n  \"name\": \"Xiaomi Mi Robot Vaccum 1st Generation\",\n  \"ip\": \"192.168.1.150\",\n  \"token\": \"abcdef1234567890abcdef1234567890\",\n  \"pause\": false,\n  \"dock\": true,\n  \"waterBox\": false\n },\n {\n  \"accessory\": \"XiaomiRoborockVacuum\",\n  \"name\": \"Xiaomi Roborock S50 Vaccum 2nd Generation\",\n  \"ip\": \"192.168.1.151\",\n  \"token\": \"1234567890abcdef1234567890abcdef\",\n  \"pause\": false,\n  \"dock\": true,\n  \"waterBox\": false\n }\n],\n```\n\n## Optional parameters\n| Name of parameter | Default value | Notes |\n|---|---|---|\n| `pause` | false | when set to true, HomeKit shows an additional switch for \"pause\" - switch is on, when pause is possible |\n| `dock` | false |  when set to true, HomeKit shows an occupancy sensor, if robot is in the charging dock |\n| `waterBox` | false | when set to true, HomeKit shows an additional slider to control the amount of water released by the robot (only selected models like S5-Max). Currently in a beta state. |\n| `cleanword` | cleaning | used for autonaming the Roomselectors |\n| `rooms` | false | Array of ID / Name for a single Room. If set you have another switch for cleaning only this room |\n| `autoroom` | false | when set to true, Rooms will be generated from Robot. (only S6) |\n\n## AutoRoom Generation\nThis feature seems to be working only on the S6 Model.\nWe figured out this is why the Api call only delivers the mapping when the Rooms are named in the Xioami / Roborock App.\n\nSo when you have an S6 but not named the Rooms in your App this function will not work! Thanks @domeOo\n\n## Xiaomi Token\nTo use this plugin, you have to read the \"token\" of the xiaomi vacuum robots. Here are some detailed instructions:\n- :us::gb: - [python-miio - Getting started](https://python-miio.readthedocs.io/en/latest/discovery.html)\n- :de: - [Apple HomeKit Forum - HomeKit.Community](https://forum.smartapfel.de/forum/thread/370-xiaomi-token-auslesen/)\n- :de: - [Homematic-Guru.de](https://homematic-guru.de/xiaomi-vacuum-staubsauger-roboter-mit-homematic-steuern)"},"npm":{"downloads":[{"from":"2023-01-03T00:00:00.000Z","to":"2023-01-04T00:00:00.000Z","count":2},{"from":"2022-12-28T00:00:00.000Z","to":"2023-01-04T00:00:00.000Z","count":4},{"from":"2022-12-05T00:00:00.000Z","to":"2023-01-04T00:00:00.000Z","count":8},{"from":"2022-10-06T00:00:00.000Z","to":"2023-01-04T00:00:00.000Z","count":38},{"from":"2022-07-08T00:00:00.000Z","to":"2023-01-04T00:00:00.000Z","count":110},{"from":"2022-01-04T00:00:00.000Z","to":"2023-01-04T00:00:00.000Z","count":236}],"starsCount":0}},"evaluation":{"quality":{"carefulness":0.165,"tests":0,"health":0,"branding":0},"popularity":{"communityInterest":0,"downloadsCount":12.666666666666666,"downloadsAcceleration":-0.10384322678843226,"dependentsCount":0},"maintenance":{"releasesFrequency":0,"commitsFrequency":0,"openIssues":0,"issuesDistribution":0}},"score":{"final":0.1502868804193718,"detail":{"quality":0.10511502143193392,"popularity":0.006702787977944141,"maintenance":0.3325897091357462}}}