{"id":25912925,"url":"https://github.com/matthijs2704/homebridge-thinkingcleaner","last_synced_at":"2025-10-30T10:42:19.960Z","repository":{"id":57266163,"uuid":"49199418","full_name":"matthijs2704/homebridge-thinkingcleaner","owner":"matthijs2704","description":"Thinking Cleaner plugin for Homebridge","archived":false,"fork":false,"pushed_at":"2016-01-24T11:17:57.000Z","size":10,"stargazers_count":5,"open_issues_count":0,"forks_count":2,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-02-15T17:38:02.292Z","etag":null,"topics":["homebridge","homekit","roomba","siri"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/matthijs2704.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-01-07T10:59:29.000Z","updated_at":"2024-05-31T08:38:11.000Z","dependencies_parsed_at":"2022-08-25T03:40:56.584Z","dependency_job_id":null,"html_url":"https://github.com/matthijs2704/homebridge-thinkingcleaner","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matthijs2704%2Fhomebridge-thinkingcleaner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matthijs2704%2Fhomebridge-thinkingcleaner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matthijs2704%2Fhomebridge-thinkingcleaner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matthijs2704%2Fhomebridge-thinkingcleaner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/matthijs2704","download_url":"https://codeload.github.com/matthijs2704/homebridge-thinkingcleaner/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241465105,"owners_count":19967244,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["homebridge","homekit","roomba","siri"],"created_at":"2025-03-03T10:17:28.746Z","updated_at":"2025-10-30T10:42:14.927Z","avatar_url":"https://github.com/matthijs2704.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Thinking Cleaner for Homebridge\n\nHomebridge is a lightweight NodeJS server you can run on your home network that emulates the iOS HomeKit API. [Learn more about Homebridge](https://github.com/nfarina/homebridge)\n\nThis is a plugin to control your Thinking Cleaner via HomeKit. [Learn more about Thinking Cleaner.](http://thinkingcleaner.com)\nSince Siri supports devices added through HomeKit, this means that with Homebridge you can ask Siri to control your Thinking Cleaner! For example you can say _`Siri, turn Dusty on.`_ and your Roomba will start cleaning!\n\nOr you can use a Homekit app for iOS to create scenes and start claning your house when you say: \n\n * _Siri, I'm leaving._\n \nThe possibilities are endless!\n \n# Installation\n\n### Homebridge\nIf you haven't installed Homebridge yet, use these steps on the Homebridge page to get it up and running: [Learn more about the Homebridge installation](https://github.com/nfarina/homebridge)\n\n### Thinking Cleaner plugin\n\nFirst of all we are going to install the Thinking Cleaner plugin by executing:\n\n    sudo npm install -g homebridge-thinkingcleaner\n\nAs easy as that! Now let's configure the plugin.\n\n# Configuration\n\n**We expect you have created a `config.json` already using the steps on the [Homebridge](https://github.com/nfarina/homebridge) page**\n\nNow we are going to add the Thinking Cleaner accessory to the `config.json` file. In the `config.json` add the following to the `accessories` section:\n\n```JSON\n{\n    \"accessory\": \"Roomba\",\n    \"name\": \"Dusty\",\n    \"ip_address\": \"127.0.0.1\",\n\t\"dock_on_stop\": \"true\"\n}   \n```\n\nFor example:\n ```JSON\n\"accessories\": [\n    {\n        \"accessory\": \"Roomba\",\n        \"name\": \"Dusty\",\n        \"ip_address\": \"127.0.0.1\",\n\t\t\"dock_on_stop\": \"true\"\n    }   \n]\n```\n\nReplace `Dusty` with the name you gave your Thinking Cleaner during setup. (You don't necessarily have to enter the same name as you entered during setup, but it's recommended). *_This is also the name Siri will use for control_*\n\nIf you do not know the IP address of your Thinking Cleaner, simply leave it blank and your Thinking Cleaner will be discovered automatically.\n**NOTE**: When you have multiple Thinking Cleaner devices, you **must** fill in the IP address\n\nIf you want to disable docking when you stop (or 'turn off' your Roomba using Siri/HomeKit) change `dock_on_stop` to `false`. When you do so, your Roomba will just stay at the location where it currently is when you stop it.\n\n# Using\n\nNow you should be able to run Homebridge again and the Thinking Cleaner plugin ready for usage:\n\n    $ homebridge\n    Loaded plugin: homebridge-thinkingcleaner\n    Registering accessory 'homebridge-thinkingcleaner.Roomba'\n    ---\n    Loaded config.json with 1 accessories and 0 platforms.\n    ---\n    Loading 0 platforms...\n    Loading 1 accessories...\n    [Dusty] Initializing Roomba accessory...\n\nHomebridge is now ready to receive commands to control your Thinking Cleaner via HomeKit!\n\n**Siri note**: The way I added the Thinking Cleaner to HomeKit is by pretending the Thinking Cleaner is a switch: turn on to start cleaning and turn off to stop and dock. Note that you can't say _`Siri, start cleaning.`_ as HomeKit doesn't support (robot) vacuum cleaners (yet)\n\n# License\nThe MIT License (MIT)\n\nCopyright (c) 2016 Matthijs Logemann\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n- Roomba is a trademark of iRobot Corporation\n- Thinking Cleaner is a product of Thinking Bits BV","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatthijs2704%2Fhomebridge-thinkingcleaner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatthijs2704%2Fhomebridge-thinkingcleaner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatthijs2704%2Fhomebridge-thinkingcleaner/lists"}