Skip to content

On Home Assistant 2026.10 or older? Open it in HACS

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

Shows in Vulpo

Camera card.

Installs over time

80
Oct 21Nov 15

#1,287 of 1,599 Marketplace integrations. Installs sharing analytics.

Supports

  • Uses the vendor's cloudNeeds an internet connection and an account with the vendor.
  • From the MarketplaceInstalled 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.

Information

Installs
80 sharing analytics
GitHub stars
40
Connection
Uses the vendor's cloud
Upkeep
No update in 6 to 18 months
Version
v1.2.1,
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

More from Tuya

You might also like

Try it with your own Home Assistant.

Vulpo on a MacBook, a Studio Display, an iPhone, an iPad and an Apple Watch.
  • Free to download
  • iPhone, iPad, Mac and Apple Watch
  • 40+ native card types
  • Connects to your own Home Assistant

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

New in 2026.11: HACS becomes the Home Assistant Marketplace, what changes.

Looking for an app? The best Home Assistant apps for iPhone, by need.