PiZero-README.md

Shadow Bubble Mini - Setup Instructions for Raspberry Pi Zero 2 W

Overview

This guide explains how to cleanly install mdk4, configure your Wi-Fi adapter region, and ensure the tool runs correctly on devices such as the Raspberry Pi Zero 2 W. These steps ensure optimal performance and compatibility with Shadow Bubble Mini.

---

🔧 MDK4 Installation

1. Install Dependencies

sudo apt update
sudo apt install -y libpcap-dev libnl-3-dev libnl-genl-3-dev build-essential git

2. Clone and Build mdk4

cd ~
git clone https://github.com/aircrack-ng/mdk4.git
cd mdk4
make

3. Move Binary to System PATH

sudo cp src/mdk4 /usr/local/bin/

Ensure /usr/local/bin is included in your $PATH:

echo $PATH

---

🌍 Set Wi-Fi Adapter Regulatory Region

1. Temporarily Set to US

sudo iw reg set US

2. Persist Region Across Reboots

Method A: Using WPA Supplicant (Headless Ubuntu)

Edit the config file:

sudo nano /etc/wpa_supplicant/wpa_supplicant.conf

Add this line if not present:

country=US

Then reboot:

sudo reboot

Method B: Using NetworkManager

sudo nano /etc/NetworkManager/conf.d/regdom.conf

Add:

[device]
wifi.scan-rand-mac-address=no

[global]
wifi.country=US

Then restart the service:

sudo systemctl restart NetworkManager

---

✅ Verification Steps

1. Check Current Region

iw reg get

Output should include:

country US: DFS-FCC

2. Check Supported Bands

iw phy | grep -A5 'Band 1'

This will list the capabilities of your adapters.

---

🚀 Ready to Run Shadow Bubble ELITE

Once the setup is complete, simply execute:

sudo python3 Shadow_Bubble_Mini.py

The script will auto-detect available adapters, configure them, and start beacon + deauth + Bluetooth jamming based on availability.

---

For help or updates, visit the ShadowTEAM project page.