https://github.com/simonbs/roomba
Node module for controlling a Roomba vacuum cleaner.
https://github.com/simonbs/roomba
homeautomation irobot roomba smarthome
Last synced: 28 days ago
JSON representation
Node module for controlling a Roomba vacuum cleaner.
- Host: GitHub
- URL: https://github.com/simonbs/roomba
- Owner: simonbs
- Created: 2017-01-15T19:20:22.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2017-01-28T19:02:32.000Z (over 9 years ago)
- Last Synced: 2025-03-21T06:29:27.322Z (about 1 year ago)
- Topics: homeautomation, irobot, roomba, smarthome
- Language: JavaScript
- Size: 2.93 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# roomba
Node module for controlling a Roomba vacuum cleaner. Tested with a Roomba 960 but is expected to work with the entire 900 series.
## Installation
Install using `npm install --save git+ssh://git@github.com/simonbs/roomba.git`
## Finding your blid, robotpwd and asset ID
The blid, robotpwd and asset ID are used to identify your Roomba and authorize API calls. In order to find these values, you must inspect the HTTP requests made by the Roomba iOS app.
I recommend using [Charles](https://www.charlesproxy.com) for this. The following will assume you are comfortable with Charles.
1. Open up Charles and configure the proxy on your iOS device in the WiFi settings.
2. Open the Roomba iOS app and make sure you have recorded some calls to `https://irobot.axeda.com` in Charles. In particular, you should have recorded requests to `https://irobot.axeda.com/services/v1/rest/Scripto/execute/AspenApiRequest`.
3. Find one of the requests and browse the contents of the request, e.g. in the raw format. The body of the request will contain your blid and robotpwd. There will be a header named `ASSET-ID` containing your asset ID.