MQTT Vacuum Camera for Home Assistant (Marketplace integration)

Installs: 528 sharing analytics
GitHub stars: 185
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: 2026.10.0, October 27, 2026
Category: Security and safety, Cameras
Kind: Marketplace integration
Needs: Added as a custom repository in the Marketplace
Domain: mqtt_vacuum_camera
Source: github.com/sca075/mqtt_vacuum_camera
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

MQTT Vacuum Camera is an integration that renders maps from vacuums connected over MQTT as camera entities. It supports vacuums running Valetudo Hypfer, Valetudo RE (rand256) or Congaduto firmware, and it works locally. Besides the camera, it adds sensors, which are meant for data the vacuum does not provide itself. Options cover which map elements to hide, such as walls, charger, paths and individual rooms, plus colors, transparency, carpet, wood and tile rendering, rotation, zoom, image format and a status text overlay. Actions can reload the platform, turn the camera on or off, reset map trims and take a snapshot. It is added as a custom repository in the Marketplace and set up in the UI.

Automatic summary of the README and code of sca075/mqtt_vacuum_camera. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Cameras
Sensors

Setting it up

Add its repository to the Marketplace as a custom repository and install it, then restart Home Assistant and add it under Settings, Devices and services.

MQTT Camera Setup

Vacuum Robot Entity IDVacuum Robot Entity ID
Vacuum Robot Config Data
Vacuum Robot Topic
Vacuum Robot MQTT id

After setup

Hide FloorWhen enabled, the floor will not be shown on the map
Hide WallsWhen enabled, walls will not be shown on the map
Hide RobotWhen enabled, the robot will not be shown on the map
Hide ChargerWhen enabled, the charger will not be shown on the map
Hide Virtual WallsWhen enabled, virtual walls will not be shown on the map
Hide Restricted AreasWhen enabled, restricted areas will not be shown on the map
Hide No-Mop AreasWhen enabled, no-mop areas will not be shown on the map
Hide ObstaclesWhen enabled, obstacles will not be shown on the map
Hide PathWhen enabled, the cleaning path will not be shown on the map
Hide Predicted PathWhen enabled, the predicted path will not be shown on the map
Hide Go-To TargetWhen enabled, go-to targets will not be shown on the map
Hide Room 1
Hide Room 2
Hide Room 3
Hide Room 4
Hide Room 5
Hide Room 6
Hide Room 7
Hide Room 8
Hide Room 9
Hide Room 10
Hide Room 11
Hide Room 12
Hide Room 13
Hide Room 14
Hide Room 15
Disable material overlay (wood & tiles)Turn off material overlay rendering for wood and tiles on the map
Hide carpetsWhen enabled, carpets will not be shown on the map
Carpet colorColor for carpet materials (RGB)
Wood plank colorColor for wood plank materials (RGB)
Tile colorColor for tile materials (RGB)
Carpet transparencyTransparency level for carpets (0-255)
Wood transparencyTransparency level for wood planks (0-255)
Tile transparencyTransparency level for tiles (0-255)
RotateDegree 0, 90, 180, 270
Image Margins.Auto Trim Margins in pixels.
Enable Auto Zoom
Lock Aspect Ratio.
Image Aspect Ratio.Image Aspect Ratio.
Size of the Robot.Size of the Robot in pixels 8-25.
Mop Path WidthWidth of the vacuum path when in mop mode (1-50 pixels, must be less than robot size).
Image FormatSelect the image format for the camera (JPEG, PNG, or PIL). JPEG is recommended for best compatibility.
Show Vacuum Status.
Fira SansText Font default Fira Serif.
Text SizeText size default 50.
Text Position: Bottom(OFF)
[255, 255, 255]Vacuum Status Text colour.
[255, 128, 0]Charger color.
[238, 247, 255]Move color.
[238, 247, 255]Mop path color (Hypfer vacuums only).
[255, 255, 0]Wall color.
[255, 255, 204]Robot color.
[0, 255, 0]Go-to color.
[255, 0, 0]No-go color.
[255, 255, 255]Zone clean color.
[0, 125, 255]Background color.
Configure Transparency:
Charger Alpha
Moves Alpha
Mop Path Alpha
Walls Alpha
Robot Alpha
Go To Area Alpha
No Go Area Alpha
Zone Clean Alpha
Background Alpha
Text Alpha
[135, 206, 250]Floor Color
Configure Transparency: