Hack3r T-Deck is a custom UI firmware for the LilyGO T-Deck Plus, it's one of those see if i can projects...

North Star Goal: a stable, good-looking daily driver for T-Deck Plus that unifies quality UX, practical tooling, and extensibility — so you don’t have to hop between firmware as often just to get your work done.

• ✅ USB HID — Payload selection + deployment.
• 🚧 Wi-Fi Tools (Marauder port, in progress)
  • Sniffers: Probe Request, Beacon, Deauth, EAPOL/PMKID, Packet Monitor, Detect Pwnagotchi, Scan APs, Raw Capture
  • War-driving: Wardrive, Station Wardrive
  • Attacks: Beacon Spam (List/Random), “Rick Roll” Beacon, Probe Flood, Evil Portal, Deauth Flood/Targeted, AP Clone Spam
  • Utilities: Generate/Add/Clear SSIDs, Save/Load, Select APs/Stations
• 🚧 BTE Tools (Marauder port, in progress)
  • Sniffers: Bluetooth, Flipper, Airtag, BT Wardrive (std/continuous), Detect Card Skimmers
  • Attacks: Sour Apple, SwiftPair Spam, Samsung/Google/Flipper BLE spam, BLE Spam All, Spoof Airtag
• 🚧 OUI Foxhunter — Vendor picker from /OUI/vendors.csv, “Start Hunt” radar view
• 🚧 LoRa — Encypted chat broadcast?
• 🚧 WebServer - Web portal for more options?
• ⚙️ Settings
  • UI Color, Clock, Wi-Fi, Hardware, Audio
• ℹ️ About — Project info & credits

coming soon!

• Display / Touch: LGFX LGFX_TDeck (320×240, landscape)
• Keyboard (I²C1): address 0x55 (profiles: SDA=18/SCL=8 or SDA=18/SCL=17)
• Trackball (I²C1): auto-detect 0x0A…0x0D
• Peripheral Power: PERIPH_POWER = 10 (rails for KB/Trackball)
• SD (FSPI): CS=39, SCK=40, MOSI=41, MISO=38
• Battery (ADC): pin 4, 2:1 divider, EMA smoothing
• USB HID: TinyUSB Keyboard (deploy Ducky scripts)

Folders on SD
/duckyscripts/ → .txt ducky payloads
/OUI/vendors.txt → OUI,Vendor list

1. Install dependencies (ESP32 board pkg, LGFX, TinyUSB HID, etc.).
2. Set board: ESP32S3 Dev Module (16MB), PSRAM enabled, Huge APP 3MB or equivalent.
3. Configure pins if your Plus variant differs (see Hardware & I/O above).
4. Build a .bin.
5. Flash directly, or copy the .bin to your launcher (e.g., M5Launcher) and load it.

If you boot to a backlit black screen, re-verify: rotation=1, PSRAM mode, app partition size, and that the display driver matches your T-Deck Plus rev.

• Wi-Fi tool wiring (all sniff/wardrive/attack entries callable)
• BLE tool wiring (sniffers & attack actions)
• OUI Foxhunter scanning + hits list
• Audio events (clicks / hunt pips) with volume control
• Per-page trackball gestures (left/right page hooks)
• Optional OTA partition map + settings export/import
• Theming presets & font pass for small labels
• Localization hooks (EN first, then i18n keys)
• LoRa?
• Webserver?

📝 Portions of this project are derived from Marauder, by justcallmekoko.
A suite of Wi-Fi/Bluetooth offensive and defensive tools for ESP32.
Used with credit, under the terms of their license.

This firmware includes features intended for authorized testing, research, and education. Ensure you have explicit permission before scanning or interacting with any network or device. Use at your own risk!!

MIT for the original Hack3r T-Deck code.
Marauder components and ports remain under their respective licenses; see upstream.