# Valetudo-mapper

Valetudo-mapper is a companion service for Valetudo-RE that offloads PNG map generation from the vacuum robot to a host with sufficient CPU and memory, publishing the resulting maps over MQTT for third-party. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/835/valetudo-mapper

## Description

Valetudo-mapper is a companion service for Valetudo-RE that offloads PNG map generation from the vacuum robot to a host with sufficient CPU and memory, publishing the resulting maps over MQTT for third-party integrations such as Home Assistant.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

19/100 (Low), based on 3 of 4 factors.
- Maintained: 0 (last commit 1134 days ago)
- Popular: 38 (74 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- GitHub: https://github.com/rand256/valetudo-mapper
- Docker Hub: https://hub.docker.com/r/rand256/valetudo-mapper/
- Unraid: https://ca.unraid.net/apps/valetudo-mapper-1y064mi1hqepty?q=valetudo-mapper
- Documentation: https://valetudo.cloud

## Common questions

### Do I need to prepare a config file before running valetudo-mapper?

Yes, you should make sure the needed config file is already created before using the service.

### How can I remove empty spaces or mirrored artifacts from the generated map?

Autocrop removes empty spaces at the edges, and its value determines how many pixels to keep at the border. You can also specify manual crop values to cut out mirrored artifacts outside the actual rooms.

### Can I use Valetudo maps in Home Assistant automations?

Yes, users discuss using a Xiaomi map card with Valetudo maps to send a vacuum to a selected room.

### Does Valetudo change the robot's mapping or navigation?

No, Valetudo does not change the mapping and navigation; it is about the interface.

---
Source: Our Local Host (https://ourlocalhost.com/app/835/valetudo-mapper), the self-hosted and open-source app directory.
