Installing the command-line executable

Assuming you have Rust/Cargo installed, run this command in a terminal:

cargo install signal-locate

It will make the signal-locate command available in your PATH if you've allowed the PATH to be modified when installing Rust. cargo uninstall signal-locate uninstalls.

Back to the crate overview.

Readme

Signal Locate

A tool to create a heatmap of wifi signal strength.

Demo

https://github.com/user-attachments/assets/79be7a2d-d2c9-4647-ad41-b8cca2ac6b1b

Requirements

A WiFi adapter
Rust (when building from source)

Compatibility Notes

macOS support is currently broken.

Installation

You can install Signal Locate using Cargo:

cargo install signal-locate

You can also download precompiled binaries from Actions.

Usage

To use Signal Locate, run the following command:

sudo -E signal-locate

Run the precompiled binary if you use that. Root privileges are required to scan for WiFi networks. macOS and Windows may not require elevated priveleges.

After starting, open a room plan of your house (currently, only one floor is supported).
Select the WiFi network you want to map from the dropdown on the right.
Walk around your house and click your current position on the map to measure signal strength.
Collect at least 10 points for a good map.
When finished, click the Create Heatmap button to generate the heatmap.

License

This project is licensed under the GNU General Public License Version 3. See the LICENSE file for details.