https://github.com/benmwebb/wifi-heatmap

Simple tool to survey wifi signal strength and make heatmaps
https://github.com/benmwebb/wifi-heatmap

macos python3 wifi

Last synced: 10 months ago
JSON representation

Simple tool to survey wifi signal strength and make heatmaps

• Host: GitHub
• URL: https://github.com/benmwebb/wifi-heatmap
• Owner: benmwebb
• License: gpl-3.0
• Created: 2017-10-22T22:47:22.000Z (over 8 years ago)
• Default Branch: main
• Last Pushed: 2020-12-30T01:05:03.000Z (over 5 years ago)
• Last Synced: 2023-10-20T18:12:08.490Z (over 2 years ago)
• Topics: macos, python3, wifi
• Language: Python
• Size: 19.5 KB
• Stars: 32
• Watchers: 3
• Forks: 9
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
This is a very basic tool for collecting samples of wifi signal strength

in an area such as a house, and then making simple heatmap plots. I wrote it

for my own use to place wifi access points in my house; it's here in the hope

that somebody else will find it useful.

# Operating system

This software currently works only on a Mac, but could probably be made to

work on other operating systems by replacing the `AirportQuery` class with

an equivalent that calls a suitable wifi-querying command line tool.

# Dependencies

You'll need Python 3, Qt 5, scipy, matplotlib. One way to get these is to

install [brew](https://brew.sh) then `brew install python3 pyqt` and

`pip3 install matplotlib`.

# Installation

No installation is necessary - just run the `wifi-heatmap.py` program directly -

but you can certainly copy it into `/usr/bin` or similar.

# Usage

 - Use "File/Open Floor Plan..." to load a plan of the area you want to survey,

   which can be a hand-drawn image (to scale is best), or (ideally) blueprints

   or architect's plans. Most common image formats will work, although you

   may want to rescale the image to a manageable size. 

 - Click on the floor plan corresponding to where you physically are in your

   house. This will sample all of the wifi networks (this will take a few

   seconds) and record them on the plan. Walk around the house and take a number

   of such samples.

 - Use "View/Show Heatmap", and select the wifi network you're interested in,

   to get a heatmap of the signal strength over the entire floor area.

 - You can also save the current survey to a simple CSV file.

# Issues

 - Only single surveys are currently supported. If you want to survey a new

   area, restart the program and load in a new floor plan.

 - No undo (although you can edit the CSV file to remove one or more points).