crates.io

The Rust community’s crate registry

signal-locate v0.2.0

A tool to create a heatmap of wifi signal strength.

Rust CI Hackatime Crates.io Total Downloads Crates.io Version

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

  • Only macOS versions up to 13 (Ventura) are supported.
  • Windows is only supported if the system language is set to English.
  • iw must be installed and accessible in your system's PATH for Linux users.

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.s.

  • 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.

Stats Overview

477 Downloads all time
3 Versions published

Downloads over the last 90 days

Display as