Repository navigation
v2026.11
Pre-release
Pre-release
Upgrading
- Python 3.11 or newer is now required (was 3.9).
pip install pyhindsightnow works on its own.ccl_chromium_readeris bundled, so the separate install step is gone.- Relative
-land--temp_dirpaths now resolve from the working directory, and the default log is written there too. The packaged executables still write next to themselves. - The log no longer records DEBUG lines by default. The level is now selectable.
- Timestamps are written with the precision their source has, so precision now varies between artifacts.
What's Changed
🚀 Features
- Bundle ccl_chromium_reader so pip install works by @RyanDFIR in #381
- Add artifact filtering and test coverage for selectable browser artif… by @RyanDFIR in #298
- Decode server file time and size from download and cache ETags by @sujayadkesar in #376
- Decode more ETag formats and check hashes against sent bytes by @akhil-dara in #380
- Hash cache bodies and File System backing files by @RyanDFIR in #316
- Recover LevelDB records past damage, and report it in every LevelDB parser by @RyanDFIR in #383
- Detect the Chrome version from each database's meta table by @RyanDFIR in #364
- Separate IndexedDB database from object store, and keep the value structured by @RyanDFIR in #317
- Write session windows and tab/window IDs to JSONL and SQLite by @RyanDFIR in #386
- Report a saved credential even when its value cannot be decrypted by @RyanDFIR in #312
- Make the log level selectable instead of always DEBUG by @dchaudhari7177 in #351
- Say what was not parsed for Firefox extensions by @RyanDFIR in #404
🛠️ Minor Changes & Fixes
- Fix KeyError on cookies with no expires_utc (e.g. Firefox session cookies) by @hackafruit in #294
- Add India (UTC+5:30) and other missing timezones; accept UTC offsets by @sujayadkesar in #377
- Fix crash and lost records for profiles past Windows' 260-character path limit by @sujayadkesar in #378
- Record a parser that raises as a failed artifact instead of ending the run by @RyanDFIR in #379
- Refuse an input path that can't be read instead of crashing by @RyanDFIR in #385
- Stop output formats silently dropping whole artifacts by @RyanDFIR in #301
- Stop the SQLite timeline table dropping rows with nothing said by @dchaudhari7177 in #349
- Continue a full XLSX sheet on another sheet instead of dropping its rows by @dchaudhari7177 in #362
- Mark XLSX cells cut to fit Excel's per-cell limit by @RyanDFIR in #367
- Add None-safe XLSX handling and enhance error logging/debugging by @RyanDFIR in #295
- Store dict and list preference values as JSON in SQLite by @RyanDFIR in #387
- Write timestamps with the precision their source has by @RyanDFIR in #395
- Keep the stored microsecond in to_datetime by @RyanDFIR in #394
- Run the timestamp decoder over storage rows, as it always claimed to by @RyanDFIR in #318
- Keep cache entries that have no metadata, untimed by @RyanDFIR in #319
- Stop reporting cache locations for files that do not exist by @RyanDFIR in #320
- Read Chrome cache entries one key at a time so one bad entry is only one by @dchaudhari7177 in #356
- Find the Firefox cache regardless of the workstation's OS by @RyanDFIR in #311
- Keep going when a LevelDB .log file is damaged by @mayuriphad in #375
- Replace the hard-coded oversized-IndexedDB skip with a measured per-store cap by @dchaudhari7177 in #348
- Skip an unreadable IndexedDB record instead of ending its object store by @dchaudhari7177 in #361
- Say how far the failing IndexedDB object store got, and what failed by @dchaudhari7177 in #360
- Skip database_metadata cleanly and report the schema version it carries by @dchaudhari7177 in #347
- Fix the Chrome version detection probes by @RyanDFIR in #363
- Find extensions whose version directory has no dot in it by @RyanDFIR in #345
- Show Firefox add-ons only on the Extensions worksheet by @RyanDFIR in #388
- Ensure artifact failure keys align with count keys in Firefox parser by @RyanDFIR in #299
- Remove the per-run database copy after every profile, not only Chrome ones by @dchaudhari7177 in #355
- Refactor parsing counts and display by @RyanDFIR in #300
- Stop warning that a healthy run may be useless by @RyanDFIR in #321
- Add encoding resilience to progress display and stdout by @RyanDFIR in #307
- Add tests and fixes for odd record handling, nested value encoding, and teardown failures by @RyanDFIR in #304
- Update the install docs and fix the piped banner by @RyanDFIR in #405
🔒 Hardening
- Harden the web UI and the XLSX output against hostile input by @RyanDFIR in #399
- Load custom plugins from two known directories, not all of sys.path by @RyanDFIR in #400
- Limit how much a compressed cache body or session file can expand to by @RyanDFIR in #403
- Require Brotli 1.2.1 for the decoder out-of-bounds write fix by @RyanDFIR in #389
- Pin what the release build installs and runs by @RyanDFIR in #401
Other Changes
- Update references to new repository and author information by @RyanDFIR in #290
- Refactor cookie parsing and remove unused URLItem fields by @RyanDFIR in #291
- Check-in Chromium protobuf definitions for download tracking, perform… by @RyanDFIR in #292
- Add tests for Firefox sessionstore parsing and enhance session snapsh… by @RyanDFIR in #296
- Add unit tests for timestamp handling, untimed artifact sorting, and … by @RyanDFIR in #297
- Allow missing data in
ccl_chromium_readerand pin to specific commit by @RyanDFIR in #302 - Remove
pycryptodomedependency; addCryptodomeandzstdto hidden imports by @RyanDFIR in #303 - Add GitHub Actions workflow for matrix-based Python unit tests and up… by @RyanDFIR in #305
- Move packaging to pyproject.toml by @RyanDFIR in #306
- Add end-to-end corpus parse tests by @RyanDFIR in #308
- Add a contributing guide, mostly about the corpus tests by @RyanDFIR in #350
- Fold the duplicated per-browser promotion loop into a helper by @dchaudhari7177 in #352
- Clarify input discovery and browser overrides in the README by @forest-savage1234 in #369
- Add Chromium's license beside the vendored .proto files by @RyanDFIR in #382
- Name exceptions for failure reasons with one helper by @RyanDFIR in #384
- Remove the Chromium build and C++ files from the vendored sync protos by @RyanDFIR in #390
- Drop a stray parenthesis from the cache and Preferences error log lines by @RyanDFIR in #391
- Say where the althttpd, Qiniu and Microsoft Distribute test values came from by @akhil-dara in #392
- Cut releases from the GitHub releases page, and prep 2026.11 by @RyanDFIR in #406
- Refresh the Chrome schema versions (#366, #368, #372, #396, #397)
- Dependency updates by @dependabot[bot] (#293, #371, #373, #402)
New Contributors 🎉
- @hackafruit made their first contribution in #294
- @dchaudhari7177 made their first contribution in #347
- @forest-savage1234 made their first contribution in #369
- @sujayadkesar made their first contribution in #377
- @mayuriphad made their first contribution in #375
- @akhil-dara made their first contribution in #380
Full Changelog: v2026.06...v2026.11