Repository navigation
Fixes from a second pass over a real KAPE collection (a VHDX of a running Windows 10 PC). Checked on that collection with the 1.0.2-rc1 test build before release.
What changed
| Before | 1.0.2 |
|---|---|
setupapi.dev.log (local time) was converted with the offset in force at collection, so installs from the other side of a daylight-saving change were an hour off, and could show as a ghost "no removal" session one hour after the real one |
Converted with the host's time zone and its DST rules; the offset at collection is only a fallback (details.tz_used). On the real collection, setupapi now agrees to the second with Partition/Diagnostic 1006 and System 20003 |
| An external hard disk whose USB node and disk events (Security 6416) came a few seconds apart showed as two rows in the replay table, with two first-seen alerts | Paired within 30 s; a row never holds two disks or two USB nodes, so a quick re-plug stays two rows |
Orphaned MountPoints2 volume GUIDs gave no time of their own |
The tamper finding decodes the time inside the GUID ("first mounted here at or shortly after", since the stamp can run a few minutes early) and counts other orphans stamped in the same second, which one stick's plug-in cannot explain |
| "Look at first" under the replay table showed times without dates | Full dates, first to last |
A wrong --system / --software / --ntuser path only warned, and the run went on without that hive (as "unknown-host", with every orphan check skipped) |
Stops before loading anything and suggests the file in that folder, for example the name rla.exe gave the replayed hive (F_C_Windows_System32_config_SYSTEM) |
The dirty-hive warning for a user hive said --system / --software |
Names the flag that takes that hive (--ntuser <clean file>=<user> for a user hive) |
Release files updated on 2026-11-19 with the last two rows, found by replaying the real collection's dirty hives with rla.exe. With the clean hives, the orphan raised for the drive connected just before collection disappeared, as its dirty-hive caution had said it might. If you downloaded 1.0.2 earlier, re-download; the hashes below are the current ones.
Details: CHANGELOG
Downloads
| File | For |
|---|---|
usbhawk-1.0.2-windows-x64.zip |
Windows, no Python needed: unzip and run .\usbhawk.exe. Includes the docs, the demo data, collect_local.ps1 for live response and the lab Sysmon config |
usbhawk-1.0.2-py3-none-any.whl |
Python 3.11+ on Windows, Linux or macOS: pip install usbhawk-1.0.2-py3-none-any.whl |
SHA256SUMS.txt |
Check your download: Get-FileHash <file> (PowerShell) or certutil -hashfile <file> SHA256 (CMD) |
The exe is not code-signed yet, so SmartScreen may warn on first run (More info, Run anyway).
449 automated tests; every documented command is run by the test suite. All demo data is fictional. Use USBHawk only on systems and evidence you are authorised to examine.