ESP32 Marauder for T-Deck — Portable WiFi/BLE Security Suite - image 1
Build Guideintermediate

ESP32 Marauder for T-Deck — Portable WiFi/BLE Security Suite

Port of the iconic ESP32 Marauder (10,000+ stars) WiFi and Bluetooth security toolkit to the T-Deck handheld — bringing packet sniffing, deauth detection, beacon spam, and PCAP capture to a keyboard device.

Boards:ESP32-S3
Firmware:ArduinoPlatformIO
Use Cases:Security & SurveillanceEducationPortable Device

Overview

ESP32 Marauder (10,000+ GitHub stars) is the most popular ESP32 security toolkit, providing comprehensive WiFi and Bluetooth offensive and defensive analysis tools. The T-Deck port (by jstockdale) adapts this legendary toolkit to the T-Deck's keyboard, trackball, and 2.8" display — creating a pocket-sized network security analysis device.

Key Features

  • WiFi Scanning: Enumerate all nearby access points with signal strength, channels, encryption, and connected clients
  • Packet Sniffing: Capture WiFi packets and save as PCAP files to SD card for Wireshark analysis
  • Deauth Detection: Monitor for WiFi deauthentication attacks in your vicinity — a defensive security tool
  • Beacon Spam: Generate fake access point beacons for testing WiFi client behavior
  • BLE Scanning: Discover and analyze Bluetooth Low Energy devices, services, and characteristics
  • PCAP Recording: Save captured packets to SD card in standard PCAP format
  • Keyboard Navigation: Full menu navigation and command input via the T-Deck's QWERTY keyboard
  • Signal Strength Visualization: Real-time RSSI graphs for WiFi and BLE signals

Getting Started

Flash the T-Deck Marauder build via PlatformIO or web flasher. Insert an SD card for PCAP captures. Power on and use the keyboard to navigate the menu system — scan WiFi, monitor Bluetooth, or start a PCAP capture session.

Why This Project

Marauder on a T-Deck is the closest thing to a dedicated WiFi security analyzer in your pocket. The keyboard enables typing SSIDs and commands directly, the trackball navigates menus quickly, and the large display shows scan results clearly. With PCAP-to-SD recording, you can capture packets in the field and analyze them later in Wireshark — making this a genuine field tool for network security professionals and enthusiasts.

Resources