Tuya Cloud Map Extractor for Home Assistant (Marketplace integration)

Installs: 79 sharing analytics
GitHub stars: 40
Connection: Uses the vendor's cloud
Upkeep: No update in 6 to 18 months
Version: v1.2.1, December 17, 2025
Category: Appliances and cleaning, Cleaning
Kind: Marketplace integration
Brand: Tuya
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: tuya_cloud_map_extractor
Source: github.com/oven-lab/tuya_cloud_map_extractor
Issues: Report an issue

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

About

Tuya Cloud Map Extractor is an integration that pulls live maps from Tuya laser vacuums into Home Assistant. It adds a camera entity that shows the vacuum map, and it gets the data through the Tuya cloud using a Client ID, Client Secret and Device ID. Setup runs in the UI, where the map can be styled with colors for the background, walls, inside areas, path and individual rooms. Options cover showing the path, using the last reported vacuum position, rotating the map and flipping it horizontally or vertically. The camera is off by default and has to be turned on and off through camera services, or by an automation. The author states the project is no longer maintained, and it was built by reverse engineering, so it works only with a short list of tested vacuums.

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

Supports

Uses the vendor's cloud Needs an internet connection and an account with the vendor.
From the Marketplace Installed through the Marketplace, formerly HACS.

Provides

Cameras

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Connect

Entity name
Client ID
Cient Secret
Device ID
Show path
Configure colors

Colorconf

Background color
Wall color
Inside color
Path color
Configure room colors

Room colors

Name
Color
Name
Color
Name
Color
Name
Color
Name
Color
Name
Color
Name
Color
Name

After setup

Show path
Vacuum position last reported position. (If unchecked, the latest reported position)
Rotate:
Flip horizontal
Flip vertical

Texts from the code of oven-lab/tuya_cloud_map_extractor.

From the README

Important notice: This custom integration is no longer maintained and will not receive any further updates, bug fixes, or new features. The Tuya vacuum protocol is not standardized across manufacturers. While Tuya provides a common cloud platform, each robot vacuum brand (or even different models from the same brand) implements its own proprietary variations of the protocol, including custom message formats, encryption methods, map data structures, and command sets.
This integration was developed primarily through reverse engineering and currently works with the devices listed further down in the readme.

From the README of oven-lab/tuya_cloud_map_extractor, MIT License. Shortened.