wtf is matic-home-assistant?

This project is an unofficial Home Assistant integration for Matic robot vacuums. It is a community effort, not made or supported by Matic Robots Inc, and it lets you control and monitor your Matic vacuum from Home Assistant using only a local connection to the robot, without going through the cloud. Setup pairs Home Assistant with the robot over Bluetooth using the robot's own "Add another user" screen, after which day to day control, status updates, and maps flow over an encrypted local connection. Once connected, one robot shows up in Home Assistant as around 48 separate items: sensors for things like battery and current room, buttons, switches, a camera showing a live map, and the main vacuum control itself. The map is drawn from the robot's own sense of the rooms and its position, not from an actual camera image. You can start, pause, stop, or dock the robot, clean a single named room, or map Home Assistant's own room groupings onto the robot's rooms. Beyond basic control, the integration adds cleaning plans you build and save inside Home Assistant: named plans with a chosen room order and cleaning settings per room, which can either run in the same order every time or start with whichever rooms have gone longest without being cleaned. These plans can be triggered by any Home Assistant automation, schedule, or script, and the integration also lets you turn the robot's voice activation on or off from a normal switch. On privacy, the integration keeps regular traffic local and does not send any usage data, crash reports, or analytics anywhere. If you manually request a diagnostics report for troubleshooting, it leaves out anything sensitive like credentials, addresses, room maps, and Wi-Fi details. To install it you add the project as a custom repository in HACS, or copy the files into Home Assistant's custom_components folder by hand, then restart Home Assistant and complete the Bluetooth pairing prompt. It is written in Python and tested against a recent Home Assistant release, older versions have not been checked.