vacuum-map-parser-roborock
Functionalities for Roborock vacuum map parsing
Decision gist · record as of 2026-08-14
Yes, if you are building a home automation or companion application for Roborock vacuums. The package is actively maintained, has no known vulnerabilities, low install friction, and permissive licensing. It fills a specific niche—Roborock map parsing—with a clean dependency chain. Not relevant for general-purpose use.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.11 or later; raw map data must be obtained from Roborock vacuum device.
- Low friction install with only two runtime dependencies (Pillow and vacuum-map-parser-base).
- Actively maintained with recent commits and no known vulnerabilities.
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows use in commercial and private projects with minimal restrictions; attribution required but no copyleft obligations.
last release 2026-05-18 (88 days) · last repo commit 2026-07-20 · 3 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 85,946 downloads/mo, #13,893 on PyPI
Alternatives
Verify before relying
from vacuum_map_parser_roborock.map_data_parser import RoborockMapDataParser
from vacuum_map_parser_base.config.color import ColorsPalette
from vacuum_map_parser_base.config.image_config import ImageConfig
palette = ColorsPalette()
image_config = ImageConfig()
parser = RoborockMapDataParser(palette, Sizes(), [], image_config, [])
unpacked_map = parser.unpack_map(raw_map_bytes)
parsed_map = parser.parse(unpacked_map)- Whether the package supports all Roborock vacuum models or only specific firmware versions.
- Performance characteristics when parsing large or complex map files.
- Whether map rendering output formats (image types, resolutions) are documented.
What it is and what it does
This package provides a specialized parser for the binary map format used by Roborock robotic vacuum cleaners. It takes raw map data from a Roborock device and unpacks it into a structured format that can be analyzed or rendered as an image. The parser is built on top of vacuum-map-parser-base, which provides the configuration framework for colors, sizes, drawable elements, and text overlays.
The package is intended for developers integrating Roborock vacuums into home automation systems or building companion applications. It handles the low-level binary protocol parsing so that map visualization and analysis can be built on top. Configuration is done through color palettes, drawable element lists, and image settings passed to the parser at initialization.
Use it for
- Display real-time or historical vacuum cleaning maps in a home automation dashboard or mobile app.
- Extract room and obstacle data from Roborock maps for integration with smart home systems.
- Analyze vacuum coverage patterns or generate reports on cleaned areas.
- Build custom map visualization tools with application-specific overlays or annotations.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are building a home automation or companion application for Roborock vacuums.
The package is actively maintained, has no known vulnerabilities, low install friction, and permissive licensing. It fills a specific niche—Roborock map parsing—with a clean dependency chain. Not relevant for general-purpose use.
Install
vacuum-map-parser-roborock on PyPI
Before you install
Low friction install with only two runtime dependencies (Pillow and vacuum-map-parser-base). Actively maintained with recent commits and no known vulnerabilities.
Requires Python 3.11 or later; raw map data must be obtained from Roborock vacuum device.
License in practice
Apache-2.0 permissive license allows use in commercial and private projects with minimal restrictions; attribution required but no copyleft obligations.
Quickstart
from vacuum_map_parser_roborock.map_data_parser import RoborockMapDataParser
from vacuum_map_parser_base.config.color import ColorsPalette
from vacuum_map_parser_base.config.image_config import ImageConfig
palette = ColorsPalette()
image_config = ImageConfig()
parser = RoborockMapDataParser(palette, Sizes(), [], image_config, [])
unpacked_map = parser.unpack_map(raw_map_bytes)
parsed_map = parser.parse(unpacked_map)Verify before relying
- Whether the package supports all Roborock vacuum models or only specific firmware versions.
- Performance characteristics when parsing large or complex map files.
- Whether map rendering output formats (image types, resolutions) are documented.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release <4.0,>=3.11 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagesPillowvacuum-map-parser-base |
| Maintenance | Actively maintained 88 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 85,946 / month, #13,893 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaEnvironment :: ConsoleIntended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.11Topic :: Home Automation |
Evidence: vacuum_map_parser_roborock-0.1.5-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “roborock vacuum map parser”
- vacuum-map-parser-roborockParses map data generated by Roborock vacuum cleaners, converting raw…
- vacuum-map-parser-baseProvides base classes and utilities for parsing vacuum cleaner map…
- python-roborockControl Roborock vacuum cleaners online and offline through a Python…
Give your agent the search over MCP, or paste the wish link into any chat.
More Home Automation packages
Represents and manipulates IPv4, IPv6, MAC addresses and related network objects; supports CIDR notation, subnetting, set operations, IANA lookups, and DNS reverse generation.
Home Assistant is an open-source home automation platform that centralizes control of smart home devices and automations on a local server or Raspberry Pi, prioritizing local control and privacy over cloud dependency.
Defines finite state machines and statecharts with a declarative Python API, supporting flat states, compound hierarchies, parallel regions, history states, guards, and both sync and async callbacks.
Install it if you need to model workflows, control logic, or any system with discrete states and event-driven transitions — from simple state machines to complex…
A Python library for controlling BlueZ Bluetooth adapters on Linux via the Management API, supporting both synchronous and event-driven command patterns.
An async Python library for controlling and monitoring Homematic and HomematicIP devices through multiple backend systems (CCU3, OpenCCU, Homegear, CUxD, CCU-Jack) using XML-RPC and JSON-RPC protocols.
Install it if you need to control Homematic devices from Python; the only constraint is a requirement for Python 3.14 or later and network access to a compatible…
Provides base classes and utilities for Home Assistant integrations to proxy HTTP and WebSocket traffic through Home Assistant's web server.
Install only if you are building a custom Home Assistant integration; it is not useful as a standalone package.
See also vacuum-map-parser-base · python-roborock · pybotvac · catkin-pkg · deebot-client · smmap · mapfile_parser · leafmap · pytiled-parser · squarify