roomba-control

# Roomba Control

Command your iRobot Roomba from the terminal.

---

## Table of Contents

- [Requirements](#requirements)
- [Configuration](#configuration)
- [Core Commands](#core-commands)
- [Cleaning Jobs](#cleaning-jobs)
- [Scheduling](#scheduling)
- [Consumable Tracking](#consumable-tracking)
- [Cleaning History & Maps](#cleaning-history--maps)
- [Multi-Robot Support](#multi-robot-support)
- [Scripting & Automation](#scripting--automation)

---

## Requirements

- An iRobot Roomba with Wi-Fi connectivity (600/700/800/900/i/j/s series)
- iRobot account credentials
- Python 3.6+
- Network access to iRobot cloud services

## Configuration

```bash
export IROBOT_EMAIL="you@example.com"
export IROBOT_PASSWORD="your-password"
```

First-time setup discovers your robots:

```bash
$ bash scripts/roomba-ctl.sh setup

Discovering robots on your account...
Found 2 robots:
  [1] Rosie       — Roomba j7+    (Online, Docked)
  [2] Dusty       — Roomba i3     (Online, Docked)

Configuration saved to ~/.roomba-control/config.json
Default robot set to: Rosie
```

---

## Core Commands

```bash
# Robot status
bash scripts/roomba-ctl.sh status
# Output: Rosie (j7+) | Docked | Battery: 94% | Last clean: 2h ago | Bin: OK

# Detailed info
bash scripts/roomba-ctl.sh info

# Network/connectivity check
bash scripts/roomba-ctl.sh ping

# Identify robot (plays a sound)
bash scripts/roomba-ctl.sh find
```

---

## Cleaning Jobs

### Start & Stop

```bash
# Start cleaning (full house)
bash scripts/roomba-ctl.sh clean

# Clean specific rooms (requires room-mapping capable models)
bash scripts/roomba-ctl.sh clean --rooms "Kitchen,Living Room"

# Pause current job
bash scripts/roomba-ctl.sh pause

# Resume paused job
bash scripts/roomba-ctl.sh resume

# Send back to dock
bash scripts/roomba-ctl.sh dock

# Emergency stop
bash scripts/roomba-ctl.sh stop
```

### Job Monitoring

```bash
# Current job progress
bash scripts/roomba-ctl.sh progress
# Output: Cleaning... 65% complete | 23 min elapse...