Roborock Vacuum Control

# Roborock Vacuum Control

Control Roborock robot vacuums via the `roborock` CLI.

## First-Time Setup

### 1. Install CLI ```bash pipx install python-roborock ```

### 2. Login to Roborock Account ```bash roborock login ``` Enter your Roborock/Xiaomi Home app email and password.

### 3. Find Your Device ID ```bash roborock list-devices ``` Note your device ID (looks like `AbCdEf123456789XyZ`).

### 4. Store Device ID (Optional) Add to your TOOLS.md for easy reference: ```markdown ## Roborock Vacuum - **Device ID:** your-device-id-here - **Model:** Roborock S7 Max Ultra (or your model) ```

## Quick Commands

All commands need `--device_id "YOUR_DEVICE_ID"` — replace with your actual device ID.

### Check Status ```bash roborock status --device_id "YOUR_DEVICE_ID" ```

### Start Cleaning ```bash roborock command --device_id "YOUR_DEVICE_ID" start ```

### Stop/Pause ```bash roborock command --device_id "YOUR_DEVICE_ID" stop roborock command --device_id "YOUR_DEVICE_ID" pause ```

### Return to Dock ```bash roborock command --device_id "YOUR_DEVICE_ID" home ```

### Clean Specific Room First get room IDs: ```bash roborock rooms --device_id "YOUR_DEVICE_ID" ``` Then clean specific rooms: ```bash roborock command --device_id "YOUR_DEVICE_ID" segment_clean --rooms 16,17 ```

## Maintenance Commands

### Check Consumables ```bash roborock consumables --device_id "YOUR_DEVICE_ID" ``` Shows filter, brush, sensor lifespans.

### Reset Consumable ```bash roborock reset-consumable filter --device_id "YOUR_DEVICE_ID" roborock reset-consumable main_brush --device_id "YOUR_DEVICE_ID" roborock reset-consumable side_brush --device_id "YOUR_DEVICE_ID" ```

### Last Clean Record ```bash roborock clean-record --device_id "YOUR_DEVICE_ID" ```

### Clean Summary (All Time) ```bash roborock clean-summary --device_id "YOUR_DEVICE_ID" ```

## Maps & Rooms

### Get Maps ```bash roborock maps --device_id "YOUR_DEVICE_ID" ```

### Cache Home Layout ```bash roborock home ```

### Save Map Image ```bash roborock map-image --device_id "YOUR_DEVICE_ID" --output /tmp/vacuum-map.png ```

### Room Features ```bash roborock features --device_id "YOUR_DEVICE_ID" ```

## Settings

### Volume ```bash roborock volume --device_id "YOUR_DEVICE_ID" roborock set-volume 50 --device_id "YOUR_DEVICE_ID" ```

### Do Not Disturb ```bash roborock dnd --device_id "YOUR_DEVICE_ID" ```

### LED Status ```bash roborock led-status --device_id "YOUR_DEVICE_ID" ```

### Child Lock ```bash roborock child-lock --device_id "YOUR_DEVICE_ID" ```

## Interactive Session For multiple commands without repeating device ID: ```bash roborock session --device_id "YOUR_DEVICE_ID" ```

## Troubleshooting

**Commands fail silently:** 1. Check login: `roborock login` 2. Use debug mode: `roborock -d status --device_id "YOUR_DEVICE_ID"` 3. Ensure vacuum is online and connected to WiFi

**"Device not found":** - Run `roborock list-devices` to verify device ID - Make sure you're logged into the correct Roborock account

**"Authentication failed":** - Re-run `roborock login` - Check you're using the same account as your Xiaomi Home / Roborock app

## Common Tasks

**"Vacuum the house":** ```bash roborock command --device_id "YOUR_DEVICE_ID" start ```

**"Vacuum the kitchen":** ```bash roborock rooms --device_id "YOUR_DEVICE_ID" # find kitchen room ID roborock command --device_id "YOUR_DEVICE_ID" segment_clean --rooms <kitchen_id> ```

**"Is the vacuum done?":** ```bash roborock status --device_id "YOUR_DEVICE_ID" ```

**"Send vacuum home":** ```bash roborock command --device_id "YOUR_DEVICE_ID" home ```

**"When did it last clean?":** ```bash roborock clean-record --device_id "YOUR_DEVICE_ID" ```

**"Check brush/filter life":** ```bash roborock consumables --device_id "YOUR_DEVICE_ID" ```

## Supported Models

Works with most Roborock vacuums including: - Roborock S series (S4, S5, S6, S7, S8) - Roborock Q series (Q5, Q7, Q8) - Roborock E series - Xiaomi Mi Robot Vacuum (Roborock-based)

## Credits

Uses the [python-roborock](https://github.com/humbertogontijo/python-roborock) library.