--- title: "Roomba+" description: "Roomba+ is a Marketplace integration for Home Assistant. It has 377 installs sharing analytics, works locally and was last updated October 25, 2026." canonical: "https://vulpo.app/integrations/marketplace/johnnyh1975-ha-roomba-plus" url: "https://vulpo.app/integrations/marketplace/johnnyh1975-ha-roomba-plus.md" last-updated: "2026-10-25" version: "1.4" --- # Roomba+ > Roomba+ is a Marketplace integration for Home Assistant. It has 377 installs sharing analytics, works locally and was last updated October 25, 2026. Roomba+ is an integration for iRobot Roomba and Braava robots that talks to them over local MQTT. It works without a cloud account, and iRobot cloud credentials are optional, used for map sync and analytics. It adds vacuum, sensor, button, switch, select, image, calendar, event and to-do list entities, covering maintenance, mission history and room maps. Cleaning can be held while tracked people are home, started automatically when the floor is dirtier than usual, or blocked by chosen binary sensors such as a door contact. Actions include cleaning named rooms or zones, starting a sequence from one robot to the next, and creating or restoring backups. Robots using the newer V4/Prime protocol do not support local control. Setup is done in the UI, either with an iRobot account or by entering the robot's address. Automatic summary of the README and code of johnnyh1975/ha\_roomba\_plus. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=johnnyh1975&repository=ha_roomba_plus&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=johnnyh1975&repository=ha_roomba_plus&category=integration) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **Found by itself**: Home Assistant spots it on the network and offers to add it. - **Device triggers**: Its devices can start automations directly. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### Add Roomba+ - **Select robot**: The robot to set up. Setting up with your iRobot account is recommended: it works for every robot, finds all robots on the account and needs no button press. A robot that connects locally still needs its address on your network: it is searched for, and asked for if it cannot be found. Robots found on your network are listed too; choose manual entry if yours is missing. ### Manual setup - **IP address**: Local IP address of your Roomba ### Enter password - **Password**: The robot's local password. It is read automatically while you hold the HOME button; enter it here only if that failed. ### iRobot cloud credentials (optional) - **iRobot email**: The email address used to log into the iRobot app. - **iRobot password**: Your iRobot app password. Also asked when at the sign in with your irobot account step. ### Choose a robot - **Robot**: The robot from your iRobot account to add. Each robot becomes its own entry. ### Reconnect to iRobot cloud - **iRobot email**: The email address used to log into the iRobot app. - **iRobot password**: Your current iRobot app password. ### Change the connection - **IP address**: The local IP address of the Roomba. - **Password**: The robot's local password. Leave empty to take it from your iRobot account (robots set up with an account). ### After setup - **Enable live map**: Enable the live cleaning map for robots with position sensing (Roomba 900, i, s, j, Braava m). - **Ask the robot for its position**: Only offered for robots that do not report their position on their own. Asks the robot about once a second while it cleans, to draw the cleaning path live. Off: the map shows the last finished mission from the iRobot cloud instead, if cloud access is set up. - **Align the path with the rooms**: Only with the option above. Turns the cleaning path against the floor plan until it lies on its rooms. Room tracking uses the same turned positions, so a wrong angle also names the wrong room. Not the same as “Rotate the map picture”, which turns the whole picture and never moves the path against the rooms. Automatic starts from the turn of the map the robot saved, including one set in the iRobot app, and changes to the angle that puts the robot’s path in the rooms once a run has shown it clearly; the path already drawn turns with it. If the path still runs through walls or beside its rooms, set an angle: the path already drawn turns as soon as you save. - **Map size (pixels)**: Map canvas size in pixels (400–1200). Default: 600. - **Scale (mm/pixel)**: Millimetres per pixel (5–30). Default 10 = 6 m × 6 m at 600 px. - **Floor label (e.g. Ground Floor)**: Free text, for example Ground Floor. Groups robots in the fleet view. - **Correlate dirt with sensors (optional)**: Sensors such as humidity or pollen. After 30 missions Roomba+ reports whether the robot collects more dirt when they are high. Calculated locally. - **Draw room names on the map image**: Writes each room's name onto the map image. - **Create a button for each saved favorite**: One button for each favourite saved in the iRobot app. On a busy account that is a lot of buttons. - **Show cleaning schedules as a calendar**: Shows the robot's cleaning schedules as a calendar. - **Draw clean zones**: Outlines the clean zones on the map image. - **Draw keep-out zones**: Outlines the keep-out zones on the map image. - **Draw no-mop zones**: Outlines the no-mop zones on the map image. - **Separate sensor per room and zone**: Creates a separate sensor for every room and zone. - **Rotate the map picture**: Turns every map picture clockwise as a whole, rooms and path together, for example to match the iRobot app. It never moves the path against the rooms; for that, use “Align the path with the rooms”. The map has no north: its top is the way the robot faced when it left the dock, so it depends on how the dock stands. - **Region IDs (comma-separated)**: Example: 5, 12, 7 - **Zone name assignments**: One entry per line: 21=Corridor, 22=Kitchen, etc. - **iRobot email**: The email address of your iRobot app account. Leave both fields empty to turn cloud features off. - **iRobot password**: The password of your iRobot app account. - **Blocking sensors**: Binary sensors that block a start when ON (e.g. door open, motion detected). - **Behavior when blocked**: Abort immediately or queue the start until sensors clear. - **Queue timeout (minutes)**: How long to wait for sensors to clear before giving up. - **Zone to edit**: The zone to rename or hide. Submit without a zone to save your changes. - **Display name**: Custom name shown in selectors. Leave blank to use the default name. - **Hide this zone**: Hidden zones are removed from selectors and will not trigger naming repair issues. - **Enable presence-aware scheduling**: Holds cleaning schedules while someone is home and releases them once everyone has left. - **Tracked persons**: The people whose presence counts. - **Mode**: “Unfreeze when all away” releases schedules automatically; “Fire event (manual control)” leaves the decision to your own automation. - **Delay after leaving (minutes)**: How long everyone must be gone before schedules are released. - **Delay before second robot start**: An extra wait after the away delay before cleaning actually starts. - **Enable demand cleaning**: Starts a clean automatically when the floor is noticeably dirtier than usual. - **Trigger multiplier (e.g. 1.5 = 50% above average)**: How far above the usual dirt level triggers a clean: 1.5 means 50% above average. Texts from the code of [johnnyh1975/ha\_roomba\_plus](https://github.com/johnnyh1975/ha_roomba_plus). ## Entities - **Binary sensors**: Bin full, Connected, Bin present, Mop problem, Robot water tank, Dock error, Mop lid open, Smart Map saving, Maintenance due, Start blocked, and 11 more - **Buttons**: Action – Empty bin, Action – Find robot, Maintenance – Confirm filter replacement, Maintenance – Confirm brush replacement, Maintenance – Confirm battery replacement, Clean zone, Repeat last mission, Skip current room, Clean zone (Smart Map), Spot clean (experimental), and 20 more - **Calendars**: Schedule, Maintenance - **Presence**: Position - **Events**: Mission completed, Room completed, Stuck, Maintenance - **Images**: Cleaning path, Coverage heatmap, Room map, Live cleaning map, Raw live map - **Selects**: Setting – Cleaning passes, Select zone, Select Smart Map zone, Select zone (cloud), Disposable pad wetness, Reusable pad wetness, Carpet boost, Suction level, Map, and 9 more - **Sensors**: Maintenance – Battery cycles, Missions – Total time, Missions – Avg. duration, Missions total, Missions successful, Missions canceled, Missions failed, Lifetime cleaned area, Missions – Last, and 139 more - **Switches**: Setting – Edge cleaning, Setting – Always finish, Setting – Schedule hold, Setting – Child lock, Setting – Eco charge, Setting – Gentle mode, Setting – Carpet boost, Child lock, Eco charging, and 6 more - **To-do lists**: Maintenance ## Actions - **Clean room**: Start a targeted clean of one or more named rooms on smart-map robots. Fields: Room name, Ordered sequence - **Reset filter**: Record the current time as the filter replacement date. - **Reset brushes**: Record the current time as the brush replacement date. - **Reset battery**: Record the current time as the battery replacement date. - **Reset cleaning pad**: Record the current time as the pad replacement date (Braava only). - **Smart start**: Start a clean with blocking-sensor checks. - **Start sequence clean**: Start robot B when robot A completes its current mission. The listener fires once and removes itself automatically. Fields: Trigger robot, Target robot, Require completion, Delay (minutes) - **Create backup**: Export every persisted store for this robot into a single ZIP file. - **Restore backup**: Restore every store in a backup ZIP. Takes effect immediately, no restart required. - **Set quiet hours**: Write the household's Do Not Disturb window. Fields: Start, End, Quiet until - **Clean zone**: Send the robot to one or more clean zones on demand, by name (as the zone select shows it) or by numeric id. Classic and Prime robots alike. Fields: Zone name, Zone ID - **Mark maintenance done**: Marks a maintenance entry as done: a part replaced or a care task carried out. On a Prime robot the reset goes to iRobot, as the app sends it. Fields: Entry, Action - **Snooze maintenance reminder**: No reminder for a maintenance entry for a number of days. Fields: Entry, Days - **Forget learned maintenance interval**: Forgets the replacement interval learned from your own replacements, for one part or every part of a Classic robot. The current part's count stays. Fields: Entries ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. - **Repair notices**: Notices it can show in Settings, Repairs: New rooms detected, Robot runtime counter may have reset, Possible battery or dock contact problem, Robot-detected obstacles in cloud map, Dock contact health issue detected, Robot MQTT connection lost during mission, Smart Map update appears stuck, Possible layout change detected, Favorite has multiple command steps, Two Roomba integrations installed ## From the README > Roomba+ is a Platinum-quality Home Assistant custom integration for iRobot Roomba and Braava robots. It connects directly over local Wi-Fi MQTT — no cloud account required, no polling, no subscription — and exposes far more sensors, intelligence, and controls than the built-in HA integration. From the README of [johnnyh1975/ha\_roomba\_plus](https://github.com/johnnyh1975/ha_roomba_plus#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Appliances and cleaning](https://vulpo.app/integrations/category/appliances-and-cleaning.md), Cleaning - Brand: [iRobot](https://vulpo.app/integrations/irobot.md) - Number: 377 installs sharing analytics; 59 GitHub stars - Connection: Works locally - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v4.5.1, last updated October 25, 2026 - Domain: `roomba_plus` - Source: - Issues: In Vulpo: Quick Toggle card, Robot Vacuum card (Pro), Button card, Select card, Apple Watch, Control Center, Vacuum Live Activity (Pro) [Widgets & Live Activities in Vulpo](https://vulpo.app/features/widgets-and-live-activities) ## Other ways in for iRobot | Name | Kind | Installs or stars | Connection | Upkeep | | --- | --- | --- | --- | --- | | [iRobot Roomba and Braava](https://vulpo.app/integrations/core/roomba.md) | Built-in integration | 11.1k installs sharing analytics | Works locally | Part of Home Assistant | | [Roomba (Rest980)](https://vulpo.app/integrations/marketplace/ia74-roomba-rest980.md) | Marketplace integration | 178 installs sharing analytics | Works locally | Updated in the last 6 months | | [Roomba v4 Cloud](https://vulpo.app/integrations/marketplace/a-mavrides-roomba-v4.md) | Marketplace integration | 98 installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | | [iRobot Braava Jet 240 BLE](https://github.com/mtheli/braava_240_ble) | Marketplace integration | 4 installs sharing analytics | Works locally | Updated in the last 6 months | | [Roomba Vacuum Card](https://vulpo.app/integrations/cards/jeremywillans-lovelace-roomba-vacuum-card.md) | Dashboard card | 57 GitHub stars | Connection not stated | No update in over 18 months | Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-25. Source: https://vulpo.app/integrations/marketplace/johnnyh1975-ha-roomba-plus --- - HTML version of this page: https://vulpo.app/integrations/marketplace/johnnyh1975-ha-roomba-plus - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml