LabOnOffensive

RF Analysis & Security Research Toolkit using Software Defined Radio.

Features

• HackRF Capture — Real-time 2.4 GHz WiFi/Bluetooth packet detection
• Spectrum Analyzer — Real-time spectrum visualization (coming soon)
• Signal Replay — Record and replay RF signals (coming soon)
• Frequency Scanner — Scan frequency ranges for activity (coming soon)

Project Structure

LabOnOffensive/
├── main.py                    # Entry point with menu system
├── requirements.txt           # Python dependencies
├── README.md                  # This file
└── modules/
    ├── __init__.py           # Module exports
    ├── colors.py             # Terminal color codes
    ├── wifi_channels.py      # WiFi channel definitions
    ├── packet_detector.py    # RF packet detection
    ├── hackrf_capture.py     # HackRF capture functionality
    └── menu.py               # Interactive menu system

Prerequisites

Hardware

• HackRF One SDR

Software

macOS

brew install hackrf

Ubuntu/Debian

sudo apt update
sudo apt install hackrf libhackrf-dev

Arch Linux

sudo pacman -S hackrf

Installation

# Clone the repository
git clone <repo-url>
cd LabOnOffensive

# Install Python dependencies
pip install -r requirements.txt

Usage

Interactive Menu

python main.py

This launches the interactive menu:

[1] HackRF Capture      - Capture and analyze 2.4 GHz WiFi/Bluetooth packets
[2] Spectrum Analyzer   - Real-time spectrum visualization (coming soon)
[3] Signal Replay       - Record and replay RF signals (coming soon)
[4] Frequency Scanner   - Scan frequency ranges for activity (coming soon)
[q] Quit               - Exit the application

Direct Module Usage

You can also use modules directly:

from modules import HackRFCapture, PacketDetector

# Create capture instance
capture = HackRFCapture(
    center_freq=2.437e9,  # WiFi Channel 6
    sample_rate=20e6,
    lna_gain=32,
    vga_gain=30
)

# Run capture
capture.run()

HackRF Capture

The capture module detects WiFi and Bluetooth packets in the 2.4 GHz band.

Output Format

TIME         TYPE    CHAN    FREQUENCY      BW      POWER   SIGNAL STRENGTH
12:34:56.789 [ WiFi ] Ch 6  2437.50 MHz BW: 20.0MHz  -42.3 dB ████████████████░░░░
12:34:56.812 [  BT  ] ----  2445.23 MHz BW:  1.2MHz  -51.7 dB ██████████░░░░░░░░░░

Packet Types

Type	Description	Bandwidth
BT	Bluetooth	< 2 MHz
WiFi	WiFi 20 MHz	2-25 MHz
WiFi40	WiFi 40 MHz	25-45 MHz

WiFi Channel Reference

Channel	Frequency	Channel	Frequency
1	2412 MHz	8	2447 MHz
2	2417 MHz	9	2452 MHz
3	2422 MHz	10	2457 MHz
4	2427 MHz	11	2462 MHz
5	2432 MHz	12	2467 MHz
6	2437 MHz	13	2472 MHz
7	2442 MHz	14	2484 MHz

Common non-overlapping channels: 1, 6, 11

Troubleshooting

HackRF Not Detected

1. Check USB connection
2. Run hackrf_info to verify device
3. On Linux, check permissions:

   sudo chmod 666 /dev/bus/usb/*/*

Permission Denied (Linux)

Add udev rules:

sudo cp /etc/udev/rules.d/53-hackrf.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules

Legal Notice

⚠️ Important: This toolkit is for authorized security research and educational purposes only. Only capture and analyze signals you are legally authorized to receive. Intercepting communications without permission may violate local laws.

License

MIT License - Use responsibly and legally.