# NullFrame OS

**Security Testing Laboratory Edition**

A lightweight Live ISO with WiFi/BLE/RF attack tools, RGB cyberpunk aesthetics, and VESA-only graphics (no proprietary drivers needed).

## Features

- **VESA Graphics Only** - Works on any x86 hardware without GPU drivers
- **WiFi Attacks** - Monitor mode, scanning, deauth, handshake capture
- **BLE Attacks** - Device scanning, GATT enumeration, cursed glitching
- **RF Attacks** - Signal sniffing, spectral analysis, glitching
- **Network Attacks** - ARP spoof, MITM, port scanning
- **RGB Neon Theme** - Cyberpunk boot splash and terminal styling
- **Legal Disclaimer** - Prominently displayed on every boot

## Boot Methods

- **Ventoy** - Copy ISO to Ventoy USB, boot from menu
- **Rufus** - Write ISO to USB using Rufus (DD mode)
- **VirtualBox/VMWare** - Boot ISO directly in VM
- **CD/DVD** - Burn to disc and boot

## Usage

1. Write `nullframe-os-1.0.0.iso` to USB
2. Boot from USB (change boot order or press F12/F2 for boot menu)
3. Accept the legal disclaimer
4. Type `/opt/nullframe/menu.sh` for interactive attack menu

## Tool Locations

```
/opt/nullframe/
├── menu.sh          # Interactive ASCII menu
├── wifi/
│   ├── monitor.sh   # Enable monitor mode
│   ├── scan.sh     # Network scanner
│   └── deauth.sh   # Deauth attack
├── ble/
│   ├── scan.sh     # BLE device scanner
│   ├── glitch.sh   # Cursed BLE glitcher
│   └── fuzz.sh     # GATT fuzzer
├── rf/
│   ├── sniff.sh    # RF sniffer (needs RTL-SDR)
│   └── glitch.sh   # Cursed RF glitcher
└── network/
    ├── arpSpoof.sh # ARP spoofing
    └── mitm.sh     # MITM suite
```

## Disclaimer

**⚠️ AUTHORIZED USE ONLY ⚠️**

This operating system contains security testing tools intended for:
- Authorized penetration testing
- Controlled laboratory environments
- Security research with explicit written consent

**UNAUTHORIZED ACCESS TO COMPUTER SYSTEMS IS ILLEGAL.**

All network activity is logged and monitored.

By using this system, you confirm you have legal authority to test target systems.

## Build

```bash
./build-final.sh
```

Requires: xorriso, curl

## Files

```
nullframe-os/
├── nullframe-os-1.0.0.iso   # The bootable ISO (40MB)
├── build-final.sh          # Build script
├── build-iso.sh             # Alternative build
├── SPEC.md                 # Specification
├── boot/
│   ├── disclaimer.txt      # Legal warning
│   ├── syslinux.cfg        # Boot config
│   ├── vmlinuz             # Linux kernel
│   └── initramfs          # Initial ramdisk
├── rootfs/
│   └── opt/nullframe/      # Attack tools
└── tools/
    └── menu.sh            # Interactive menu
```

## System Requirements

- x86/x86_64 processor
- 512MB RAM minimum
- USB or CD/DVD drive
- No GPU drivers needed (VESA fallback)
- Optional: WiFi adapter (monitor mode support)
- Optional: RTL-SDR dongle (RF attacks)
- Optional: Bluetooth adapter (BLE attacks)