Skip to main content

Python gui for aircrack-ng

Project description


Aircrack-gui is a python gui for aircrack-ng using gtk3.0.

The priority was to make every step intuitive and easy)


PyGoObject version: > 3.38.0

Python version: 3: stable, 2: not tested.


git clone
cd aircrack-gui
pip install -r requirements.txt


  1. You must use aircrack-gui only on networks you have permission to.
  2. As this tool is only a gui, it will not work if the tools it uses behind the scenes do not work: python, aircrack-ng, hcxtools.



cd aircrack-gui

If any interface will be found, a window will open with the option to choose an interface, scan, start airmon-ng or open aircrack-ng.

Step 1: Set path (default: /home/SUDO_USER/Desktop/aircrack-ng/wifi/)

main window

Step 2: Press 'Scan for networks', wait for ~5 seconds (the main window can become unresponsive, that's normal). A new window will show up with a network list. Choose desired network, check that it has WPA2 encryption (right now WEP/WPA1 are not implemented), hit 'Start Airmon-ng on BSSID: NETWORK_BSSID'.

scanning window

Step 3: Aireplay-ng window will show up. Set amount of deauth packets to send (default: 10) and wait for station to appear (you can choose if several are found or type in a station mac address manually (format: xx-xx, xx:xx, xxxx)). Hit 'Run deauth (aireplay-ng)'. If you see 'Success' on top of the window, then a handshake was received successfully. If not, try changing the station or amount of packets.

P.S: If no stations are found, your signal strength is probably too low. Signal strength can be checked when you select your network in Step 2 and is measured from 0 to 100, higher being better.

aireplay-ng window

Step 4: Now, you can close aireplay-ng window. In the main window, press 'Open aircrack-ng', select .cap file (capture file located wherever you set it to in Step 1). Select a wordlist, hit 'Start aircrack-ng / hashcat' and hope for the best ;)

P.S If you want to convert your .cap to .22000 manually, visit official hashcat conversion website. Or, you can install hcxtools and .22000 files will be generated automatically.

aireplay-ng window

Command line arguments

Can be found by typing python3 -h.

Application Options:
  --nokill                   Do not run 'airmon-ng check kill'. Will retain internet connection on other devices, but is probably a bad idea.
  --noclean                  Do not clean .csv files generated by airodump-ng when scanning for clients.
  --nolog                    Do not print anything to console.
  --display=DISPLAY          X display to use


  • Change network scanning from nmcli to airmon-ng


  • 0.0.6 --- Added command line arguments. Files, generated by airodump-ng (.csv, .netxml) are now automatically deleted. Minor log improvements and code formatting.

  • 0.0.5 --- Added automatic .cap to .22000 conversion when selecting hashcat and hcxtools are installed. Minor ui updates.

  • 0.0.4 --- Removed xterm windows (except for aircrack-ng/hashcat), fixed selected station deselecting/changing when updated.

  • 0.0.3 --- Hashcat support.

  • 0.0.2 --- changes, etc.

  • 0.0.1 --- Initial commit.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for aircrack-gui, version 0.0.7
Filename, size File type Python version Upload date Hashes
Filename, size aircrack_gui-0.0.7-py3-none-any.whl (9.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size aircrack-gui-0.0.7.tar.gz (10.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page