Skip to content

v2026.11

Pre-release
Pre-release

Choose a tag to compare

@RyanDFIR RyanDFIR released this 16 Nov 15:13
fe97497

Upgrading

  • Python 3.11 or newer is now required (was 3.9).
  • pip install pyhindsight now works on its own. ccl_chromium_reader is bundled, so the separate install step is gone.
  • Relative -l and --temp_dir paths 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_reader and pin to specific commit by @RyanDFIR in #302
  • Remove pycryptodome dependency; add Cryptodome and zstd to 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 🎉

Full Changelog: v2026.06...v2026.11