valetudo-map-parser 0.2.3

A Python library to parse Valetudo map data returning a PIL Image object.

Python-package-valetudo-map-parser

---

What is it:

❗This is an unofficial project and is not created, maintained, or in any sense linked to valetudo.cloud

A Python library that converts Valetudo vacuum JSON map data into PIL (Python Imaging Library) images. This package is primarily developed for and used in the MQTT Vacuum Camera project.

---

Features:

• Processes map data from Valetudo-compatible robot vacuums
• Supports both Hypfer and Rand256 vacuum data formats
• Renders comprehensive map visualizations including:
  • Walls and obstacles
  • Robot position and cleaning path
  • Room segments and boundaries
  • Cleaning zones
  • Virtual restrictions
  • LiDAR data
  • Mop mode path rendering (Hypfer only)
• Provides auto-cropping and dynamic zooming
• Supports image rotation and aspect ratio management
• Enables custom color schemes
• Handles multilingual labels
• Implements thread-safe data sharing

Installation:

pip install valetudo_map_parser

Requirements:

• Python 3.13 or higher
• Dependencies:
  • Pillow (>=10.3.0) for image processing
  • NumPy (>=1.26.4) for array operations
  • SciPy (>=1.12.0) for scientific computing
  • mvcrender (==0.0.7) for high-performance rendering

Usage:

The library is configured using a dictionary format. See our sample code for implementation examples.

Key functionalities:

• Decodes raw data from Rand256 format
• Processes JSON data from compatible vacuums
• Returns Pillow PNG images
• Provides calibration and room property extraction
• Supports asynchronous operations

Development Status:

Current version: 0.2.2

• Full functionality available in versions >= 0.1.9
• Actively maintained and enhanced
• Uses Poetry for dependency management
• Implements comprehensive testing
• Enforces code quality through ruff, isort, and pylint

Contributing:

Contributions are welcome! You can help by:

• Submitting code improvements
• Enhancing documentation
• Reporting issues
• Suggesting new features

Disclaimer:

This project is provided "as is" without warranty of any kind. Users assume all risks associated with its use.

License:

Apache-2.0

---

For more information about Valetudo, visit valetudo.cloud Integration with Home Assistant: MQTT Vacuum Camera