Troubleshooting Guide

Possible Causes:

• Your wireless card doesn't support monitor mode
• Wireless interface is not available or disabled
• Driver issues with your wireless adapter

Solutions:

1. Check available interfaces:

   # Linux
   iwconfig
   ifconfig
   
   # macOS
   ifconfig
   networksetup -listallhardwareports
   
   # Windows
   ipconfig /all

2. Verify monitor mode support:

   # Linux - check if your card supports monitor mode
   iw phy | grep -A 10 "Supported interface modes"

3. Enable wireless interface:

   # Linux
   sudo ifconfig wlan0 up
   
   # macOS
   sudo ifconfig en0 up

4. Check driver compatibility: Some wireless adapters have limited or no monitor mode support. Research your specific adapter model.

Possible Causes:

• Not running with root/administrator privileges
• Insufficient permissions for wireless interface access
• macOS System Integrity Protection (SIP) restrictions

Solutions:

1. Run with sudo (Linux/macOS):

   sudo wifi-jammer attack --tui
   sudo wifi-jammer --gui

2. Run as Administrator (Windows):

   # Right-click PowerShell/CMD and select "Run as Administrator"
   wifi-jammer attack

3. Check user permissions (Linux):

   # Add user to netdev group (Debian/Ubuntu)
   sudo usermod -aG netdev $USER
   # Log out and back in for changes to take effect

4. macOS Location Services: See the macOS-specific section below.

Possible Causes:

• Interface name is incorrect
• Interface name differs between systems
• Interface is disabled or not available

Solutions:

1. List all interfaces:

   # Linux
   iwconfig
   ip link show
   
   # macOS
   ifconfig | grep "^[a-z]"
   networksetup -listallhardwareports
   
   # Windows
   ipconfig /all

2. Common interface names:
   • Linux: wlan0, wlp2s0, wlan1
   • macOS: en0, en1 (usually en0 for WiFi)
   • Windows: Wi-Fi, Wireless Network Connection
3. Use interface discovery: Let the tool automatically detect interfaces:

   wifi-jammer scan  # Will show available interfaces

Cause:

macOS requires Location Services permission to access WiFi network information for privacy reasons.

Solutions:

Manual Fix:

1. Open System Settings (or System Preferences on older macOS)
2. Go to Privacy & Security → Location Services
3. Enable Location Services (toggle ON)
4. Find "Python" or "python3" in the list
5. Check the box ✅ to allow location access
6. Restart the WiFi Jammer tool

Possible Causes:

• Wireless card doesn't support monitor mode
• Driver doesn't support monitor mode
• Interface is already in use
• macOS limitations with monitor mode

Solutions:

1. Check monitor mode support (Linux):

   iw phy | grep -A 10 "Supported interface modes"

2. Put interface in monitor mode manually (Linux):

   sudo ifconfig wlan0 down
   sudo iwconfig wlan0 mode monitor
   sudo ifconfig wlan0 up

3. macOS: Monitor mode on macOS is limited. The tool uses alternative methods, but some features may not work as expected.
4. Check if interface is in use:

   # Linux
   sudo lsof | grep wlan0
   # Kill processes using the interface if necessary

Possible Causes:

• Interface not in monitor mode
• Wrong channel selected
• Target BSSID incorrect
• Firewall blocking packets
• Driver issues

Solutions:

1. Enable verbose mode:

   sudo wifi-jammer --verbose attack --interface en0 --target 00:11:22:33:44:55 --attack deauth

2. Verify target BSSID: Make sure the BSSID format is correct (XX:XX:XX:XX:XX:XX)
3. Check channel: Ensure you're on the same channel as the target network
4. Test with scan first:

   sudo wifi-jammer scan --interface en0

5. Check firewall: Temporarily disable firewall to test