{"id":13897315,"url":"https://github.com/nuncan/wifite2mod","last_synced_at":"2025-07-17T14:31:07.167Z","repository":{"id":126277647,"uuid":"137652193","full_name":"nuncan/wifite2mod","owner":"nuncan","description":"Rolling Release Branch for community PR's @Credits to derv82 \u0026 the community","archived":false,"fork":false,"pushed_at":"2019-04-19T19:07:12.000Z","size":1384,"stargazers_count":65,"open_issues_count":2,"forks_count":7,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-08-07T18:43:21.250Z","etag":null,"topics":["attack","bully","genpmk","hashcat","null","null-pin","pin","pixiedust","pmkid","precomputed-hash","reaver","wifite","wifite2","wpa-psk","wpa2","wps","wpspixie"],"latest_commit_sha":null,"homepage":"https://github.com/derv82/wifite2","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nuncan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2018-06-17T12:06:41.000Z","updated_at":"2024-05-15T08:12:36.000Z","dependencies_parsed_at":"2023-06-16T02:45:22.447Z","dependency_job_id":null,"html_url":"https://github.com/nuncan/wifite2mod","commit_stats":{"total_commits":327,"total_committers":25,"mean_commits":13.08,"dds":0.327217125382263,"last_synced_commit":"38d56c47e428216e09e099338d225532e80e51bc"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuncan%2Fwifite2mod","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuncan%2Fwifite2mod/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuncan%2Fwifite2mod/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuncan%2Fwifite2mod/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nuncan","download_url":"https://codeload.github.com/nuncan/wifite2mod/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226270545,"owners_count":17598075,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["attack","bully","genpmk","hashcat","null","null-pin","pin","pixiedust","pmkid","precomputed-hash","reaver","wifite","wifite2","wpa-psk","wpa2","wps","wpspixie"],"created_at":"2024-08-06T18:03:30.717Z","updated_at":"2024-11-25T03:30:57.110Z","avatar_url":"https://github.com/nuncan.png","language":"Python","readme":"Wifite\n======\n\nThis repo is a complete re-write of [`wifite`](https://github.com/derv82/wifite), a Python script for auditing wireless networks.\n\nWifite runs existing wireless-auditing tools for you. Stop memorizing command arguments \u0026 switches!\n\nWifite is designed to use all known methods for retrieving the password of a wireless access point (router).  These methods include:\n1. WPS: The [Offline Pixie-Dust attack](https://en.wikipedia.org/wiki/Wi-Fi_Protected_Setup#Offline_brute-force_attack)\n1. WPS: The [Online Brute-Force PIN attack](https://en.wikipedia.org/wiki/Wi-Fi_Protected_Setup#Online_brute-force_attack)\n2. WPA: The [WPA Handshake Capture](https://hashcat.net/forum/thread-7717.html) + offline crack.\n3. WPA: The [PMKID Hash Capture](https://hashcat.net/forum/thread-7717.html) + offline crack.\n4. WEP: Various known attacks against WEP, including *fragmentation*, *chop-chop*, *aireplay*, etc.\n\nRun wifite, select your targets, and Wifite will automatically start trying to capture or crack the password.\n\nCredits\n=======\n\n*  derv82\n*  kimocoder\n*  deix\n*  WhiteOnBlackCode\n*  Niller303\n*  examin\n*  rhertzog\n*  ChunshengZhao\n*  EdwardBetts\n*  schoonc\n*  random-robbie\n*  ritiek\n*  viniciusmarangoni\n*  goll\n\nSupported Operating Systems\n---------------------------\nWifite is designed specifically for the latest version of [**Kali** Linux](https://www.kali.org/). [ParrotSec](https://www.parrotsec.org/) is also supported.\n\nOther pen-testing distributions (such as BackBox or Ubuntu) have outdated versions of the tools used by Wifite. Do not expect support unless you are using the latest versions of the *Required Tools*, and also [patched wireless drivers that support injection]().\n\nRequired Tools\n--------------\nFirst and foremost, you will need a wireless card capable of \"Monitor Mode\" and packet injection (see [this tutorial for checking if your wireless card is compatible](http://www.aircrack-ng.org/doku.php?id=compatible_cards) and also [this guide](https://en.wikipedia.org/wiki/Wi-Fi_Protected_Setup#Offline_brute-force_attack)). There are many cheap wireless cards that plug into USB available from online stores.\n\nSecond, only the latest versions of these programs are supported and must be installed for Wifite to work properly:\n\n**Required:**\n\n* `python`: Wifite is compatible with both `python2` and `python3`.\n* [`iwconfig`](https://wiki.debian.org/iwconfig): For identifying wireless devices already in Monitor Mode.\n* [`ifconfig`](https://en.wikipedia.org/wiki/Ifconfig): For starting/stopping wireless devices.\n* [`Aircrack-ng`](http://aircrack-ng.org/) suite, includes:\n   * [`airmon-ng`](https://tools.kali.org/wireless-attacks/airmon-ng): For enumerating and enabling Monitor Mode on wireless devices.\n   * [`aircrack-ng`](https://tools.kali.org/wireless-attacks/aircrack-ng): For cracking WEP .cap files and WPA handshake captures.\n   * [`aireplay-ng`](https://tools.kali.org/wireless-attacks/aireplay-ng): For deauthing access points, replaying capture files, various WEP attacks.\n   * [`airodump-ng`](https://tools.kali.org/wireless-attacks/airodump-ng): For target scanning \u0026 capture file generation.\n   * [`packetforge-ng`](https://tools.kali.org/wireless-attacks/packetforge-ng): For forging capture files.\n\n**Optional, but Recommended:**\n\n* [`tshark`](https://www.wireshark.org/docs/man-pages/tshark.html): For detecting WPS networks and inspecting handshake capture files.\n* [`reaver`](https://github.com/t6x/reaver-wps-fork-t6x): For WPS Pixie-Dust \u0026 brute-force attacks.\n   * Note: Reaver's `wash` tool can be used to detect WPS networks if `tshark` is not found.\n* [`bully`](https://github.com/aanarchyy/bully): For WPS Pixie-Dust \u0026 brute-force attacks.\n   * Alternative to Reaver. Specify `--bully` to use Bully instead of Reaver.\n   * Bully is also used to fetch PSK if `reaver` cannot after cracking WPS PIN.\n* [`coWPAtty`](https://tools.kali.org/wireless-attacks/cowpatty): For detecting handshake captures.\n* [`pyrit`](https://github.com/JPaulMora/Pyrit): For detecting handshake captures.\n* [`hashcat`](https://hashcat.net/): For cracking PMKID hashes.\n   * [`hcxdumptool`](https://github.com/ZerBea/hcxdumptool): For capturing PMKID hashes.\n   * [`hcxpcaptool`](https://github.com/ZerBea/hcxtools): For converting PMKID packet captures into `hashcat`'s format.\n\n\nRun Wifite\n----------\n```\ngit clone https://github.com/derv82/wifite2.git\ncd wifite2\nsudo ./Wifite.py\n```\n\nInstall Wifite\n--------------\nTo install onto your computer (so you can just run `wifite` from any terminal), run:\n\n```bash\nsudo python setup.py install\n```\n\nThis will install `wifite` to `/usr/sbin/wifite` which should be in your terminal path.\n\n**Note:** Uninstalling is [not as easy](https://stackoverflow.com/questions/1550226/python-setup-py-uninstall#1550235). The only way to uninstall is to record the files installed by the above command and *remove* those files:\n\n```bash\nsudo python setup.py install --record files.txt \\\n  \u0026\u0026 cat files.txt | xargs sudo rm \\\n  \u0026\u0026 rm -f files.txt\n```\n\nBrief Feature List\n------------------\n* [PMKID hash capture](https://hashcat.net/forum/thread-7717.html) (enabled by-default, force with: `--pmkid`)\n* WPS Offline Brute-Force Attack aka \"Pixie-Dust\". (enabled by-default, force with: `--wps-only --pixie`)\n* WPS Online Brute-Force Attack aka \"PIN attack\". (enabled by-default, force with: `--wps-only --no-pixie`)\n* WPA/2 Offline Brute-Force Attack via 4-Way Handshake capture (enabled by-default, force with: `--no-wps`)\n* Validates handshakes against `pyrit`, `tshark`, `cowpatty`, and `aircrack-ng` (when available)\n* Various WEP attacks (replay, chopchop, fragment, hirte, p0841, caffe-latte)\n* Automatically decloaks hidden access points while scanning or attacking.\n   * Note: Only works when channel is fixed. Use `-c \u003cchannel\u003e`\n   * Disable this using `--no-deauths`\n* 5Ghz support for some wireless cards (via `-5` switch).\n   * Note: Some tools don't play well on 5GHz channels (e.g. `aireplay-ng`)\n* Stores cracked passwords and handshakes to the current directory (`--cracked`)\n   * Includes information about the cracked access point (Name, BSSID, Date, etc).\n* Easy to try to crack handshakes or PMKID hashes against a wordlist (`--crack`)\n\nWhat's new?\n-----------\nComparing this repo to the \"old wifite\" @ https://github.com/derv82/wifite\n\n* **Less bugs**\n   * Cleaner process management. Does not leave processes running in the background (the old `wifite` was bad about this).\n   * No longer \"one monolithic script\". Has working unit tests. Pull requests are less-painful!\n* **Speed**\n   * Target access points are refreshed every second instead of every 5 seconds.\n* **Accuracy**\n   * Displays realtime Power level of currently-attacked target.\n   * Displays more information during an attack (e.g. % during WEP chopchop attacks, Pixie-Dust step index, etc)\n* **Educational**\n   * The `--verbose` option (expandable to `-vv` or `-vvv`) shows which commands are executed \u0026 the output of those commands.\n   * This can help debug why Wifite is not working for you. Or so you can learn how these tools are used.\n* More-actively developed.\n* Python 3 support.\n* Sweet new ASCII banner.\n\nWhat's gone?\n------------\n* Some command-line arguments (`--wept`, `--wpst`, and other confusing switches).\n   * You can still access some of these obscure options, try `wifite -h -v`\n\nWhat's not new?\n---------------\n* (Mostly) Backwards compatible with the original `wifite`'s arguments.\n* Same text-based interface everyone knows and loves.\n\nScreenshots\n-----------\nCracking WPS PIN using `reaver`'s Pixie-Dust attack, then fetching WPA key using `bully`:\n![Pixie-Dust with Reaver to get PIN and Bully to get PSK](https://i.imgur.com/Q5KSDbg.gif)\n\n-------------\n\nCracking WPA key using PMKID attack:\n![PMKID attack](https://i.imgur.com/CR8oOp0.gif)\n\n-------------\n\nDecloaking \u0026 cracking a hidden access point (via the WPA Handshake attack):\n![Decloaking and Cracking a hidden access point](https://i.imgur.com/F6VPhbm.gif)\n\n-------------\n\nCracking a weak WEP password (using the WEP Replay attack):\n![Cracking a weak WEP password](https://i.imgur.com/jP72rVo.gif)\n\n-------------\n\nCracking a pre-captured handshake using John The Ripper (via the `--crack` option):\n![--crack option](https://i.imgur.com/iHcfCjp.gif)\n","funding_links":[],"categories":["Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnuncan%2Fwifite2mod","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnuncan%2Fwifite2mod","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnuncan%2Fwifite2mod/lists"}