explaingit

brannondorsey/wifi-cracking

12,356Audience · ops devopsComplexity · 2/5Setup · hard

TLDR

A step-by-step Linux tutorial for testing your own WPA/WPA2 Wi-Fi network's password strength by capturing a handshake and running an offline dictionary attack with Aircrack-ng or Hashcat.

Mindmap

mindmap
  root((wifi-cracking))
    What it is
      Security tutorial
      WPA WPA2 testing
    Process
      Monitor mode
      Capture handshake
      Dictionary attack
    Tools
      Aircrack-ng
      Hashcat
      Kali Linux
    Audience
      Security learners
      Network admins
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Test whether your own home or office Wi-Fi password is strong enough to withstand a dictionary attack.

USE CASE 2

Learn how WPA/WPA2 handshake capture and offline cracking works as part of a network security course.

USE CASE 3

Practice using Aircrack-ng and Hashcat in a Kali Linux environment on a network you own.

Tech stack

BashAircrack-ngHashcatKali Linux

Getting it running

Difficulty · hard Time to first run · 1h+

Requires a wireless card that supports monitor mode, Kali Linux, and the Aircrack-ng suite installed.

In plain English

This repository is a step-by-step tutorial explaining how to test a WPA/WPA2 Wi-Fi network's resistance to password guessing attacks. WPA and WPA2 are the security protocols most home and office Wi-Fi routers use. The tutorial is written for Linux users, specifically those running Kali Linux, a distribution designed for security testing. The process works by putting a wireless card into a listening mode, waiting for a device to join the target network, capturing the brief authentication exchange that happens when it does (called a handshake), and then running that captured data through a password-guessing tool offline. The guessing tool tests thousands or millions of common passwords against the captured handshake to see if any match. The tutorial covers two tools for this: Aircrack-ng for CPU-based guessing and Hashcat for GPU-based guessing, which is significantly faster. The README includes the exact commands to run at each step, sample output showing what to expect, and notes on an optional faster technique that actively forces connected devices to reconnect so you can capture the handshake sooner. The tutorial states clearly that it is for educational purposes and for testing your own network, and includes a disclaimer that using it against networks you do not own or have permission to test is not authorized. This is a tutorial repository with no installable code. It requires specific hardware (a wireless card that supports monitor mode), Linux, and the Aircrack-ng software suite. A Chinese translation of the tutorial is also included in the repository.

Copy-paste prompts

Prompt 1
I want to test my own WPA2 Wi-Fi network's password strength using Aircrack-ng on Kali Linux. Give me the exact step-by-step commands to put my card into monitor mode, capture the handshake, and run a dictionary attack.
Prompt 2
What wireless card chipsets support monitor mode and packet injection and are compatible with the aircrack-ng toolset used in this tutorial?
Prompt 3
How does Hashcat's GPU-based WPA2 cracking speed compare to Aircrack-ng's CPU-based approach, and when should I use each?
Open on GitHub → Explain another repo

← brannondorsey on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.