01
Wprowadzenie do Marauder v1.20.0Overview of Marauder v1.20.0
ESP32 Marauder stworzony przez justcallmekoko to najbardziej wszechstronny, autonomiczny kombajn do audytu bezpieczeństwa protokołów radiowych 802.11 oraz Bluetooth Low Energy (BLE). Projekt obsługuje ponad 25 platform sprzętowych — od klasycznych ESP32 WROOM, przez ESP32-S2/S3 (z PSRAM), M5Stack (Cardputer, Core2 AWS, StickC), Flipper Zero WiFi Dev Board, aż po najnowsze dwuzakresowe układy ESP32-C5 (Wi-Fi 6 w pasmach 2.4 GHz i 5 GHz) oraz ESP32-C6.ESP32 Marauder created by justcallmekoko is the most versatile autonomous tactical radio security auditing toolkit for 802.11 and Bluetooth Low Energy (BLE). The project supports over 25 hardware variants — from classic ESP32 WROOM and ESP32-S2/S3 with PSRAM, to M5Stack (Cardputer, Core2 AWS, StickC), Flipper Zero WiFi Dev Board, and the latest dual-band ESP32-C5 (Wi-Fi 6 on 2.4 GHz and 5 GHz) and ESP32-C6 chips.
Wersja v1.20.0 to przełomowe wydanie wprowadzające kierowane profile ataków WiFi (Guided per-AP attack profiles), zintegrowany detektor i tracker dronów FAA/OpenDroneID Remote ID z eksportem tras GPX, system detekcji obecności człowieka CSI WiFi Sensing Motion Monitor, geofencing warjazdu oraz automatyczne maskowanie prywatności Censor Mode.Release v1.20.0 brings major architectural breakthroughs: Guided per-AP WiFi attack profiles, full FAA/OpenDroneID Remote ID drone detection and GPX route tracking, physical-layer CSI WiFi Sensing Motion Detection, wardrive geofencing, and automated Censor Mode privacy redaction.
Aktualna WersjaCurrent Version
v1.20.0
Wydanie StableStable Release
2026-10-28
Pasma RadioweRadio Bands
2.4 GHz + 5 GHz (C5)
CLI Serial
115 200 baud, 8N1
Pamięć masowaStorage
SD (PCAP, CSV, GPX, HTML)
GPS / NawigacjaGPS / Navigation
UART & I2C (NEO-6M, LC76G)
Instalator WebWeb Installer
JCMK Installer
Zarządzanie zasilaniemPower Management
AXP192/2101, IP5306, MAX17048
02
Ustawienia Maraudera (System Settings)Marauder System Settings
Konfigurację urządzenia można modyfikować w menu Device → Settings (GUI) lub przez komendę settings -s <name> <enable/disable> w CLI. Od wersji v1.14+ ustawienia są kolorowane w GUI oraz buforowane w płaskiej strukturze RAM, co eliminuje fragmentację pamięci heap. W v1.16+ zaimplementowano zautomatyzowane narzędzia migracji i backupu SPIFFS na kartę SD (backupspiffs).Device settings can be modified via Device → Settings (GUI) or with settings -s <name> <enable/disable> via CLI. Since v1.14+, settings are color-coded in the GUI and cached in a flat RAM layout to prevent heap fragmentation. Since v1.16+, SPIFFS settings backup and restore to SD are natively built-in (backupspiffs).
ParametrParameter
TypType
DomyślnieDefault
Działanie & ZastosowanieOperation & Description
ForcePMKIDboolfalse
Automatycznie wysyła ramki deauth do punktów dostępowych podczas
sniffpmkid, wymuszając handshake PMKID i eliminując konieczność oczekiwania na połączenie klienta.Automatically sends deauth frames to APs during sniffpmkid, forcing immediate PMKID handshake generation without waiting for authentic client associations.
ForceProbeboolfalse
Wysyła ramki deauth podczas
sniffprobe, prowokując stacje klienckie do ponownego rozsyłania zapytań Probe Request i ujawniania zapamiętanych SSID.Transmits deauth frames during sniffprobe, stimulating client stations to re-issue Probe Requests and disclose remembered SSIDs.
SavePCAPbooltrue
Zapisuje surowe ramki sieciowe 802.11 bezpośrednio do plików .pcap na karcie SD. Wymagane do analizy w Wireshark, Aircrack-ng i offline crackingu w Hashcat (22000).Logs captured 802.11 frames directly into .pcap files on the SD card. Required for Wireshark inspection, Aircrack-ng and Hashcat (mode 22000).
EnableLEDbooltrue
Kontroluje wbudowaną diodę LED lub pasek WS2812 (NeoPixel). Wyłączenie zapewnia pełną dyskrecję pracy (tryb cichy).Controls onboard status LED or WS2812 (NeoPixel). Disabling provides stealth operational mode.
EPDeauthboolfalse
Podczas pracy Evil Portal wysyła zsynchronizowane ramki deauth do oryginalnego AP, zmuszając klientów do zerwania połączenia i zalogowania się do fałszywego hotspotu captive.When Evil Portal runs, continuously transmits deauth frames to the cloned AP, forcing clients to disconnect and re-authenticate via the rogue captive portal.
ChanHopboolfalse
Automatyczne przeskakiwanie po kanałach radiowych (1–14 w 2.4 GHz oraz pasmo 5 GHz na C5). Obsługiwane również przez Fox Hunt, Flock Sniff i Wardrive.Automatic channel hopping (channels 1–14 on 2.4 GHz plus 5 GHz on C5). Supported across Fox Hunt, Flock Sniff, and Wardrive.
Censor v1.19+boolfalse
Tryb ochrony prywatności: Częściowo maskuje (haszuje/gwiazdkuje) adresy MAC, nazwy SSID, identyfikatory pilotów oraz współrzędne dronów Remote ID na ekranie i w CLI. Idealny do transmisji na żywo, YouTube i prezentacji.Privacy Redaction Mode: Masks sensitive MAC addresses, SSIDs, pilot coordinates and Remote ID drone serials on screen and serial logs. Critical for streaming, videos, and live demos.
saved_wifi v1.17+wifi_listmax 5
Profile zaufanych sieci WiFi (SSID + hasło). Funkcja
join -s skanuje otoczenie i automatycznie łączy się z najsilniejszą znaną siecią (Scan-First selection).Stores up to 5 trusted WiFi network credentials. join -s scans nearby RF space and automatically connects to the strongest known AP (Scan-First selection).
geofences v1.17+geofence_listmax 5
Geostrefy warjazdu (sloty 1–5). Definiuje współrzędne środka i promień (0.1–1.0 mili), automatycznie wyłączając lub filtrując logowanie wokół własnego domu lub stref prywatnych.Wardriving geofence zones (slots 1–5). Defines lat/lon and radius (0.1–1.0 miles) to automatically pause or restrict logging near private homes or sensitive locales.
wu / wt / wdg_keystring""
Poświadczenia API: wu (WiGLE User), wt (WiGLE Token), wdg_key (WDGWars Key). Umożliwiają bezpośredni upload logów warjazdu przez WiFi komendą
upload.Cloud API credentials: wu (WiGLE User), wt (WiGLE Token), wdg_key (WDGWars Key). Enables direct WiFi wardrive upload via upload command.
03
Architektura i Przegląd AplikacjiArchitecture & App Overview
Interfejs Maraudera podzielony jest na wyspecjalizowane podsystemy dostępne zarówno z poziomu menu graficznego TFT, jak i pełnego terminala szeregowego CLI (115200 baud).The Marauder interface is structured into specialized functional subsystems accessible both via the TFT color GUI and the complete serial CLI terminal (115200 baud).
📶 WiFi Core
Sniffery 802.11 b/g/n (oraz Wi-Fi 6 5 GHz na C5), skanery L2/L3/L4, ataki deauth/beacon/karma oraz nowe profile Guided Attacks.802.11 b/g/n (and 5 GHz Wi-Fi 6 on C5) sniffers, L2/L3/L4 network scanners, deauth/beacon/karma attacks and new Guided Attack profiles.
🔵 Bluetooth & BLE
Skaner urządzeń BLE, AirTag Monitor, iBeacon discovery, wykrywanie skimmerów bankomatowych oraz testy powiadomień BLE Spam (Apple, Windows, Samsung, Google).BLE device scanner, AirTag Monitor, iBeacon discovery, ATM card skimmer detection, and multi-platform BLE notification spam suites.
🛸 Remote ID Drone Radar v1.18+
Wykrywanie i śledzenie w czasie rzeczywistym sygnałów radiowych dronów (FAA / OpenDroneID) przez WiFi Nan / Beacons i BLE, z rejestracją GPX na SD.Real-time drone detection and live flight tracking (FAA / OpenDroneID) across WiFi NAN / Beacons and BLE with GPX route logging on SD.
🌊 CSI WiFi Motion Sensing v1.19+
Detekcja ruchu ludzi w pomieszczeniach bez kamer — analiza zakłóceń amplitudy i fazy podnośnych Channel State Information (CSI) fizycznej warstwy WiFi.Human indoor motion detection without cameras — analyzing physical layer Channel State Information (CSI) subcarrier amplitude and phase disturbance.
🗺️ Geofenced Wardrive & GPS
Warjazd w formacie WiGLE 1.6 z oznaczaniem POI na żywo, geostrefami wykluczeń, zliczaniem Flock oraz bezpośrednim uploadem do chmury.WiGLE 1.6 wardriving with live POI tagging, exclusion geofences, Flock detection, and direct cloud log uploading via WiFi.
🔧 Device, Backup & Power
Zarządzanie SPIFFS (kopia zapasowa i odzyskiwanie), regulacja jasności podświetlenia PWM, monitoring akumulatora (AXP/IP/MAX) oraz aktualizacje OTA.SPIFFS management (backup and restore), PWM brightness regulation, fuel-gauge battery diagnostics (AXP/IP/MAX), and OTA updates.
04
WiFi – Sniffery i Narzędzia DiagnostyczneSniffers & Diagnostics
Większość snifferów automatycznie generuje pliki PCAP na karcie SD, jeśli włączone jest ustawienie SavePCAP=true. W wersji v1.20 dodano obsługę identyfikatorów modułów FCC dla AP, ulepszono wykrywanie stacji klienckich i zoptymalizowano obsługę buforów.Most sniffers automatically stream PCAP frames to the SD card when SavePCAP=true. In v1.20, FCC module identification for APs was added, client station association improved, and packet capture buffers hardened.
Probe Request Sniff sniffer
Nasłuchuje zapytań Probe Request emitowanych przez laptopy i smartfony szukające znanych sieci. Puste zapytania probe oznaczane są jako [hidden]. Pozwala odkryć zapamiętane sieci ofiar.Listens for Probe Requests broadcast by mobile devices searching for known SSIDs. Blank probe requests are tagged [hidden]. Reveals targets' saved network history.
Beacon Sniff sniffer
Rejestruje ramki Beacon rozgłaszane przez punkty dostępowe. Zapisuje nazwy SSID, adresy BSSID MAC, kanały radiowe oraz konfigurację szyfrowania.Captures beacon frames broadcast by APs. Populates the in-memory AP registry with SSID, BSSID, channel, and encryption specs.
Packet Monitor & Rate async v1.15+
Zrefaktoryzowany w v1.15: wielopoziomowe, asynchroniczne wykresy natężenia ruchu pakietów w czasie rzeczywistym. Odrębnie rejestruje pakiety przychodzące i wychodzące oraz zapisuje zrzut PCAP.Refactored in v1.15: stacked asynchronous real-time graphs illustrating packet traffic density. Tracks incoming vs outgoing packets separately and writes PCAP files.
Channel Analyzer & Summary spectrum
Wizualizuje obciążenie pasma na poszczególnych kanałach 2.4 GHz (i 5 GHz na C5) w formie histogramu. Ułatwia dobór optymalnego kanału lub lokalizację zakłóceń.Visualizes channel utilization across 2.4 GHz (and 5 GHz on C5) as a histogram. Simplifies congestion diagnosis and optimal frequency selection.
EAPOL / PMKID Scan crypto
Wychwytuje 4-etapowe handshake WPA/WPA2 oraz pojedyncze ramki PMKID z ramki 1/4. Z opcją
ForcePMKID=true Marauder automatycznie atakuje AP deauthem, wymuszając natychmiastowe wysłanie PMKID bez udziału klienta.Captures WPA/WPA2 4-way handshakes and standalone PMKIDs from frame 1/4. With ForcePMKID=true, Marauder automatically transmits deauth, triggering immediate PMKID generation without genuine clients.Fox Hunt (WiFi & BT) foxhunt v1.15+
Radiolokacja kierunkowa (nadajnik / lis). Mierzy RSSI wybranego AP, stacji klienckiej, AirTaga, Flipper Zero, WiFi Pineapple lub BLE w czasie rzeczywistym. Obsługuje stabilne sortowanie (RSSI/Nazwa/Kanał) oraz filtry czasowe (30s / 2.4GHz / 5GHz).Directional transmitter hunting (Fox Hunt). Measures real-time RSSI for target APs, stations, AirTags, Flipper Zero, WiFi Pineapple, or BLE devices. Features stable sorting (RSSI/Name/Channel) and filters (30s / 2.4GHz / 5GHz).
SAE Commit Sniff wpa3
Przechwytuje ramki uwierzytelniania SAE Commit protokołu Dragonfly (WPA3-Personal). Umożliwia analizę bezpieczeństwa nowoczesnych sieci bezprzewodowych.Captures Dragonfly protocol SAE Commit authentication frames (WPA3-Personal) for cutting-edge wireless security analysis.
Deauth & Pwnagotchi Sniff detect
Wykrywa ataki deauthentication prowadzone przez inne urządzenia w okolicy oraz specyficzne beacony rozsyłane przez urządzenia Pwnagotchi.Detects external deauth attacks conducted in the area and captures characteristic discovery beacons emitted by Pwnagotchi devices.
🔍 Skanery Sieci Lokalnej (L3 / L4 Network Scanners)Local Network Scanners (L3 / L4)
Wymagają wcześniejszego połączenia z siecią WiFi za pomocą Join WiFi lub profilu join -s.Require prior association with a WiFi network using Join WiFi or profile-based join -s.
ARP Scan arp
Błyskawiczne mapowanie aktywnej podsieci przez zapytania ARP — wykrywa hosty ignorujące ICMP Ping.Rapid subnet discovery via ARP requests — uncovers active hosts configured to drop ICMP echo requests.
Ping Scan icmp
Skanuje całą maskę podsieci /24 za pomocą zapytań ICMP echo.Sweeps the entire /24 subnet mask utilizing ICMP echo requests.
Port Scan All tcp
Bada otwarte porty TCP na wybranych hostach IP (SSH, Telnet, HTTP, HTTPS, DNS, SMTP, RDP).Probes standard TCP service ports on selected hosts (SSH, Telnet, HTTP, HTTPS, DNS, SMTP, RDP).
Service Scans (SSH/Telnet/RDP) port
Wyspecjalizowane skanery sprawdzające obecność poszczególnych usług: SSH (22), Telnet (23), RDP (3389).Targeted service banners checking specific network protocols: SSH (22), Telnet (23), RDP (3389).
⚡ Ataki WiFi i Nowe Profile Kierowane (Guided Profiles)WiFi Attacks & Guided Profiles
💡 NOWOŚĆ v1.20: Guided per-AP Attack Workflow:NEW in v1.20: Guided per-AP Attack Workflow:
Zamiast uruchamiać ataki masowe na całe pasmo, w v1.20 zaimplementowano inteligentny kreator ataków: użytkownik wybiera konkretny AP z listy, wybiera stacje klienckie powiązane z tym AP, a Marauder buduje spójny profil ataku z ograniczeniem zasięgu do wybranego celu (bound scope) i automatycznym maskowaniem wrażliwych danych, gdy aktywny jest Censor.
Instead of indiscriminate broadcast floods, v1.20 introduces a guided attack workflow: select a target AP, choose associated stations, and Marauder constructs a bounded target profile, respecting active Censor privacy settings.
Guided Attack Profiles guided v1.20
Kreator ataku per-AP:
WiFi Attacks → Guided. Pozwala wybrać stacje docelowe, zweryfikować konfigurację w menu Review / Continue i precyzyjnie zaatakować wyłącznie autoryzowane cele.Targeted per-AP attack wizard: WiFi Attacks → Guided. Select target stations, verify parameters in Review / Continue, and execute strictly scoped attacks.Deauth Flood dos
Wysyła ramki deauthentication z adresem MAC punktu dostępowego w trybie broadcast lub unicast (do konkretnej stacji), powodując natychmiastowe zerwanie połączenia.Transmits forged deauth frames bearing the AP's MAC in broadcast or unicast mode, causing immediate client connection drops.
Evil Portal phishing
Rogue Access Point z serwerem DNS i HTTP serwującym fałszywą stronę logowania z karty SD. W połączeniu z
EPDeauth=true rozłącza klientów z oryginalnego AP.Rogue AP running DNS & HTTP captive portal server hosting custom HTML from SD. Coupled with EPDeauth=true, it forces victims off genuine APs.Karma Attack spoof
Odpowiada na zapytania Probe Request urządzeń mobilnych, podszywając się pod dowolną zapamiętaną sieć, której szukają, i przechwytując połączenie.Listens for client Probe Requests and immediately responds as the requested SSID, luring devices to auto-associate with Marauder.
Beacon Spam (List / Random / Clone) spam
Emituje setki fałszywych sieci WiFi: z listy w pamięci (
ssid -a), losowo wygenerowane ciągi znaków lub dokładne klony wykrytych AP w okolicy.Broadcasts hundreds of counterfeit WiFi networks: from an in-memory list, randomized strings, or cloned nearby access points.SAE Commit Flood (WPA3 DoS) wpa3
Zalewa routery WPA3 tysiącami sfałszowanych ramek SAE Commit, przeciążając procesor kryptograficzny punktu dostępowego i zawieszając uwierzytelnianie.Floods WPA3 access points with synthetic SAE Commit frames, exhausting router cryptographic CPU capacity and crashing auth daemons.
CSA (Channel Switch Announcement) csa
Wysyła ramki nakazujące stacjom natychmiastowe przejście na inny kanał radiowy, destabilizując łączność bez konieczności klasycznego deautha.Transmits forged CSA management frames instructing clients to switch to an invalid channel, terminating active sessions.
Quiet Time Attack quiet
Wysyła ramki 802.11h Quiet Element wymuszające milczenie radiowe stacji klienckich pod pozorem radaru meteorologicznego (DFS).Transmits 802.11h Quiet Element frames imposing silence intervals on clients under the guise of radar avoidance (DFS).
Bad Msg & Assoc Sleep fuzz
Bad Msg wysyła zniekształcone ramki zarządzające testując odporność stosu 802.11 routera; Assoc Sleep manipuluje stanem oszczędzania energii stacji.Bad Msg injects malformed 802.11 frames to fuzz access points; Assoc Sleep manipulates client power-save state bitfields.
🛠️ Narzędzia Ogólne WiFi & ZarządzanieGeneral WiFi Tools & Management
Join Saved WiFi v1.17
Skanuje otoczenie i automatycznie łączy się z najsilniejszą siecią spośród zapisanych w konfiguracji (
saved_wifi).Scans surroundings and connects to the highest RSSI network among configured profiles (saved_wifi).Upload Wardrive Logs cloud
Bezpośredni upload logów warjazdu z karty SD do WiGLE, WDGWars lub obu serwisów przez podłączone WiFi. CLI:
upload -d both.Direct upload of wardrive CSV logs from SD to WiGLE, WDGWars, or both over WiFi. CLI: upload -d both.Host AP Info & Live Events
Monitoruje w czasie rzeczywistym zdarzenia połączeń i rozłączeń stacji z punktem dostępowym hostowanym przez Maraudera.Monitors station association, authentication, and disassociation events in real time on Marauder-hosted APs.
Set & Spoof MACs
Generator i klonowanie adresów MAC:
randapmac, randstamac, cloneapmac, clonestamac.MAC generation and cloning toolset: randapmac, randstamac, cloneapmac, clonestamac.
05
Bluetooth / BLE – Sniffery i AtakiSniffers & Attacks
Podsystem Bluetooth wykorzystuje zoptymalizowaną bibliotekę NimBLE z podwyższoną mocą nadawczą oraz zoptymalizowanym cyklem życia klienta BLE.The Bluetooth subsystem utilizes an optimized NimBLE stack featuring boosted TX power and robust client lifecycle cleanup.
Bluetooth Analyzer & Sniffer ble
Analizuje pakiety BLE Advertisements w otoczeniu: adresy MAC, UUID usług, siłę RSSI, nazwy urządzeń oraz surowe payloady producentów.Sniffs and decodes raw BLE Advertisements: MACs, Service UUIDs, RSSI, device names, and manufacturer payloads.
iBeacon Sniff & Info ibeacon v1.18+
Wykrywanie i inspekcja beacony w standardzie Apple iBeacon. Wyświetla Proximity UUID, Major, Minor, Measured Power i kalkulowany dystans. CLI:
sniffbt -t ibeacon, list -x.Discovers and inspects Apple iBeacon transmitters. Extracts Proximity UUID, Major, Minor, Measured Power, and estimated proximity. CLI: sniffbt -t ibeacon, list -x.AirTag Sniff & AirTag Monitor tracker
Wykrywa ramki sieci Apple FindMy emitowane przez AirTagi. Tryb AirTag Monitor prowadzi ciągły monitoring i ostrzega o obecności nieznanych trackerów śledzących użytkownika.Captures Apple FindMy BLE frames emitted by AirTags. AirTag Monitor continuously audits surroundings to alert against unauthorized stalker trackers.
Flock Sniff (IoT CCTV) cctv
Wykrywa kamery i sensory monitoringu miejskiego Flock Safety. Aktywnie wywołuje transmisję kamer i filtruje identyfikatory OUI. Zintegrowany z warjazdem GPS.Detects Flock Safety ALPR surveillance cameras. Actively elicits camera BLE transmissions with OUI filtering and GPS logging.
Detect Card Skimmers atm
Skanuje pasmo 2.4 GHz w poszukiwaniu modułów Bluetooth (HC-05, HC-06) powszechnie instalowanych w nakładkach szpiegowskich na bankomaty i dystrybutory paliwa.Scans for embedded Bluetooth modules (HC-05, HC-06) typically integrated into ATM and gas pump payment card skimmers.
BT Fox Hunt foxhunt
Polowanie na nadajnik BLE po sile sygnału RSSI. Umożliwia precyzyjną lokalizację ukrytych AirTagów, Flipper Zero, iBeaconów lub telefonów. CLI:
foxhunt -b <index>.Directional BLE transmitter locator via RSSI. Pinpoints concealed AirTags, Flipper Zero, iBeacons, or mobile phones. CLI: foxhunt -b <index>.⚡ Ataki Powiadomień BLE SpamBLE Notification Spam Attacks
⚠ Ataki BLE Spam powodują nieustanne wyświetlanie okien parowania na ekranach telefonów i komputerów w promieniu do 30 metrów, mogąc zawiesić interfejs użytkownika iOS, Android i Windows.BLE Spam attacks trigger persistent pairing popups on nearby smartphones and PCs within 30m, potentially freezing iOS, Android, and Windows UI shells.
Apple Juice ios
Zaawansowany spam Apple Continuity / Handoff. Generuje autentyczne alerty systemowe (AirPods Max, Apple Watch, Apple TV Setup, transfer numeru telefonu). Bardziej agresywny niż Sour Apple. CLI:
applejuice lub blespam -t applejuice.High-impact Apple Continuity exploit. Simulates authentic system pairing prompts (AirPods Max, Apple Watch, Apple TV, Transfer Number). CLI: applejuice.Swift Pair Spam windows
Wykorzystuje protokół Microsoft Swift Pair (Company ID 0x0006). Wyświetla natrętne powiadomienia "Znaleziono nowe urządzenie" na wszystkich stacjach Windows 10/11. CLI:
swiftpair.Exploits Microsoft Swift Pair (Company ID 0x0006). Triggers notifications on Windows 10/11 machines within range. CLI: swiftpair.Samsung & Google Fast Pair android
Emituje ramki parowania Samsung One UI (Galaxy Buds, SmartTag) oraz uniwersalny Google Fast Pair dla wszystkich telefonów z systemem Android i usługami Play. CLI:
samsungblespam, blespam -t google.Emits Samsung One UI pairing frames (Galaxy Buds, SmartTag) and universal Google Fast Pair frames targeting Android devices.BT Spam All total
Uruchamia symultaniczny atak na wszystkie platformy naraz: Apple + Windows + Samsung + Android + Flipper, z maksymalną mocą nadawczą radiową ESP32. CLI:
btspamall.Simultaneously bombards all mobile platforms: Apple + Windows + Samsung + Android + Flipper with maximum RF output power. CLI: btspamall.FindMy Sound & Spoof AirTag airtag
FindMy Sound: Nakłania wykryte AirTagi do odegrania głośnego dźwięku lokalizacyjnego (ping). Spoof AirTag: symuluje obecność obcego trackera, wyzwalając alert śledzenia na iPhone'ach. CLI:
findmy -t <idx>, spoofat.FindMy Sound: Forces nearby AirTags to emit sound pings. Spoof AirTag: Emulates rogue tracker presence, triggering stalking warnings on iPhones.
06
🛸 Drony Remote ID (FAA & OpenDroneID Radar)Remote ID Drone Radar (FAA & OpenDroneID)
Zaimplementowany w v1.18 i gruntownie udoskonalony w v1.20 podsystem Remote ID pozwala Marauderowi działać jako autonomiczny skaner i radar przestrzeni powietrznej. Zgodny z przepisami FAA Part 89 oraz europejskimi normami ASD-STAN / OpenDroneID.Introduced in v1.18 and enhanced in v1.20, the Remote ID subsystem turns Marauder into a tactical airspace radar. Fully compliant with FAA Part 89 and ASD-STAN / OpenDroneID specifications.
Możliwości modułu Remote ID w v1.20Remote ID Capabilities in v1.20
1
Podwójny nasłuch:Dual-medium Sniffing: Przechwytuje ramki WiFi Beacon / WiFi Action NAN (Neighbor Awareness Network) oraz pakiety rozgłoszeniowe Bluetooth 5.0 Long Range / Legacy Advertisements.Captures WiFi Beacon / WiFi Action NAN (Neighbor Awareness Network) and BLE 5.0 Long Range / Legacy advertisements.
2
Pełna telemetria w locie:Real-time Telemetry: Współrzędne drona (szerokość, długość, wysokość barometryczna i GNSS), prędkość horyzontalna, kurs, identyfikator UAS Serial (ANSI/CTA-2063-A), a także dokładne współrzędne operatora/pilota.Drone coordinates (lat/lon, geodetic and pressure altitude), ground speed, heading, UAS Serial Number (ANSI/CTA-2063-A), and operator/pilot takeoff coordinates.
3
Zapis tras GPX:GPX Flight Logging: Automatycznie zapisuje historię lotu drona do pliku .gpx na karcie SD, gotowego do wizualizacji w Google Earth lub QGIS.Logs complete drone flight paths directly into .gpx files on the SD card for visual mapping in Google Earth or QGIS.
4
Tryb Censor & FCC Lookup (v1.20):Censor Mode & FCC Lookup (v1.20): W wersji v1.20 dodano identyfikację producenta po kodzie FCC oraz integrację z przełącznikiem
Censor maskującym współrzędne pilota i numery seryjne na ekranie podczas nagrań wideo.v1.20 integrates manufacturer lookup via FCC module IDs and masks pilot coordinates and drone serial numbers when Censor is active.| Komenda CLICLI Command | Opis operacjiOperation Description |
|---|---|
| remoteid scan | Uruchamia nasłuch przestrzeni radiowej pod kątem transmisji Remote ID (WiFi + BLE)Starts passive sniffing for Remote ID broadcasts on both WiFi and BLE channels |
| remoteid list | Wyświetla listę wykrytych dronów z numerami indeksów, identyfikatorami i siłą sygnałuLists detected drones with index numbers, UAS IDs, and signal RSSI |
| remoteid track <index> | Rozpoczyna śledzenie telemetryczne wybranego drona w czasie rzeczywistym i zapis GPX na SDEngages real-time telemetry tracking and logs flight path GPX to SD card |
| remoteid clear | Czyści rejestr wykrytych bezzałogowców z pamięci RAMClears detected drone table from RAM |
07
🌊 CSI WiFi Sensing Motion MonitorCSI WiFi Sensing Motion Monitor
Wprowadzony w v1.19 i zoptymalizowany pamięciowo w v1.19.2 moduł CSI Motion Monitor przekształca ESP32 w radar pasywny wykrywający ruch ludzi w pomieszczeniu bez użycia kamer czy czujników podczerwieni.Introduced in v1.19 and memory-optimized in v1.19.2, the CSI Motion Monitor transforms ESP32 into a passive wireless radar sensing human motion indoors without cameras or PIR sensors.
Jak działa Channel State Information (CSI) w Marauderze?
Tradycyjne wskaźniki (jak RSSI) mierzą jedynie sumaryczną moc sygnału radiowego. CSI bada fizyczną warstwę 802.11 OFDM — precyzyjną amplitudę i przesunięcie fazowe na każdej z 64 lub 128 podnośnych częstotliwości (subcarriers). Gdy człowiek porusza się w pomieszczeniu, zakłóca wielodrogowość fal radiowych (multipath fading). Marauder analizuje wariancję podnośnych względem skalibrowanego tła i natychmiast sygnalizuje obecność człowieka. Od v1.19.2 kolejka pamięci CSI jest alokowana dynamicznie tylko na czas trwania pomiaru.
Traditional metrics (like RSSI) measure only bulk aggregate signal strength. CSI probes the physical 802.11 OFDM layer — extracting precise amplitude and phase response across all 64 or 128 individual subcarriers. When a person moves within an environment, multipath propagation patterns change. Marauder computes the variance of subcarriers against a calibrated baseline, triggering motion alerts. In v1.19.2, CSI queues are allocated dynamically only while active.
| Komenda CLICLI Command | Opis operacjiOperation Description |
|---|---|
| csimotion start <AP index> | Blokuje radio na wybranym AP (z listy list -a) i uruchamia analizę zakłóceń CSILocks receiver to selected AP (from list -a) and begins CSI motion processing |
| csimotion recalibrate | Resetuje wzorzec tła i przyjmuje aktualne środowisko jako stan spoczynkuResets baseline matrix, capturing current ambient RF state as resting baseline |
| csimotion status | Zwraca aktualny poziom wariancji, próg czułości i stan wyzwolenia detekcjiReturns current subcarrier variance, detection threshold, and trigger state |
| stopscan | Zatrzymuje monitor CSI i natychmiast uwalnia pamięć bufora RAMStops CSI monitor and immediately deallocates memory queues |
08
🎯 Misje Rekonesansu Radiowego (Recon Missions)Automated Recon Missions
Tryb Recon pozwala na w pełni zautomatyzowane, ustrukturyzowane operacje rozpoznawcze. Zamiast manualnie przełączać sniffery, silnik Recon wykonuje zaplanowaną sekwencję skanowania pasma, powiązań stacji klienckich, zapytań probe i handshake'ów.The Recon engine provides fully automated, structured reconnaissance operations. Instead of manually cycling through individual tools, Recon executes orchestrated scans of APs, client associations, probe requests, and handshakes.
recon wifi
Uruchamia autonomiczną misję rozpoznania sieci WiFi: inwentaryzacja punktów dostępowych, stacji klienckich, ukrytych SSID oraz przechwytywanie handshake'ów.Executes autonomous WiFi recon mission: cataloging APs, clients, hidden SSIDs, and capturing cryptographic handshakes.
recon ble
Uruchamia autonomiczną misję BLE: mapowanie beaconów, trackerów AirTag, urządzeń Flipper, iBeacon oraz aparatury IoT.Executes autonomous BLE recon mission: mapping beacons, AirTag trackers, Flipper devices, iBeacons, and IoT hardware.
recon status / stop
Wyświetla aktualny status zadania zwiadowczego lub bezpiecznie zatrzymuje operację.Reports active status of the recon mission or terminates ongoing operations cleanly.
09
🗺️ Geofencing & Wardrive WiGLE 1.6Geofencing & WiGLE 1.6 Wardrive
Od wersji v1.17 wprowadzono wsparcie dla Geofencing (geostref wykluczenia), a w v1.19 zaktualizowano eksport CSV do standardu WiGLE 1.6 z obsługą częstotliwości kanałów i tagowania punktów orientacyjnych POI na żywo.Starting with v1.17, Geofencing exclusion boundaries were introduced, and v1.19 upgraded CSV export to the modern WiGLE 1.6 specification with frequency mappings and live POI landmark tagging.
Zarządzanie Geostrefami (Geofence System)Geofence Boundary Management
1
Marauder obsługuje do 5 niezależnych geostref konfigurowanych w GUI (
Geofences) lub CLI.Marauder supports up to 5 distinct geofences configurable via GUI (Geofences) or CLI.2
Ustawienie strefy:
geofence set <1-5> <lat> <lon> <0.1-1.0 mi> "<nazwa>". Można też użyć aktualnej pozycji GPS w GUI.Set fence: geofence set <1-5> <lat> <lon> <0.1-1.0 mi> "<name>". You can also capture current GPS position via GUI.3
Podczas wjazdu w zdefiniowany obszar logowanie warjazdu zostaje automatycznie wstrzymane, chroniąc prywatność domowej sieci.When traversing into a defined geofence, wardrive logging automatically suspends, preserving home location privacy.
4
Tagowanie POI na trasie: komenda
wardrivepoi [etykieta] lub wciśnięcie Mark POI w GUI dodaje punkt orientacyjny do logu.Tagging POIs during war driving: wardrivepoi [label] or pressing Mark POI in GUI embeds an explicit POI marker into the log.
10
🔧 Zarządzanie Urządzeniem i Kopia Zapasowa (SPIFFS Backup)Device Management & SPIFFS Backup
W wersji v1.16 zmieniono układ partycji flash na urządzeniach Marauder v8 i Mini v3, co wymagało mechanizmu zabezpieczenia plików ustawień i portali. Do firmware dodano natywny protokół migracji i backupu SPIFFS na kartę SD.In v1.16, the flash partition scheme on Marauder v8 and Mini v3 was overhauled. A native SPIFFS backup and restoration mechanism via SD card was integrated directly into the firmware.
backupspiffs v1.16
Kopiuje całą zawartość pamięci wewnętrznej SPIFFS (ustawienia
settings.json, szablony Evil Portal) do folderu /spiffs na karcie SD.Backs up the entire internal SPIFFS filesystem (settings.json, Evil Portal templates) to the /spiffs directory on the SD card.restorespiffs v1.16
Przywraca pliki konfiguracyjne z karty SD do pamięci wewnętrznej po instalacji nowego firmware lub przejściu na nowy schemat partycji.Restores configuration and portal files from SD card into SPIFFS following firmware re-flashes or partition updates.
brightness [-s 0-9 / -c] v1.16
Reguluje jasność podświetlenia ekranu TFT w skali 0–9 lub cyklicznie (
-c). Poziom jest zachowywany po resecie.Adjusts TFT screen backlight brightness on a 0–9 scale or cycles (-c). Persists across display reinitialization.Battery Fuel Gauges v1.19
Odczytuje procentowy stan naładowania i napięcie z układów AXP192, AXP2101, IP5306 oraz MAX17048 na płytkach V4, V6, V6.1, Cardputer i Waveshare C5.Monitors battery percentage and voltage from AXP192, AXP2101, IP5306, and MAX17048 fuel gauges across V4, V6, V6.1, Cardputer, and Waveshare C5.
11
💻 Kompletny Skorowidz Komend CLI (v1.20.0)Complete CLI Command Reference (v1.20.0)
Interfejs terminala szeregowego (115200 baud, 8N1). Komendy można wpisywać wielkimi lub małymi literami. Wpisz help aby uzyskać listę.Serial terminal interface (115200 baud, 8N1). Commands are case-insensitive. Type help for the live command list.
| Komenda & SkładniaCommand & Syntax | KategoriaCategory | Działanie & ParametryOperation & Parameters |
|---|---|---|
| help | Admin | Wyświetla pełne menu pomocy CLI z parametramiDisplays full command line help menu with syntax |
| info [-a <index>] | Admin | Informacje o sprzęcie, baterii, pamięci RAM i stanie połączenia WiFi; z -a szczegóły wybranego APHardware specs, battery status, RAM, and WiFi state; with -a shows specific AP details |
| channel [-s <channel>] | WiFi | Wyświetla lub ustawia bieżący kanał radiowy 802.11Displays or sets active 802.11 radio channel |
| settings [-s <name> <val>] / [-r] | Admin | Wyświetla listę ustawień, modyfikuje parametr lub resetuje do domyślnych (-r)Displays settings, alters a value, or resets to factory defaults (-r) |
| remoteid <scan/list/track/clear> [idx] | Drone | Nowość: Skanowanie, lista, śledzenie telemetryczne i czyszczenie rejestru dronów Remote IDNew: Scans, lists, tracks live telemetry, and clears Remote ID drone registry |
| csimotion start <AP idx> / recalibrate / status | Sensing | Nowość: Uruchamia detekcję ruchu ludzi CSI WiFi Sensing zablokowaną na wskazanym APNew: Starts CSI WiFi Sensing human motion detection locked onto target AP |
| recon <wifi/ble/status/stop> | Recon | Uruchamia autonomiczną misję rozpoznawczą WiFi lub BLELaunches autonomous background WiFi or BLE reconnaissance mission |
| geofence <list/set/clear> [...] | Wardrive | Konfiguracja geostref wykluczenia: geofence set <1-5> <lat> <lon> <radius_mi> "<name>"Manages wardrive geofences: geofence set <1-5> <lat> <lon> <radius_mi> "<name>" |
| wardrivepoi [label] | Wardrive | Dodaje punkt orientacyjny POI z koordynatami GPS do aktywnego pliku CSV warjazduInserts a custom POI landmark marker into the active wardrive CSV |
| upload -d <wdg/wigle/both> | Cloud | Wysyła zebrane logi warjazdu do serwisów WiGLE i/lub WDGWars przez WiFiUploads recorded wardrive logs to WiGLE and/or WDGWars via WiFi |
| join -a <idx> -p <pass> / -s | WiFi | Łączy z wybranym AP lub automatycznie z najsilniejszą znaną siecią z konfiguracji (-s)Connects to selected AP, or auto-connects to highest RSSI saved profile (-s) |
| scanap / scansta / scanall | WiFi | Skanuje punkty dostępowe, stacje klienckie lub oba jednocześnie (z ID modułów FCC)Scans access points, client stations, or both simultaneously (with FCC IDs) |
| sniffbeacon / sniffprobe / sniffdeauth | Sniffer | Nasłuchuje ramek beacon, probe request lub deauthenticationSniffs beacon frames, client probe requests, or deauth frames |
| sniffpmkid [-c <ch>] [-d] [-l] | Crypto | Przechwytuje PMKID/EAPOL; -d włącza deauth, -l używa listy kanałówCaptures PMKID/EAPOL handshakes; -d triggers deauth, -l uses channel list |
| sniffraw | Sniffer | Przechwytuje surowe pakiety 802.11 bezpośrednio do pliku PCAPStreams raw promiscuous 802.11 frames straight into PCAP |
| sniffbt [-t <type>] | BLE | Skanuje BLE; filtr -t: airtag/ibeacon/flipper/flock/metaSniffs BLE devices; filter -t: airtag/ibeacon/flipper/flock/meta |
| findmy -t <index> | BLE | Wyzwalacz dźwiękowy (ping) w urządzeniach Apple FindMy / AirTagTriggers acoustic buzzer ping in target Apple FindMy / AirTag device |
| foxhunt -w/-s/-b/-t/-f/-p/-m | Fox Hunt | Namierzanie nadajnika: AP (-w), stacja (-s), BLE (-b), FindMy (-t), Flipper (-f)RSSI transmitter hunting: AP (-w), station (-s), BLE (-b), FindMy (-t), Flipper (-f) |
| attack -t <type> [...] | Attack | Uruchamia ataki: deauth, beacon, probe, rickroll, badmsg, sleep, sae, csa, quietLaunches attacks: deauth, beacon, probe, rickroll, badmsg, sleep, sae, csa, quiet |
| blespam -t <target> | BLE | Spam BLE; typy: applejuice, sourapple, windows, samsung, google, flipper, allBLE notification flood: applejuice, sourapple, windows, samsung, google, flipper, all |
| evilportal [-c start [-w html] / sethtml] | Phishing | Uruchamia fałszywy portal captive ze wskazaną stroną HTML z karty SDEngages rogue captive portal with selected HTML payload from SD |
| karma -p <index> | Attack | Uruchamia atak Karma odpowiadając na probe requesty stacjiExecutes Karma rogue AP spoofing based on observed probe requests |
| backupspiffs / restorespiffs | System | Kopia zapasowa / przywracanie konfiguracji i portali z pamięci SPIFFS na kartę SDBacks up or restores SPIFFS settings and captive portals to/from SD |
| brightness [-s 0-9 / -c] | System | Regulacja jasności podświetlenia ekranu (poziom 0–9 lub cyklicznie)Adjusts display backlight brightness (level 0–9 or cycle) |
| stopscan [-f] | Admin | Zatrzymuje aktywne skanowanie lub atak (-f wymusza natychmiastowe zatrzymanie)Halts ongoing scan or attack (-f forces immediate termination) |
| reboot | Admin | Natychmiastowy restart procesora ESP32Instantly reboots the ESP32 microcontroller |
12
Praktyczne Scenariusze Użycia (Workflows)Practical Usage Workflows
Sprawdzone procedury łączące funkcje Maraudera do realizacji konkretnych zadań audytowych.Field-proven procedures combining Marauder features for comprehensive security assessments.
Scenariusz 1: Wykrywanie Dronów Remote ID i Zapis Tras GPXScenario 1: Drone Remote ID Detection & GPX Tracking
1
Włóż sformatowaną kartę micro-SD (FAT32) do slotu urządzenia.
2
W menu GUI wybierz
WiFi → Remote ID Scan lub w CLI wpisz remoteid scan.3
Po wykryciu drona sprawdź listę w
Remote ID Devices lub CLI: remoteid list.4
Wpisz
remoteid track 0 aby wejść w tryb śledzenia na żywo (telemetria i pilot). Trasa automatycznie zapisuje się w formacie .gpx na karcie SD.Scenariusz 2: Monitoring Ruchu Osób CSI WiFi SensingScenario 2: CSI WiFi Sensing Human Motion Detection
1
Zeskanuj dostępne punkty dostępowe (
scanap / Scan APs) i wyświetl listę (list -a).2
Wybierz stabilny AP w pomieszczeniu i uruchom monitor:
csimotion start 0 (lub w GUI: WiFi → CSI Motion Monitor).3
Opuść pomieszczenie na 10 sekund i wpisz
csimotion recalibrate, aby zarejestrować stan spoczynku fal radiowych.4
Wejście osoby w strefę propagacji wywoła skok wariancji podnośnych CSI i natychmiastowy alert ruchu na ekranie.
Scenariusz 3: Kierowany Test Penetracyjny AP (Guided Attack Profile)Scenario 3: Guided per-AP Penetration Test
1
Zeskanuj punkty dostępowe i stacje klienckie:
Scan AP/STA (scanall).2
Przejdź do
WiFi Attacks → Guided i wskaż testowany punkt dostępowy z listy.3
Wybierz opcję
Pick Stations, aby ograniczyć atak wyłącznie do autoryzowanego laptopa testowego.4
Przejrzyj profil w
Review / Continue, wybierz metodę ataku i uruchom procedurę.Scenariusz 4: Geozabezpieczony Warjazd WiGLE 1.6 & Upload do ChmuryScenario 4: Geofenced WiGLE 1.6 Wardrive & Cloud Upload
1
Skonfiguruj geostrefę domową:
geofence set 1 52.2297 21.0122 0.3 "Home".2
Wprowadź tokeny WiGLE i WDGWars w ustawieniach:
settings -s wu [user], settings -s wt [token].3
Podłącz moduł GPS, upewnij się o złapaniu fix i uruchom
Wardrive. W trakcie jazdy wciskaj Mark POI przy ciekawych obiektach.4
Po powrocie połącz się z domowym hotspotem (
join -s) i wpisz upload -d both — logi zostaną przesłane automatycznie!
13
📟 Tabela Obsługiwanego Sprzętu (Hardware Matrix)Supported Hardware Matrix
Marauder v1.20.0 kompilowany jest na kilkadziesiąt oficjalnych platform. Nigdy nie wgrywaj firmware przeznaczonego dla innej płyty głównej. Do automatycznego wgrywania zaleca się oficjalny JCMK Marauder Installer.Marauder v1.20.0 targets over 25 hardware variants. Never flash binaries compiled for a different board revision. Use the official JCMK Marauder Installer for automated flashing.
| Urządzenie / PłytkaHardware / Device | Układ SoC | Ekran / Interfejs | Plik Binary (.bin) | Cechy szczególne |
|---|---|---|---|---|
| Seeed XIAO ESP32-C5 | ESP32-C5 | Headless (CLI) | _xiao_esp32c5.bin | Wi-Fi 6 Dual-Band (2.4 + 5 GHz), miniaturowy format |
| ESP32-C5-DevKitC-1 | ESP32-C5 | Headless (CLI) | _esp32c5devkitc1.bin | Dual-Band 2.4/5 GHz, C5 Lowkey, BFFB V2, Adapter C5 |
| Waveshare ESP32-C5 3.5" | ESP32-C5 | 3.5" Touch (FT6336) | _ws_c5_35.bin | Wi-Fi 6 2.4/5GHz, AXP2101 fuel gauge, LC76G I2C GPS, PWM |
| LilyGo T-Dongle C5 | ESP32-C5 | Headless / USB | _t_dongle_c5.bin | Dual-Band 5 GHz w formie dongle USB-C, CLI |
| Dual Mini C5 | ESP32-C5 | Headless / Mini | _dual_mini_c5.bin | Dual-band Wi-Fi 6, ultra-kompaktowa obudowa |
| M5Stack Cardputer ADV | ESP32-S3 | 1.14" TFT + Klawiatura | _m5cardputer_adv.bin | Pełna klawiatura QWERTY, fix ciemnego ekranu w v1.20 |
| M5Stack Cardputer | ESP32-S3 | 1.14" TFT + Klawiatura | _m5cardputer.bin | Dostępny także na M5Burner, mikrofon, głośnik, bateria |
| M5Stack Core2 for AWS | ESP32-D0WDQ6 | 2.0" Capacitive Touch | _m5stack_core2_aws.bin | Dodany w v1.19.1, układ zasilania AXP192, dotykowy ekran |
| M5Stack StickC Plus 2 | ESP32-PICO-V3 | 1.14" TFT | _m5stickc_plus2.bin | Kompaktowy format, RTC, zasilanie akumulatorowe |
| M5 Nano C6 | ESP32-C6 | Headless / LED | _m5nanoc6.bin | Nowy układ ESP32-C6 (Wi-Fi 6 2.4 GHz + Zigbee/Thread) |
| Marauder v8 & Pancake | ESP32-WROVER | 2.8" / 3.2" TFT Touch | _v8.bin / _pancake.bin | Nowy schemat partycji flash v1.16+, obsługa PSRAM |
| Marauder Mini v3 | ESP32-WROOM | Headless / Mini | _mini_v3.bin | Zoptymalizowana pamięć masowa, miniaturowa płytka |
| Marauder v6 / v6.1 / v6.2 | ESP32-WROOM | 2.8" ILI9341 Touch | _v6.bin / _v6_1.bin | Wskaźnik paliwa IP5306/MAX17048, obsługa kart SD |
| Flipper Zero WiFi Dev | ESP32-S2 | Headless (SPI Flipper) | _flipper.bin | Sterowanie przez aplikację Flipper Zero Marauder Companion |
| MultiBoard S3 | ESP32-S3 | Flipper / UART | _multiboardS3.bin | Flipper Zero MultiBoard z układem ESP32-S3 |
| Marauder Dev Board Pro | ESP32-WROOM | Headless (UART/BFFB) | _marauder_dev_board_pro.bin | AWOK V3 Flipper, Dev Board Pro, wysoka moc radiowa |
| CYD 2432S028 (Cheap Yellow) | ESP32 | 2.8" Resistive Touch | _cyd_2432S028.bin | Tani moduł ESP32 z ekranem 320x240, wersje 1-USB i 2-USB |
| CYD 3.5" (3248S035) | ESP32 | 3.5" Touch (480x320) | _cyd_3_5_inch.bin | Duży wyświetlacz 3.5 cala, obsługa kart SD |
| POOM (Stellar IoT POOM) | ESP32 | OLED / Custom Font | _poom.bin | Wsparcie dla paska LED WS2812, dedykowany font |
14
📦 Historia Wydań i Zmian (v1.14.0 → v1.20.0)Release History (v1.14.0 → v1.20.0)
Szczegółowy przegląd kluczowych zmian, commitów i nowych funkcji wprowadzonych w oficjalnym repozytorium GitHub.Detailed record of major architectural updates, PR merges, and commits added across recent releases.
v1.20.0
2026-10-28
LATEST RELEASE
Kierowane Profile Ataków WiFi & Integracja Waveshare C5:Guided WiFi Attack Profiles & Waveshare C5 Integration:
- Guided per-AP attack profiles (#1662): Zintegrowany kreator ataków per-AP z ograniczeniem zasięgu (bounded scope), wyborem stacji i menu weryfikacji.Integrated per-AP attack wizard with bounded scope, station picking, and review menus.
- FCC Module IDs & Station AP selection (#1660): Identyfikacja producentów modułów radiowych po numerach FCC oraz wiązanie stacji klienckich z AP.Manufacturer identification by FCC module IDs and station-to-AP association logic.
- Remote ID Detection Compatibility (#1678): Poprawa zgodności ramek dronów Remote ID, stabilniejsze czasy skanowania i filtry.Improved Remote ID drone frame parsing bounds, timing, and compatibility.
- Censor Mode dla Remote ID (#1679): Zastosowanie przełącznika Censor do ukrywania współrzędnych pilota i numerów seryjnych dronów.Applied Censor setting to redact drone serials and pilot coordinates on screen.
- Waveshare C5 3.5" Hardware Fixes (#1677): Kompletny pakiet poprawek: obsługa dotyku FT6336 na przerwaniu, wskaźnik baterii AXP2101, GPS I2C LC76G oraz podświetlenie PWM.Hardware fixes: FT6336 touch INT gating, AXP2101 fuel gauge, LC76G I2C GPS, and PWM backlight.
- Cardputer Display Startup Fix (#1676): Rozwiązanie problemu ciemnego ekranu przy rozruchu na M5 Cardputer ADV.Fixed dark screen display boot regression on M5 Cardputer ADV.
v1.19.2
2026-10-23
Optymalizacja Pamięci CSI Motion:CSI Motion Memory Reclamation:
- Dynamiczna alokacja kolejki CSI (#1653): Kolejka pamięci dla danych CSI jest teraz tworzona wyłącznie w czasie aktywnego działania monitora ruchu, odzyskując dziesiątki kilobajtów sterty (heap) dla innych zadań.CSI motion queue memory is allocated strictly while active, freeing critical heap for other scans.
v1.19.1
2026-10-21
M5Stack Core2 AWS & Waveshare C5 Port:M5Stack Core2 AWS & Waveshare C5 Port:
- M5Stack Core2 for AWS (#1645): Oficjalny port firmware z obsługą dotykowego ekranu i kontrolera zasilania AXP192.Official firmware port supporting capacitive touchscreen and AXP192 power management.
- Redukcja zużycia RAM przy warjeździe (#1646): Zoptymalizowano pamięć buforów warjazdu na płytkach pozbawionych zewnętrznej pamięci PSRAM.Reduced wardrive memory footprint on boards lacking external PSRAM.
- Waveshare ESP32-C5-Touch-LCD-3.5 (#1650): Wstępna integracja obsługi płytki Waveshare C5 3.5 cala.Initial hardware integration for the Waveshare ESP32-C5 3.5-inch target.
v1.19.0
2026-10-20
CSI WiFi Motion Sensing, XIAO C5 & WiGLE 1.6:CSI WiFi Motion Sensing, XIAO C5 & WiGLE 1.6:
- CSI Motion Monitor (#1620): Wprowadzenie rewolucyjnej detekcji obecności człowieka w oparciu o analizę zniekształceń podnośnych CSI.Introduced human motion sensing via 802.11 Channel State Information (CSI) subcarrier analysis.
- Seeed XIAO ESP32-C5 Target (#1606): Wsparcie dla dwuzakresowego mikrokontrolera ESP32-C5 (pasma 2.4 GHz i 5 GHz Wi-Fi 6).Added Seeed XIAO ESP32-C5 target enabling dual-band 2.4/5 GHz Wi-Fi 6 operations.
- Uaktualnienie formatu do WiGLE 1.6 (#1632): Logi warjazdu generowane w najnowszej specyfikacji WiGLE z częstotliwościami radiowymi.Wardrive logs upgraded to modern WiGLE 1.6 CSV standard with radio frequencies.
- Display Censor Mode (#1620): Nowe ustawienie systemowe Censor maskujące wrażliwe dane na ekranie dla twórców treści.New Censor system toggle masking sensitive MACs and coordinates for content creators.
- Battery Fuel Gauges (#1608): Wsparcie dla układów pomiaru naładowania IP5306 i MAX17048 na płytkach V4, V6 i V6.1.Added IP5306 and MAX17048 battery gauge telemetry for V4, V6, and V6.1 hardware.
v1.18.0
2026-10-06
Radar Dronów Remote ID & iBeacon Discovery:Remote ID Drone Radar & iBeacon Discovery:
- Remote ID Collection & Live Tracking (#1579, #1592): Skaner i radar dronów FAA/OpenDroneID, telemetria, historia pozycji i logowanie tras GPX na SD.FAA/OpenDroneID drone sniffer, live telemetry tracking, route history, and GPX logging to SD.
- iBeacon Discovery (#1562): Wykrywanie i inspekcja pakietów Apple iBeacon (UUID, Major, Minor, odległość).Sniffing and decoding of Apple iBeacon frames (Proximity UUID, Major, Minor, distance).
- Wsparcie dla POOM (#1562): Obsługa sprzętowa platformy Stellar IoT POOM z diodami WS2812 i dedykowanym fontem.Added hardware support for Stellar IoT POOM with WS2812 LED strip and custom display fonts.
- Memory Pressure Safeguards (#1594): Globalne mechanizmy ochrony przed wyczerpaniem pamięci sterty (MemoryGuard).System-wide memory pressure safeguards preventing out-of-memory aborts.
v1.17.0
2026-09-16
Profile Sieci WiFi & Geofencing Warjazdu:WiFi Saved Profiles & Wardrive Geofencing:
- Wiele zapisanych sieci WiFi (#1545): Zapis do 5 profili sieciowych z automatycznym wyborem najsilniejszej znanej sieci (Scan-First).Stored up to 5 trusted WiFi network profiles with scan-first strongest AP auto-association.
- Wardrive Geofencing (#1550): Konfigurowalne geostrefy wykluczeń automatycznie wstrzymujące rejestrację wokół domu.Configurable geofence boundaries automatically pausing logging around sensitive locales.
v1.16.0
2026-09-08
Nowy Układ Partycji Flash & Narzędzie Kopia Zapasowej SPIFFS:New Flash Partition Layout & SPIFFS Migration Tooling:
- Nowy schemat partycji dla v8 i Mini v3: Zwiększenie przestrzeni na firmware do obsługi nowych funkcji radiowych.Overhauled flash partition layout expanding application binary space for advanced RF tools.
- Narzędzia SPIFFS Backup / Restore (#1494, #1495): Kopia zapasowa ustawień i portali na kartę SD przed flashowaniem (
backupspiffs).Native SPIFFS backup and restoration to SD to safeguard configs during flash wipes. - Touch Hold-Repeat (#1531): Płynne przewijanie menu po przytrzymaniu palca na strefie dotykowej.Continuous smooth menu scrolling by holding down touch screen navigation zones.
v1.15.0
2026-08-20
Ekspansja Fox Hunt & Asynchroniczny Packet Monitor:Fox Hunt Expansion & Stacked Packet Monitor:
- Rozbudowa Fox Hunt (#1476, #1479): Obsługa AP, stacji, BLE, FindMy, Flipper, Pineapple z sortowaniem po RSSI i filtrami pasm.Added AP, station, BLE, FindMy, Flipper targets to Fox Hunt with RSSI sorting and band filters.
- Asynchroniczny Packet Monitor (#1483): Zrefaktoryzowany wielopoziomowy wykres ruchu pakietów WiFi w czasie rzeczywistym.Stacked asynchronous real-time WiFi packet rate visualization graphs.
- LilyGo T-Dongle C5 (#1485): Wsparcie dla sprzętowego dongla USB ESP32-C5.Added CLI target support for the LilyGo T-Dongle C5 USB hardware platform.
15
Ostrzeżenia Prawne & Kodeks EtycznyLegal Warnings & Ethics Code
ODPOWIEDZIALNOŚĆ PRAWNA:LEGAL LIABILITY:
Używanie ESP32 Marauder do zakłócania pracy sieci radiowych (ataki deauth flood, spamowanie beaconami, generowanie fałszywych ramek CSA/Quiet, ataki BLE spam) przeciwko celom, na które nie uzyskano uprzedniej, pisemnej zgody właściciela infrastruktury, stanowi przestępstwo w świetle przepisów Kodeksu Karnego (m.in. art. 267 i 268a KK w Polsce) oraz międzynarodowych regulacji telekomunikacyjnych (Dyrektywa RED w UE, regulacje FCC w USA). Twórcy oprogramowania ani autorzy niniejszej instrukcji nie ponoszą żadnej odpowiedzialności za jakiekolwiek szkody powstałe w wyniku niewłaściwego lub niezgodnego z prawem użycia urządzenia. Urządzenie służy wyłącznie do celów edukacyjnych, certyfikowanych testów penetracyjnych oraz obrony systemów bezprzewodowych.
Deploying ESP32 Marauder to disrupt wireless communications (deauth floods, beacon spoofing, CSA/Quiet injection, BLE spamming) against targets without explicit, prior written authorization is illegal under federal and international telecommunications law (e.g. FCC regulations, EU RED Directive, Computer Fraud and Abuse Act). Neither the software creators nor the authors of this manual assume any liability for damage or legal consequences arising from illicit operation. This platform is distributed exclusively for security research, academic education, and authorized penetration testing.