Graph visualization of wireless client and access point relationships
Switch branches/tags
Nothing to show
Clone or download
Latest commit 119fd33 Oct 25, 2018
Failed to load latest commit information.
examples add code Oct 17, 2018
static update v0.2 Oct 21, 2018
templates update v0.2 Oct 21, 2018
.gitattributes add language fix Oct 17, 2018
.gitignore update README Oct 18, 2018 update v0.2 Oct 21, 2018
LICENSE update LICENSE and README Oct 17, 2018 fix README switches Oct 22, 2018 fix OUI lookup Oct 26, 2018
manuf fix OUI lookup Oct 26, 2018
requirements-linux-gui.txt update v0.1.1 Oct 18, 2018
requirements.txt update v0.1.1 Oct 18, 2018




BeaconGraph is an interactive tool that visualizes client and Access Point relationships. Inspired by airgraph-ng and Bloodhound, BeaconGraph aims to support wireless security auditing. It is written in Python with GUI support by pywebview and a Neo4j backend. Relationship rendering is supported by cytoscape.js and is served by Flask.

BeaconGraph v0.2 Write-Up


  • Python >= 3.5
  • Neo4j


All versions w/o GUI

pip3 install -r requirements.txt

Linux w/ GUI

NOTE: Ensure your pip is for python3.

sudo apt-get install python3-pip python3-gi python-gi libwebkit2gtk-4.0-dev
pip3 install -r requirements-linux-gui.txt
pip3 install pywebview[qt5]  

Supported Platforms for GUI:

  • Ubuntu 18.04.1
  • Linux Mint 19

If you recieve GTK/QT errors when attempting to launch with GUI, BeaconGraph can still be accessed by pointing your browser to http://localhost:58008.

Acceptable CSV Formats

  • airodump-ng


./ <airodump CSV file>

--no-flush: Do NOT delete current database before adding new entries
--manuf: Update the Wireshark OUI Lookup file
--gui: Attempt to launch app in a GUI instead of browser (may not work)
--parse: Parse CSV files into neo4j database without launching app
-a or --airodump-csv: Airodump-ng formatted CSV


Logo Highlight

Things To Do

  • Verify all encryption types display properly (WEP/WPA)
  • Clean up and separate code from one file
  • Create wiki
  • Package binaries for Windows/Linux/OSX
  • Add Kismet CSV support


This project is 100% open source. Use this code as you wish (except commercially) but please attribute to author and respect all licenses of third-party code.