irbt 0.15.1

A Library to interact with irbt appliances

Library for irobot roomba cloud api

This library implements some parts of the irobot cloud api (to control the different robots of the company).

Supported devices:

It has only been tested with a roomba i7 and a braava M6

Quickstart

$ pip3 install irbt
$ export IRBT_LOGIN="[e-mail]"
$ export IRBT_PASSWORD="password"
$ irbt-cli.py -l # list rooms 
$ irbt-cli.py -c start -r 'roomid' # start cleaning the room corresponding to the id

Features

• login using gigya/irbt api
• associated robot list
• history
• maps api (as json)
• missions api
• mqtt start, pause, stop, dock, find
• cli

usage: cli.py [-h] [-m] [-M] [-e] [-t] [-d] [-c [CMD]] [-l] [-r [ROOM_IDS]]
              [-p] [-R] [-i [ROBOT_ID]] [-I] [-j] [-w]

optional arguments:
  -h, --help            show this help message and exit
  -m, --map             output current map
  -M, --missions        Missions history
  -e, --evachistory     Evac history
  -t, --timeline        Timeline
  -d, --debug-mqtt      debug-mqtt
  -c [CMD], --cmd [CMD]
                        cmd for the robot (start, stop, dock, pause)
  -l, --list-rooms      List rooms
  -r [ROOM_IDS], --room-ids [ROOM_IDS]
                        room ids to clean
  -p, --robot-password  Show robot password
  -R, --robots          List robots
  -i [ROBOT_ID], --robot-id [ROBOT_ID]
                        Specify robot id
  -I, --robot-infos     Show robot infos
  -j, --output-json     Output as Json if possible
  -w, --raw             Output Raw Json (from server api) if possible

Install the dependencies

pip3 install -r requirements

Run

set your irobot credentials in the following var :

export IRBT_LOGIN="[e-mail]"
export IRBT_PASSWORD="yourpassword"

Then launch the cli (-h for the options)

./cli.py -h

You can also build the container using:

docker build . -t irbt_cli

Then run it with the credentials environment variable sets

docker run -e IRBT_LOGIN -e IRBT_PASSWORD -ti irbt_cli:latest python3 ./cli.py -h

for wireshark debugging

import sslkeylog
sslkeylog.set_keylog("sslkeylog.txt")