Skip to content

WiFi Manager

7h30th3r0n3 edited this page Apr 11, 2026 · 4 revisions

📶 WiFi Manager


Overview

RaspyJack includes a WiFi management system for scanning, connecting, and switching interfaces. It supports dual-interface setups (eth0 + wlanX) and lets you control which interface tools use.


Tools Used

  • nmcli / NetworkManager (WiFi scanning and connection)
  • RaspyJack WiFi modules (wifi/ folder)

How It Works

  1. Detects WiFi interfaces (wlan0/wlan1/wlan2).
  2. Scans for networks using nmcli (ensures scan cache consistency with connect).
  3. Connects using the user-selected interface via Interface Config menu.
  4. Supports dual-interface operation: wlan0 on one AP, wlan1 on another (or monitor mode).
  5. Status bar shows active interface + connected SSID at all times.

Setup / Requirements

  • USB WiFi dongle with monitor mode for attacks.
  • WiFi profiles stored in wifi/profiles/.

Profiles

Example profile:

{
  "ssid": "HomeNetwork",
  "password": "your_password_here",
  "interface": "auto",
  "priority": 3,
  "auto_connect": true,
  "created": "2024-01-01T12:00:00",
  "last_used": null,
  "notes": "Home WiFi network - highest priority"
}

Menu Actions (Full WiFi Manager)

  • Scan Networks: scan available WiFi via nmcli on the active interface
  • Saved Profiles: connect or delete saved WiFi profiles (JSON)
  • Quick Connect: auto-connect to best saved network in range
  • Disconnect: disconnect the active interface from WiFi
  • Interface Config: select active interface (wlan0/wlan1/eth0), shows connection status per interface with * marker on active
  • Status & Info: SSID, IP, interface, dongle count

Fast WiFi Connect (standalone payload)

Auto-connect to strongest saved WiFi with interface selection. Reads passwords from both nmcli saved connections and WiFi Manager JSON profiles (wifi/profiles/). Includes host discovery after connection.


❓ FAQ

  • Q: WiFi manager says “WiFi not available”.
    A: The WiFi system or dongle is not detected. Install dependencies and check `/sys/class/net` for wlan interfaces.
  • Q: How do I force tools to use wlan1?
    A: Use **Switch Interface** or the **Route Control** menu to set wlan1 as default.
  • Q: “No wireless interface found”.
    A: Check /sys/class/net and ensure the dongle is detected (lsusb).
  • Q: Scan returns empty list.
    A: Make sure the interface is up and not blocked by rfkill.
  • Q: “Device or resource busy”.
    A: Another tool is using the interface (monitor mode, airodump, etc.).

Clone this wiki locally