ForensicaLite
NTFS disk forensics toolkit
A raw-disk NTFS forensic analyzer in pure Python. It recovers deleted files, detects timestomping and rebuilds file history, without touching the OS file APIs.
- 100,159MFT records parsed in 5.7 s on a 57 GB volume
- 300K+USN journal records processed
- 0Scan errors; layout matched Windows fsutil
- 156Automated tests (pytest + Vitest)
How it works
- Opens Windows volumes at the sector level (
\\.\X:), bypassing OS file APIs and locks, and parses the boot sector, $MFT, $Bitmap and USN change journal by hand, using only the standard library. - The MFT parser handles update-sequence fixups, signed-delta data runs, fragmented $MFT extents and $ATTRIBUTE_LIST records. A 1 MiB chunk cache cuts physical reads to one per 1,024 records.
- Recovers resident deleted files byte for byte, and grades how recoverable non-resident ones are by checking $Bitmap for reallocated clusters.
- Flags timestomping (comparing $STANDARD_INFORMATION with $FILE_NAME, plus zeroed sub-second precision), hidden Alternate Data Streams and orphaned records, and rebuilds rename, move and delete history from the USN journal.
- An offline React report app (triage, timeline, hex viewer, IndexedDB case storage, HTML/CSV export) means evidence never leaves the examiner's machine. A versioned JSON contract, checked in CI against real analyzer output, connects the two.
- Ships as a tkinter GUI and a CLI packaged as standalone Windows executables. Tests run against a synthetic NTFS image built byte by byte, so they need no real drive or admin rights.