Valetudo Vacuums Map Camera for Home Assistant

Prevent Camera Crash with Home Assistant 2026.3.0

The 2026.3.0 released just today is purely a maintenance release that thanks to some really useful people was raised to my attention.
The camera libraries had some dependency issue. Meanwhile some code improvements, the shutdown of the threads is now more clean.

In the next release will try to get PNG format for who likes to overlap the images on images (floors plans) will be optionally available.

Much other in progress but slowly also because will do a little brake :slight_smile:

Thanks again to all of you.

1 Like

The latest update seems to have badly cropped one of my camera images:

Looks ok in Vaetudo.

And the background is no longer transparent - despite being set as such in the camera settings.

Noticed the background Alpha problem myself with the latest update. On two vacuums it’s now blue. On one vacuum, it’s now black. Interesting that it’s so wildly different.

I’m not seeing the cropping issue on my vacuums at all.

I pretty sure there’s a way to reset the zoom but I cant find it.

Guys @tom_l and @rohankapoorcom about the background alpha is because the camera now render JPEG instead of PIL, as a compromise will support PNG and HomeKit streaming too… I’m working on it.

In the DOCS as explained already as now we have Floors Support, the trems are in the floor data… It means in Image Setting:


Updated the Floor Data → new trims: will automatically edit the floor:

SubMir → Back to the main menu → Save Options and the trims are applied…

The services for this are not yet implemented but will do it as soon.

2 Likes

Thanks. Adding a floor and updating the trim data did the trick.

Nice. Thanks.

Transparency of background And Concaduto Support Latest

What is New:

Thanks at the excellent cooperation of @demonizator it was possible to add the Congatudo vacuums (Conga) running this variant of Valetudo. Maps are rendered and calibration / rooms data is available for start we added also some new payload to detect Water Tanks installations and Dust Bins installations, working on improvements of course will be our pleasure.

Many of you uses the background with different floor plans for this reason converting the camera (thanks again @mafredri) to use go2rtc therefore JPEG, instead of PIL, lost the possibility to use the background transparencies. To solve this we now support as default JEPEG format and optionally PNG. Image Options → Basic Settings → Image Format selectable is now available. Note JPEG will still support the go2rtc as introduced in the 2026.2.2

Screenshot 2026-03-15 at 20 48 31

As usual

Whenever you feel something can be improved please join our discord or post in GitHub your proposals/concerns and especially issues faced. If you use this consider starring this project, if not yet done.. or contribute to its development. Thanks to all of you :slight_smile:

2 Likes

Thanks, I can confirm this version fixes the transparency behavior.

1 Like

hi guys! I hadn’t updated Home Assistant for months because I was afraid the integration wouldn’t work. Today I decided to update it, and it happened… any ideas on how to fix it? I’m on the latest version of Home Assistant and the latest version of MQTT_Camera, firmware version 2025.05.0. Thanks everyone! :slight_smile:

@kill_one Try to update the vacuum firmware too please and use the stable version not the the beta one instead. This should solve the issue, as the vacuum actually is rejected from MQTT because of deprecated values.

@gsca075 Thanks a lot! now it works perfectly :slight_smile:

I deleted floor_0 and it took my whole HA down (:
Why I did it? - I’m an idiot

@possum2 sorry for the late replay if you deleted floor_0 from the camera config (it effects only the camera) yep probably there could be some problems. You are welcome to describe the problem you are facing creating an issue on the camera repo and will be happy to add some ā€œsafe guardā€ā€¦ the camera do not delete or edit floors data just uses the floor data from HA if available and if not as fall back the library and camera custom component fall back to floor_0. Simply add the floor (if noting is in the HA registry as floor) would result in a new floor_0 data.

1 Like

Hi, no probs and thanks for creating this!

I’m not going to post an issue as of yet, I don’t want to recreate the situation :smiley: (but if you need, lmk and I’ll do it, this time I know a quicker way out)
I turned on debug logging in case something happens, what made me do it was when i changed trim levels in integration settings, HA restarted. I was sure it will be gone again, but it came back. Didn’t touch the trims since, because they also didn’t do anything for me - ā€œEdit Floor Settingsā€ saved my settings but when proceeding to ā€œUpdate Floor Dataā€, it still had the old value.

integration v - 2026.3.1
Valetudo 2026.02.0
HAOS 2026.3.4
Roborock.s5

Yes this is what I kind of expected… I did several test and floor_0 is as it is suppose init correctly in the library if not defined in the config… as it is the default floor when HA isn’t configured in floors mode… and I repeat we use the ID’s of the floors but the management of the floors (add or delete) is in HA. We just record the trims of the floors id’s if any or in floor_0 if none as we need a key to grab the data… simple like that.

The data are stored then a floor_0 can be activated and you can update the trims when needed.

Ok it happened again, now this time while changing trim values (it still doesn’t change my camera feed image, I was just trying).
I had debug logging active, but where to see those logs? System-Logs and then Supervisor or Core? edit: ah nvm, I restarted HA after safe mode and logs are gone.

@possum2 I simply do not understand your problem… the camera works just fine and without logs that anyway should be posted on GitHub not here I can’t really help. Honestly it work for 1000 of users I do not know what is happening and why… just please remember that this is a custom component and it come as it is. You can delete the camera and use something different if this is the problem for sure the Camera do not crash HA!!!

What changes on April 2026 just released?

Service Definitions & Versionmanifest.json, services.yaml Version bumped to 2026.4.0. Two new camera services added: camera_select_floor (sets active floor via floor_id) and camera_update_floor_data (persists map trim data to a floor).
Service Registration & Handlers__init__.py, utils/camera/camera_services.py Service handlers registered/unregistered conditionally in async_setup_entry/async_unload_entry. Handlers resolve camera entity, validate floor existence, update config, and emit events. Floor data updates convert coordinator trim values to persisted FloorData.
Valetudo Event Bidirectional Syncutils/connection/connector.py Valetudo event handling now supports dismissal acknowledgment. Processed events dismiss HA notifications; unprocessed events create them and register dismissal callbacks that publish MQTT interact commands back to Valetudo, preventing notification echo-back.

Hi,
just a quick question:
is multiple floor functionality also available for Congatudo users?
I ask this because I have a Conga 4090 (iirc it is multi-floor capable) running Congatudo 2026.2 embedded and didn’t find a way through adding a map for each floor.
If I follow instructions located at mqtt_vacuum_camera/docs/floor_management.md at f425a3a5ba58dd2c8510442f7a585aa10072aad9 Ā· sca075/mqtt_vacuum_camera Ā· GitHub and create a new floor I eventually end up with a blank camera image:

any clues?

@frastill yes the multi floor might work also work for Congatudo the vacuum might have a map after scanning the floor grey means there are no maps for that floor yet in the vacuum. Aldo Congatudo is still maybe buggy in my implementation will be happy to help you understand where the problem is if you open a discussion in GitHub we can see if it will be necessary to open an issue