tuya-vacuum 0.1.0

A python library to view maps from Tuya robot vacuums

tuya-vacuum

tuya-vacuum is a python library to view maps from Tuya robot vacuums.

Installation

Use the package manager pip to install tuya-vacuum.

pip install tuya-vacuum

Usage

from tuya_vacuum.tuya import TuyaCloudAPI
import requests

# Create a new TuyaCloudAPI instance
tuya = TuyaCloudAPI(
    origin="https://openapi.tuyaus.com",
    client_id="<Client ID>",
    client_secret="<Client Secret>"
)

# Request the current realtime map data from the cloud
device_id = "<Device ID>"
response = tuya.request("GET", f"/v1.0/users/sweepers/file/{device_id}/realtime-map")

# Get the layout and path data using the returned map urls
layout_data = requests.get(response["result"][0]["map_url"]).content.hex()
path_data = requests.get(response["result"][1]["map_url"]).content.hex()

# Parse the map data
vacuum_map = VacuumMap(layout_data, path_data)

# Save the map as an image
image = vacuum_map.to_image()
image.save("output.png")

Compatability List

This is a list of all currently tested devices. Create a new issue to add your device.

Device	Support
Lefant M1

Special Thanks

• Tuya Cloud Vacuum Map Extractor by @oven-lab