An ARP scanner/jammer with an msfconsole-style CLI. Builds and runs on both Linux and Windows; packet capture/injection goes through libpcap on Linux and Npcap (its Windows-API-compatible counterpart) on Windows.
Requires libpcap-dev, pkg-config, CMake and a C compiler.
sudo apt install build-essential cmake pkg-config libpcap-dev # Debian/Ubuntu
./build.sh -d # Debug build
./build.sh --releaseCapturing/injecting raw frames needs CAP_NET_RAW, so run the built
binary as root (or setcap cap_net_raw+ep on the executable).
Requires Visual Studio (with the C++ build tools) and CMake.
- Install the Npcap runtime (needed to run the program, not just build it).
- Run
build.bat -d(or--release). On first configure, CMake downloads the Npcap SDK (headers + import libs) intothird_party/npcap-sdkautomatically. If that download fails (e.g. no network access from the build machine), download the SDK zip yourself from the link above and extract it there, or point-DNPCAP_SDK_DIR=<path>at an existing copy.
Npcap restricts raw adapter access to Administrators by default, so run
the built njamx.exe from an elevated terminal.
-i/--interface takes the interface's OS name: eth0/wlan0 on
Linux, and the adapter's friendly name as shown in "Network
Connections" (e.g. Ethernet, Wi-Fi) on Windows.
On Linux this flips the interface down, sets the new hardware address, and brings it back up (root required).
On Windows there's no direct equivalent, so it writes the adapter's
NetworkAddress registry override and cycles the adapter with netsh
to apply it. This requires Administrator privileges and a NIC driver
that honors the override (most Ethernet/Wi-Fi drivers do, some don't).
./build.sh --release -p / .\build.bat --release -p builds a
distributable package after building:
- Linux: a
.deb(via CPack) whose postinstall script grantsCAP_NET_RAW(and, if you say yes when asked,CAP_NET_ADMIN) to the installed binary withsetcap, so it doesn't needsudoon every run. Needscpack. - Windows: an NSIS installer (
packaging/windows/installer.nsi, built directly withmakensis- needs NSIS installed, not CPack's NSIS generator, since that can't do what's described below). It:- Lets you choose "install for me only" or "install for all users" (the latter needs admin and elevates automatically), followed by the normal browsable destination-folder page.
- Bundles and launches Npcap's own installer interactively (not silently - Npcap's free license reserves unattended install for its paid OEM tier).
- Asks whether to add njamx's folder to
PATH, and if so, for your account only or for all users (the latter only offered when installing for all users). Removed again on uninstall.