Recon Desktop Tool

Marauder Recon Desktop Tool

The Marauder Recon Converter turns one copied Recon mission directory into a portable report. It runs on a computer; it is not installed on the Marauder or copied to its SD card.

Inputs

Copy the complete mission directory, such as m0042, from /recon on the Marauder SD card. A valid mission contains session.json and obs.rlog; it may also contain probes.rlog, relations.rlog, and a PCAP capture.

Keep the original mission files as the authoritative raw evidence. The generated report is a convenient view of those records.

Desktop Application

1. Download the Recon Converter artifact for your operating system from the applicable ESP32Marauder GitHub Actions run or release package.
2. Copy the complete mission directory from the SD card to the computer.
3. Open Marauder-Recon-Converter.
4. Select the copied mission directory.
5. Choose Build Report.

On operating systems that pass dropped folders to applications, a mission directory can also be dragged onto the converter executable.

Python Fallback

Python 3.10 or newer can run the converter without third-party runtime packages:

python3 tools/recon_report.py /path/to/m0042 --zip

Run the command from a clone or downloaded source archive of the ESP32Marauder repository.

Outputs

• report/index.html - self-contained interactive report with timeline scrubbing
• report/observations.csv - spreadsheet-friendly observation data
• report/mission.json - expanded observations and relationships
• m0042-report.zip - portable copy of the generated report when ZIP output is requested

Open report/index.html in a modern browser. No Marauder or network connection is required after the report is generated.

Interrupted missions whose manifest still says active can be converted when their records are intact, but final counters and duration may be incomplete. Relationship entries are observations and must not be treated as identity claims.