Feature Request: Bundle wifite2 (kimocoder fork) with Flipper Blackhat OS

[DensenDeluxe]

Summary

First of all, thanks a lot for your work on Flipper Blackhat OS and the whole Flipper Blackhat ecosystem – it’s an awesome WiFi security testing platform.

I would like to request that wifite2 (the kimocoder fork) be included as a preinstalled tool (or as an officially supported package/option) in Flipper Blackhat OS:

https://github.com/kimocoder/wifite2

---

Motivation / use case

Flipper Blackhat OS is already focused on WiFi pentesting and network analysis, and it ships with a number of WiFi and exploitation tools. wifite2 fits perfectly into this toolbox because it:

• Wraps common WiFi tools (aircrack-ng suite, etc.) behind a single CLI
• Automates:
  • Target scanning
  • Handshake/PMKID/SAE capture
  • WPS attacks
  • Evil Twin / captive portal style attacks
  • Various WPA/WPA3 workflows
• Supports more advanced setups such as:
  • Dual interface mode (--dual-interface)
  • Evil Twin with dual adapters
  • WPA/WPA3 attacks with continuous capture

For many users, this dramatically lowers the barrier to running complex WiFi audits on the Blackhat board.

---

Proposed integration

Baseline idea

• Ship wifite2 (kimocoder fork) in the default Flipper Blackhat OS image, installed as a CLI tool available in $PATH (wifite or wifite2 command).
• Ensure required dependencies are present in the image, for example:
  • Python 3 (version compatible with wifite2)
  • aircrack-ng suite and related wireless tools
  • iw / ip (for interface handling)
  • Optional but nice-to-have: tshark, reaver, bully, etc.

Optional enhancements

• Add a short section to BLACKHAT_REFERENCE.md describing:
  • That wifite2 is included
  • A couple of example commands (e.g. sudo wifite --dual-interface, sudo wifite --eviltwin)
• (Nice to have) Provide a simple wrapper script or menu entry that launches wifite2 with sensible defaults for the Flipper Blackhat hardware.

---

Potential considerations

• Image size: wifite2 itself is fairly small; most of the size impact would come from dependencies which may already be present for other tools.
• Licensing: wifite2 is GPL-2.0 licensed. As a userland tool packaged in the OS image, this should be fine as long as the usual GPL requirements are respected (source availability, etc.), but you’ll likely want to double-check that this aligns with how you handle other GPL tools.
• Integration method: Since Flipper Blackhat OS does not provide a traditional package manager like apt, adding wifite2 is best done directly in the build system (e.g. as a Buildroot package or via a rootfs overlay) rather than expecting users to install it manually on-device.

---

Environment

• Flipper Blackhat OS: BlackhatOS v1.3 (latest release at the time of writing)
• Hardware:
  • Flipper Blackhat board (A33)
  • Flipper Zero

---

Alternatives / workarounds

Right now, there is no straightforward way for an average user to install wifite2 plus all required dependencies directly on the device, because:

• The stock image does not ship with a full package manager like apt.
• Manually cloning wifite2 and installing Python dependencies still requires that all external tools (aircrack-ng, hcxtools, reaver, etc.) are already present and correctly configured.

The only realistic workaround is to build a custom Blackhat OS image from source and include wifite2 (and its dependencies) yourself, for example:

• Adding wifite2 as a Buildroot package
• Or using a rootfs overlay to bundle it and its dependencies into the image

This is feasible for advanced users but not practical or user-friendly for most people, which is exactly why having it integrated into the official image would be so valuable.

---

Closing

If you’re open to the idea but prefer a specific integration approach (e.g. Buildroot package, optional config flag, or a separate “WiFi extras” image), I’d be happy to adapt to that direction and test it.

Thanks for considering this request!

[DensenDeluxe]

Just to add a bit more context to this request:

The idea behind having wifite2 on Flipper Blackhat OS is to use it for the WiFi side of things (scanning, attacking, capturing handshakes, cracking keys, etc.) and then use Bjorn for the post-access exploitation phase once a network has been opened.

In an ideal setup, there would eventually be a small orchestration script that:

1. Runs wifite2 to discover targets and obtain access (handshake/PMKID → key → connect),
2. Automatically configures the interface and connects to the newly opened WiFi,
3. Triggers Bjorn modules against the hosts on that network for further enumeration and exploitation.

That kind of “wifite to open, Bjorn to exploit” workflow – preferably automated by a wrapper script – would make Flipper Blackhat OS a very powerful end-to-end WiFi auditing platform.

[o7-machinehum]

https://github.com/o7-machinehum/flipper-blackhat-os/actions/runs/19626721420

Once the CI build action is done, can you give it a test?

[DensenDeluxe]

Thank you Ryan. I will test it now.

[DensenDeluxe]

Quick update after testing on the current Blackhat OS image:

It looks like wifite2 is already present on the system (I’m seeing wifite2 2.9.9-beta when I run wifite on the device):

# wifite
   .               .
 .´  ·  .     .  ·  `.  wifite2 2.9.9-beta
 :  :  :  (¯)  :  :  :  a wireless auditor by derv82
 `.  ·  ` /¯\ ´  ·  .´  maintained by kimocoder
   `     /¯¯¯\     ´    https://github.com/kimocoder/wifite2

 [+] option: targeting all known encryption types by default
 [!] Warning: Recommended app reaver was not found. install @ https://github.com/t6x/reaver-wps-fork-t6x
 [!] Warning: Recommended app bully was not found. install @ https://github.com/kimocoder/bully
 [!] Warning: Recommended app tshark was not found. install @ apt install tshark
 [!] Warning: Recommended app hashcat was not found. install @ https://hashcat.net/hashcat/
 [!] Warning: Recommended app hcxdumptool was not found. install @ apt install hcxdumptool
 [!] Warning: Recommended app hcxpcapngtool was not found. install @ apt install hcxtools
 [!] Warning: Recommended app macchanger was not found. install @ apt install macchanger

 [!] Warning: WPA3 attacks will not be available
 [!] Missing WPA3 tools: hcxdumptool, hcxpcapngtool, hashcat
 [!] Install with: apt install hcxdumptool hcxtools


 [!] Warning: wpa-sec upload functionality will not be available
 [!] Missing tool: wlancap2wpasec
 [!] Install with: apt install hcxtools
 [!] wpa-sec allows uploading captures to wpa-sec.stanev.org for online cracking


 [+] Checking airmon-ng...
 [!] airmon-ng did not find any wireless interfaces
 [!] Make sure your wireless device is connected
 [!] See https://www.aircrack-ng.org/doku.php?id=airmon-ng for more info

 [!] Unexpected Error: airmon-ng did not find any wireless interfaces

 [!] Error: airmon-ng did not find any wireless interfaces

 [!] Full stack trace below

 [!]    Traceback (most recent call last):
 [!]    File "/usr/lib/python3.13/site-packages/wifite/wifite.py", line 1272, in main
 [!]    File "/usr/lib/python3.13/site-packages/wifite/wifite.py", line 127, in start
 [!]    File "/usr/lib/python3.13/site-packages/wifite/config.py", line 328, in get_monitor_mode_interface
 [!]    File "/usr/lib/python3.13/site-packages/wifite/tools/airmon.py", line 405, in ask
 [!]  Exception: airmon-ng did not find any wireless interfaces

 [!] Exiting

So from my side, the situation is now:

wifite2 itself seems to be integrated already

Several recommended external tools (reaver, bully, tshark, hashcat, hcxdumptool, hcxpcapngtool, macchanger, hcxtools, wlancap2wpasec) are still missing... my fault: theire not only nice to have

airmon-ng currently does not see any wireless interfaces in my test setup

If there’s anything I can test on my setup (different adapter, specific commands, etc.), I’m happy to try it and report back.

[o7-machinehum]

Quick update after testing on the current Blackhat OS image:

It looks like wifite2 is already present on the system (I’m seeing wifite2 2.9.9-beta when I run wifite on the device):

# wifite
   .               .
 .´  ·  .     .  ·  `.  wifite2 2.9.9-beta
 :  :  :  (¯)  :  :  :  a wireless auditor by derv82
 `.  ·  ` /¯\ ´  ·  .´  maintained by kimocoder
   `     /¯¯¯\     ´    https://github.com/kimocoder/wifite2

 [+] option: targeting all known encryption types by default
 [!] Warning: Recommended app reaver was not found. install @ https://github.com/t6x/reaver-wps-fork-t6x
 [!] Warning: Recommended app bully was not found. install @ https://github.com/kimocoder/bully
 [!] Warning: Recommended app tshark was not found. install @ apt install tshark
 [!] Warning: Recommended app hashcat was not found. install @ https://hashcat.net/hashcat/
 [!] Warning: Recommended app hcxdumptool was not found. install @ apt install hcxdumptool
 [!] Warning: Recommended app hcxpcapngtool was not found. install @ apt install hcxtools
 [!] Warning: Recommended app macchanger was not found. install @ apt install macchanger

 [!] Warning: WPA3 attacks will not be available
 [!] Missing WPA3 tools: hcxdumptool, hcxpcapngtool, hashcat
 [!] Install with: apt install hcxdumptool hcxtools


 [!] Warning: wpa-sec upload functionality will not be available
 [!] Missing tool: wlancap2wpasec
 [!] Install with: apt install hcxtools
 [!] wpa-sec allows uploading captures to wpa-sec.stanev.org for online cracking


 [+] Checking airmon-ng...
 [!] airmon-ng did not find any wireless interfaces
 [!] Make sure your wireless device is connected
 [!] See https://www.aircrack-ng.org/doku.php?id=airmon-ng for more info

 [!] Unexpected Error: airmon-ng did not find any wireless interfaces

 [!] Error: airmon-ng did not find any wireless interfaces

 [!] Full stack trace below

 [!]    Traceback (most recent call last):
 [!]    File "/usr/lib/python3.13/site-packages/wifite/wifite.py", line 1272, in main
 [!]    File "/usr/lib/python3.13/site-packages/wifite/wifite.py", line 127, in start
 [!]    File "/usr/lib/python3.13/site-packages/wifite/config.py", line 328, in get_monitor_mode_interface
 [!]    File "/usr/lib/python3.13/site-packages/wifite/tools/airmon.py", line 405, in ask
 [!]  Exception: airmon-ng did not find any wireless interfaces

 [!] Exiting

So from my side, the situation is now:

wifite2 itself seems to be integrated already

Several recommended external tools (reaver, bully, tshark, hashcat, hcxdumptool, hcxpcapngtool, macchanger, hcxtools, wlancap2wpasec) are still missing... my fault: theire not only nice to have

airmon-ng currently does not see any wireless interfaces in my test setup

If there’s anything I can test on my setup (different adapter, specific commands, etc.), I’m happy to try it and report back.

Can you give me a list of which of those requirements you would like? That way it's easier for me to understand the requirements.

[DensenDeluxe]

Hi, thanks for the follow-up!

To answer your question about the dependencies: on the current BlackhatOS image wifite2 starts and works, but it still reports all of these as missing “recommended apps”:

Suggest using python3 as python2 was marked deprecated as of january 2020.
As we moved from older python and changed to fully support and run on python3.14
Iw: For identifying wireless devices already in Monitor Mode.
Ip: For starting/stopping wireless devices.
Aircrack-ng suite, includes:
airmon-ng: For enumerating and enabling Monitor Mode on wireless devices.
aircrack-ng: For cracking WEP .cap files and WPA handshake captures.
aireplay-ng: For deauthing access points, replaying capture files, various WEP attacks.
airodump-ng: For target scanning & capture file generation.
packetforge-ng: For forging capture files.

tshark: For detecting WPS networks and inspecting handshake capture files.
reaver: For WPS Pixie-Dust & brute-force attacks.
Note: Reaver's wash tool can be used to detect WPS networks if tshark is not found.
bully: For WPS Pixie-Dust & brute-force attacks.
Alternative to Reaver. Specify --bully to use Bully instead of Reaver.
Bully is also used to fetch PSK if reaver cannot after cracking WPS PIN.
john: For CPU (OpenCL)/GPU cracking passwords fast.
coWPAtty: For detecting handshake captures.
hashcat: For cracking PMKID hashes and WPA3-SAE hashes.
hcxdumptool: For capturing PMKID hashes and WPA3-SAE handshakes.
hcxpcapngtool: For converting PMKID and SAE packet captures into hashcat's format.
Note: For WPA3 support, you need hcxdumptool v6.0.0+ and hashcat v6.0.0+ with mode 22000 support.
macchanger: For randomizing MAC addresses to avoid detection and improve anonymity.
pixiewps: For WPS Pixie-Dust attacks (alternative implementation).
For Evil Twin Attacks:

hostapd: For creating rogue access points (v2.9+ required).
dnsmasq: For DHCP and DNS services (v2.80+ required).
wpa_supplicant: For validating captured credentials (v2.9+ required).

From a user perspective, all seven are effectively needed if you want full wifite2 functionality on BlackhatOS (WPS, robust WPA/WPA3/PMKID capture + conversion, proper handshake validation, reliable offline cracking, and MAC randomization). Without them:

• wifite2 still runs,

• but several attack modes are disabled or downgraded,

• and you always get the warning banner like:

  [!] Warning: Recommended app reaver was not found. install @ https://github.com/t6x/reaver-wps-fork-t6x
  ...