Valeronoi logo

Valeronoi ccoors

valetudo
Use this command to install Valeronoi:
winget install --id=ccoors.Valeronoi -e

Valeronoi (Valetudo + Voronoi) is a companion for Valetudo for generating WiFi signal strength maps. It visualizes them using a Voronoi diagram.

Valeronoi is a companion application for Valetudo, designed to generate and visualize WiFi signal strength maps using Voronoi diagrams. This tool helps users create detailed and accurate representations of wireless coverage areas by leveraging data from compatible robots running Valetudo.

Key Features:

  • Real-time visualization of WiFi signal strength through dynamic Voronoi diagrams.
  • Integration with persistent maps for enhanced accuracy and consistency.
  • Configuration options to customize the appearance and behavior of visualizations.
  • Cross-platform support, allowing installation via winget on Windows and availability on Linux and macOS.
  • Performance tuning features, such as OpenGL rendering and map simplification, to optimize display quality and responsiveness.

Audience & Benefit: Ideal for robot owners using Valetudo, network engineers, and tech enthusiasts seeking to optimize WiFi coverage. Valeronoi provides actionable insights into wireless signal distribution, enabling informed decisions about router placement and coverage optimization.

README

Valeronoi

Valeronoi (Valetudo + Voronoi) is a companion for Valetudo for generating WiFi signal strength maps. It visualizes them using a Voronoi diagram.

Screenshot

Installation

Binary distributions are available for Linux, macOS and Windows (x86_64). They can be found in the releases.

  • Linux: AppImages. The "current" AppImage is built on Ubuntu 24.04 LTS (Noble Numbat) and Qt 6, so it probably won't run on anything older than that. In that case you may want to test the "legacy" AppImage, which is built on Ubuntu 22.04 LTS (Jammy Jellyfish) instead.
  • macOS: "current" is built on macOS 14 (Sonoma) on Intel Macs. It also works with Rosetta 2 on ARM-based Macs. "legacy" is built on macOS 13 (Ventura).
  • Windows: Compiled on Windows with mingw64. Available as an installer and a portable zip. Using the uninstaller generated by the installer also removes the registry keys used for the settings stored by Valeronoi.

Basic Usage

  1. Make sure you have a supported robot running a recent Valetudo version (API v2). Having persistent maps is highly recommended.
  2. Set up the robot connection in Valeronoi (Robot -> Setup)
  3. Connect Valeronoi to the robot using the "Connect" button
  4. Verify that the complete, correct map is displayed (!) See below for an explanation.
  5. Start recording WiFi measurements by clicking the "Begin recording" button
  6. Start a cleanup, either using the controls in the "Control" tab or Valetudo/Home Assistant/... If you don't have persistent maps, make sure to not start a full cleanup! Major map updates can not be handled in Valeronoi.
  7. While cleaning, watch the map update
  8. After the robot returned to the dock, stop the recording and/or disconnect Valeronoi

Persistent maps

If you have a robot that does not support persistent maps (Roborock V1) or don't have that feature enabled, make sure to only record when doing partial cleanups, as a new map will always be generated on a full cleanup. Major map changes during recording can change the internal map coordinates and mess up the recording.

Support

Graphics

If the graphics are slow and unresponsive, try the following things in the "Display" tab:

  • Disable drawing the floor
  • Disabling the "Restrict to ..." checkboxes
  • Increase the "Simplify" slider
  • Enabling drawing using OpenGL

Warning: Using OpenGL may increase or decrease performance, depending on your system. Enabling OpenGL can also lead to various issues, like garbage text or inverted graphics. Valeronoi requests OpenGL 3.2, which should be available on most systems, but may not be available in VMs or Remote Desktop scenarios.

Building from source

Install the required Libraries using the method of your choice:

  • Qt 6
  • CGAL (4.x/5.x/6.x should work)

You also need a C++-Compiler capable of C++17. g++ 7 or later works.

Then use the CMake-Project as you would in any other project.

mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j

Arch Linux

A PKGBUILD for the valeronoi-git package is provided in tools/pkgbuild/valeronoi-git. To build and install it run makepkg -si.

License

GPLv3

Versions
0.2.2
Website
github.com
License