wifit3 README

The project's README from github.com/derv82/wifit3. As one markdown file: README.md.

wifit3

A standalone USB Wi-Fi auditor for Linux, Windows, and macOS.

wifit3 splash / adapter picker

At least one of the supported USB adapters is required.

Why?

wifit3 in action: WPS PushButton PSK capture


Features

Reconnaissance & Analysis

Attacks & Captures

Screenshots

Scanner Focus (single target)
Scanner Focus

Supported Hardware

Important: At least one supported USB wireless adapter is required.

Chipset Bands Cards (Make + Model)
Atheros AR9271 2.4 GHz ALFA AWUS036NHA, TP-Link TL-WN722N V1
MediaTek MT7610U 2.4 / 5 GHz ALFA AWUS036ACHM, Panda PAU0B
MediaTek MT7612U 2.4 / 5 GHz ALFA AWUS036ACM
MediaTek MT7921AU 2.4 / 5 GHz ALFA AWUS036AXML, Panda PAU0F
MediaTek MT7925U 2.4 / 5 GHz Netgear A9000
Realtek RTL8812AU 2.4 / 5 GHz ALFA AWUS036ACH
Realtek RTL8814AU 2.4 / 5 GHz ALFA AWUS1900
Realtek RTL8821AU 2.4 / 5 GHz ALFA AWUS036ACS, TP-Link Archer T2U Plus/Nano
Realtek RTL8821CU 2.4 / 5 GHz Auscoumer 600 Mbps
Realtek RTL8922AU 2.4 / 5 GHz ASUS USB-BE93
Realtek RTL8822BU 2.4 / 5 GHz TP-Link T3U Plus, Archer T4U v3 / T4U+
Realtek RTL8822CU 2.4 / 5 GHz D-Link AC13U
Realtek RTL8187L 2.4 GHz ALFA AWUS036H
Realtek RTL8188EUS 2.4 GHz TP-Link TL-WN722N v2/v3
Ralink RT2570 2.4 GHz Buffalo Nintendo Wi-Fi USB Controller
Ralink RT3070 2.4 GHz ALFA AWUS036NH
Ralink RT5370 2.4 GHz LOTEKOO 150 Mbps
Ralink RT5372 2.4 GHz Panda PAU05/PAU06
Ralink RT5572 2.4 / 5 GHz Panda PAU09 N600

Breakdown of each device's capabilities and limitations: Supported Hardware Doc.

Installation & Running

Download the latest standalone executable from Releases:

Option 2: Run from Source

wifit3 uses Astral's uv. sync sets up dependencies:

uv sync
uv run wifit3

Option 3: Build your own binary

uv run pyinstaller wifit3.spec --noconfirm --clean

Binary executable is written to dist/ subdirectory.

One-Time Driver Setup

wifit3 automatically handles hardware configuration within the app, after clicking the START button:

Uninstalling

Return the previously-installed device to your operating system's Wi-Fi stack:

  1. Select the card on the wifit3 splash screen.
  2. Click the Uninstall button and confirm.
  3. Accept the elevation prompt (UAC on Windows or pkexec on Linux).
  4. Unplug and re-plug the adapter.

On Linux, this deletes wifit3's udev and modprobe rules. On Windows, this uninstalls the WinUSB binding, and triggers a PnP device rescan (old driver reattaches).

Thank you, Linux!

wifit3 only exists because of the great people who reverse-engineered and maintained these Linux wireless drivers. It's usually a thankless job.

Special thanks to:

The full list is in CREDITS.md.

How it Works: Mini-Drivers

wifit3 bypasses the operating system's native Wi-Fi stack entirely. It ships with lightweight Python ports of Linux kernel drivers (src/wifit3/chips/*) that directly control wireless devices over USB bulk and control transfers.

Because register-level frame injection and monitor mode are performed entirely in user space, Windows NDIS restrictions and Linux kernel driver locking do not apply.

For architecture details, driver porting methodology, and USB trace replay tooling, see the Porting Documentation.

License & Disclaimer

Code: Licensed under GNU General Public License v2.0 (matching upstream Linux drivers).

Firmware: Vendor firmware blobs loaded onto adapters are redistributed verbatim under their respective manufacturers' licenses (details in FIRMWARE.md).

⚠️ Notice & Disclaimer: For use only on networks and equipment you own or are explicitly authorized to audit. wifit3 operates directly on USB hardware registers without kernel guardrails; use at your own risk.

wifit3 (derv82/wifit3)

Searching Database…

2.5K ·GitHub
Что это?wifit3 — автономный инструмент аудита безопасности Wi-Fi: сканирует сети, перехватывает рукопожатия WPA/WPA2 и эксплуатирует слабости WPS/WEP с поддерживаемым USB Wi-Fi-адаптером, не полагаясь на aircrack-ng или драйверы ядра ОС.
Это приложение с GUI или терминальный инструмент?Это терминальный инструмент с текстовым интерфейсом (TUI), написанный на чистом Python с библиотеками PyUSB и Textual, а не традиционное GUI-приложение и не библиотека для импорта.
Как его запустить?Скачайте готовый автономный исполняемый файл для своей ОС со страницы Releases (например, wifit3-windows-x64.exe или chmod +x wifit3-linux-x64 на Linux), либо запустите из исходников, установив зависимости через uv от Astral, либо соберите свой бинарник.
Нужен ли специальный Wi-Fi-адаптер?Да, нужен хотя бы один адаптер из конкретного списка поддерживаемых USB Wi-Fi-адаптеров (Atheros AR9271, MediaTek MT7610U/MT7612U/MT7921AU/MT7925U, серия Realtek RTL88xx, чипы Ralink RT и т. д.); встроенный ноутбучный Wi-Fi-модуль не подойдёт.
Что происходит при первом запуске сканирования?wifit3 автоматически выполняет однократную настройку драйвера, когда вы нажимаете START: на Linux он один раз запрашивает через pkexec/sudo запись правил udev, на macOS достаточно разрешить устройство в диалоге, а на Windows через UAC предлагается установить драйвер WinUSB для адаптера.
Как wifit3 обходится без драйверов ядра?В него входят лёгкие порты беспроводных драйверов ядра Linux на Python, которые общаются с USB-устройством напрямую через bulk- и control-передачи, поэтому режим монитора и инъекция кадров полностью происходят в пространстве пользователя, минуя и ограничения Windows NDIS, и блокировки драйверов ядра Linux.
Какие атаки на самом деле умеет wifit3?Он может пассивно прослушивать или активно вызывать рукопожатия WPA/WPA2 и материал PMKID, проводить атаку EvilTwin с даунгрейдом WPA3, клонируя точку доступа и отключая клиентов, восстанавливать WPS PIN через PixieDust или брутфорс, вытаскивать PSK через обнаружение кнопки WPS и выполнять классические атаки WEP вроде ARP replay, ChopChop и восстановления ключей PTW.
Законно ли запускать wifite3 против любой найденной сети?Нет, в README прямо сказано, что использовать его можно только на сетях и оборудовании, которыми вы владеете или аудит которых вам явно разрешён, поскольку он напрямую манипулирует регистрами USB-железа без защитных механизмов ядра.
Как отменить внесённые им изменения драйверов?Выберите адаптер на стартовом экране wifit3, нажмите Uninstall и подтвердите запрос на повышение прав; это удалит правила udev/modprobe на Linux или привязку WinUSB на Windows, и обычный Wi-Fi-драйвер ОС снова подхватится после переподключения.
Creator
derv82
Size
24.1 MB
Stars
2.5K
Age
3mo
Commits · 90 Days