← back to reliquary

Jam_fi

31 files

README

Jam_Fi – Wi-Fi Chaos Tool

ek0ms Banner

jamfi

What is Jam_Fi?

Jam_Fi is an offensive wireless toolkit for Kali Linux, built for red team simulation, network disruption research, and Wi-Fi exploitation education. It includes modules for:

  • Deauthentication attacks
  • WPA handshake capture and cracking
  • Probe request and junk frame flooding
  • Evil twin access points with credential logging
  • Karma responder beacon spoofing
  • MITM injection with fake update pages and keystroke logging.
  • Custom captive portals and payload delivery
  • Now with Ngrok Support!
  • CVE Vulnerability Scanner & Exploit Launcher (NEW)
  • Auto-Pwn Mode – Full Intrusive Chain (NEW)
  • Router Exploitation – Over‑the‑Air & IP‑based (NEW)

DISCLAIMER : All features are designed for local lab use and legal environments only.

Installation

Clone the repository

git clone https://github.com/ekomsSavior/Jam_Fi.git
cd Jam_Fi

Install dependencies

sudo apt update
sudo apt install -y aircrack-ng hostapd dnsmasq python3-scapy

ngrok Setup

wget https://bin.equinox.io/c/bNyj1mQVY4c/ngrok-v3-stable-linux-amd64.tgz
tar -xvzf ngrok-v3-stable-linux-amd64.tgz
sudo mv ngrok /usr/local/bin/

Authenticate your account:

ngrok config add-authtoken <YOUR_NGROK_AUTH_TOKEN>

Run the tool:

sudo python3 jam_fi.py

To update later:

cd Jam_Fi
git pull

Interface Modes: Monitor vs Managed

Jam_Fi now automatically handles interface mode switching for you. When you select a module, the tool will enable monitor mode if needed, and when you exit it will restore your normal network connectivity.

Monitor Mode (e.g. wlan0mon)

Required for:

  • Scan Clients & APs
  • Deauth One Client
  • Deauth All Clients
  • Probe Request Spam
  • Junk Packet Flood
  • Karma Responder
  • Chaos Mode
  • MITM HID Injection
  • CVE Vulnerability Scanner
  • Auto-Pwn Mode
  • Router Exploits (over‑the‑air attacks)

Enable manually with:

sudo airmon-ng start wlan0

Your monitor interface will usually be called wlan0mon.

Managed Mode (e.g. wlan0)

Required for:

  • Evil AP
  • Captive portal phishing
  • DNS redirection
  • Loot viewing
  • Cracking captured handshakes (optional)
  • Router Exploits (IP‑based exploits – automatic association)

Switch back with

sudo airmon-ng stop wlan0mon
sudo systemctl start NetworkManager

Note: The new Router Exploits module can automatically switch between modes when needed.

Jam_Fi Modules Overview

IMG_3145

Descriptions

  • Scan Clients & APs – Uses Scapy to sniff for access points and associated clients.
  • Deauth One Client – Sends deauth packets to a target MAC on a given AP.
  • Deauth ALL Clients + Capture – Deauths all known clients while capturing WPA handshakes.
  • Crack Captured Handshakes – Runs Aircrack-ng or Hashcat against captured .pcap files.
  • Probe Request Spam – Broadcasts fake SSIDs based on common public networks.
  • Junk Packet Flood – Sends randomized frames to clutter the spectrum.
  • Karma Responder – Replies to probe requests with fake beacons.
  • Chaos Mode – Combines probe spam, junk flood, and karma attack.
  • View Loot – Shows saved handshakes and credentials in loot/.
  • Evil AP – Launches a rogue access point with credential logging and DNS spoofing.
  • MITM HID Injection – Serve payloads + log keystrokes via HTML/JS.

New Modules (Options 12–14)

12. CVE Vulnerability Scanner & Exploit Launcher

This module performs deep fingerprinting of nearby Wi‑Fi clients (not APs) to identify known CVEs based on MAC OUI, hostname, user‑agent, and chipset information. It then offers to launch matching exploits.

  • How it works – Uses the monitor interface to sniff ARP, DHCP, and probe requests, building a detailed profile of each client (OS, vendor, chipset, probed SSIDs).
  • CVE matching – Compares client data against a local loot/cve_db.csv database (pre‑populated with dozens of high‑impact wireless/client CVEs).
  • Exploit launching – For matched CVEs (e.g., KRACK, Broadpwn, FragAttacks) you can automatically trigger the appropriate exploit.
  • Example – Detects an iPhone running iOS 14.2 and offers to launch KRACK (CVE‑2019‑15126).

13. Auto-Pwn Mode – Full Intrusive Chain

Automated version of the CVE scanner. It fingerprints every client in range, checks for vulnerabilities, and automatically launches exploits against those that are vulnerable – no user intervention required. Ideal for fast, unattended red‑team operations.

14. Router Exploits – Over‑the‑Air & IP‑based

A comprehensive router exploitation module that works both in monitor mode (no association) and by temporarily associating to the target network for full IP‑based exploits.

Features

  • Channel hopping – Scans all 13 2.4 GHz channels to discover every AP in range (hundreds found in dense areas).
  • OUI manufacturer lookup – Identifies router vendor (TP‑Link, Huawei, Asus, Netgear, D‑Link, Zyxel, Arris, Tenda, Cisco, Linksys, MikroTik, etc.) from the BSSID.
  • Automatic vulnerability mapping – Shows known CVEs and botnet exploits for each detected vendor.

Attack Options

  1. Auto‑Connect & IP Exploits
  2. Temporarily associates with the selected AP (WPA2‑PSK or open).
  3. Automatically obtains a DHCP lease and detects the gateway IP.
  4. Launches manufacturer‑specific exploits including:
    • Quad7 Botnet (CVE‑2023‑50224, CVE‑2025‑9377)
    • AVrecon (Russian GRU espionage malware)
    • AyySSHush (Asus persistent SSH backdoor)
    • Dray:Break (DrayTek multiple RCE)
    • CVE‑2023‑33538 (EoL TP‑Link Mirai)
    • Classic exploits: Huawei UPnP, MikroTik WinBox, TP‑Link auth bypass, Netgear CGI, D‑Link Hedwig, Zyxel weblogin
  5. After successful exploitation, can install a persistent backdoor (cron job, startup script, or reverse shell).

  6. Automatically restores monitor mode when finished.

  7. Deauth Attack – Floods the target AP with deauthentication frames, disconnecting all clients (pure monitor mode, no IP needed).

  8. Beacon Flood – Creates hundreds of fake evil twin APs around the target, causing client confusion.

  9. Client Traffic Capture – Sniffs nearby client activity (MAC addresses, probe requests) for reconnaissance.

  10. Manual IP Entry – For when you already know the router’s IP (e.g., your own lab) and want to skip auto‑association.

Why over‑the‑air? Many botnets (Quad7, AVrecon) operate purely by scanning beacon frames and launching deauth/flood attacks. Our module supports that style, but also goes further by associating when a real IP‑based exploit is needed.

Supported Router Vendors (Partial List)

  • TP‑Link, Huawei, Asus, Netgear, D‑Link, Zyxel, Arris, Tenda, Cisco, Linksys, MikroTik, Actiontec, Verizon, T‑Mobile, Mediatek, DrayTek

The loot/ Folder

JamFi logs data, HTML, and attack files to loot/:

File Purpose
injection.html JS keylogger + redirect to fake update
fake_update.html Auto-download payload on user click
keystroke_log_*.txt Logs captured JS keystrokes during MITM
session_log_*.txt Visitor IPs, paths, user agents
hostapd.conf Evil AP config
dnsmasq.conf DHCP/DNS for fake AP
dnsspoof_hosts Forces DNS to attacker (10.0.0.1)
cve_db.csv Local CVE database for client fingerprinting
handshake_*.pcap Captured WPA handshakes
creds.txt Captured credentials from Evil AP

The payloads/ Folder

Add real payloads here! These get served by the MITM module:

File Example Description
payload.exe Real .exe payload (e.g. msfvenom shell)
reverse_shell.zip Archive with malicious scripts
payload.bat Batch script for Windows
keylogger_beacon.py Python beacon/keylogger script
autostart.html HTML payload w/ JS autostart tricks
macro.vba Word macro payload (manual delivery)
loot_dropper.py Python dropper or payload loader

also check out the payloads_README in the payloads folder xo

MITM HID Injection Overview

When you choose option 11 in JamFi:

  • Broadcasts a fake SSID using beacon spoofing
  • Clients connect and are served injection.html
  • JavaScript keylogger logs user keystrokes (including special keys)
  • Page auto-redirects to fake_update.html
  • Payload downloads when the user clicks Update
  • Logs are saved to loot/session_log_*.txt and loot/keystroke_log_*.txt

All files are served from:
http://10.0.0.1

To add your own payloads, drop them into the payloads/ folder. JamFi will automatically load and offer them during MITM mode.

Ngrok Setup (for Remote Payload Delivery)

Want to serve payloads outside your local network? JamFi supports Ngrok for public tunnels.

Setup Instructions

  1. Download Ngrok for Linux:
    bash cd ~/Jam_fi wget https://bin.equinox.io/c/bNyj1mQVY4c/ngrok-stable-linux-amd64.zip unzip ngrok-stable-linux-amd64.zip chmod +x ngrok

  2. Add your Ngrok authtoken (from your Ngrok Dashboard):
    bash ./ngrok config add-authtoken YOUR_AUTHTOKEN

That’s it! When you launch MITM Mode and choose Ngrok, JamFi will automatically:

  • Start a public tunnel on port 80
  • Rewrite your HTML files to use https://<your-ngrok>.ngrok-free.app
  • Serve your payloads globally

Warning: Ngrok links are public. Use only in secure test labs.

Evil AP Customization

Edit loot/login.html to create a custom phishing page:

<h2>Welcome to Starbucks Free Wi-Fi</h2>
<p>Please sign in to continue</p>
<form method="POST" action="/login">
  <input type="text" name="username" placeholder="Email"><br>
  <input type="password" name="password" placeholder="Wi-Fi Password"><br>
  <input type="submit" value="Connect">
</form>

Captured credentials are logged to loot/creds.txt.

Disclaimer

Jam_Fi is provided for educational and authorized security research only.

Do not use this tool against networks or devices you do not own or have permission to test.

Use responsibly, ethically, and within legal boundaries.

source code

files

viewer

select a file
// click a file to view source

license

MIT License Copyright (c) 2026 ek0mssavi0r / Church of Malware Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. USE AT YOUR OWN RISK. NO WARRANTY PROVIDED.
download .zip // inspect all source before execution
Church of Malware · read. become. evolve.