How abrignoni/crush-forensics works
Crush is a desktop digital-forensics workbench. An investigator opens an archive, backup, folder, or file; the app exposes it through a virtual filesystem, identifies and parses selected files, then presents results in format-specific viewers and searchable case tools. The graph preserves documented specialist capabilities such as SQLite carving, Multi-Log Studio, BLOB/value inspection, and Peach handoff. Several parser/viewer links are based on documented product capabilities; unsampled implementations are represented only at supported paths.
Main entry points: main_window.py Main window · vfs.py Virtual filesystem · multi_log_viewer.py Multi-Log Studio · fs_panel.py Filesystem panel
Components 21
Evidence intake
- Virtual filesystem
crush/core/vfs.py
Format analysis
- Format database
crush/core/format_db.py - Magic detection
crush/core/magic.py - Parser registry
crush/core/registry.py - Parser interface
crush/parsers/base.py - SQLite parser
crush/parsers/sqlite_parser.py - Realm parser
crush/parsers/realm_parser.py - SEGB parser
crush/parsers/segb_parser.py - Log parsers
crush/parsers/log_parser.py - Unified log parser
crush/parsers/unified_log_parser.py
Workbench
- Main window
crush/ui/main_window.py - Case session
crush/core/session.py - Filesystem panel
crush/ui/fs_panel.py - Database viewer
crush/viewers/table_viewer.py - Hex viewer
crush/viewers/hex_viewer.py
Specialist tools
- Multi-Log Studio
crush/viewers/multi_log_viewer.py - Log database
crush/core/log_db.py - BLOB inspector
crush/viewers/blob_inspector.py - Value inspector
crush/viewers/value_inspector.py - Peach viewer
Other components
- Investigator
Connections 23
- Investigator → Main window: opens evidence
- Main window → Case session: manages case
crush/ui/main_window.py - Case session → Virtual filesystem: opens sources
crush/core/session.py - Main window → Filesystem panel: shows files
crush/ui/main_window.py - Filesystem panel → Virtual filesystem: browses tree
crush/ui/fs_panel.py - Filesystem panel → Format database: identifies formats
crush/ui/fs_panel.py - Format database → Magic detection: checks magic bytes
crush/core/format_db.py - Main window → Parser registry: selects parser
crush/ui/main_window.py - Parser registry → Parser interface: registers parsers
crush/core/registry.py - SQLite parser → Virtual filesystem: reads evidence
crush/parsers/sqlite_parser.py - Realm parser → Virtual filesystem: reads evidence
crush/parsers/realm_parser.py - SEGB parser → Virtual filesystem: reads evidence
crush/parsers/segb_parser.py - Log parsers → Virtual filesystem: reads evidence
crush/parsers/log_parser.py - Unified log parser → Virtual filesystem: reads evidence
crush/parsers/unified_log_parser.py - Main window → Database viewer: opens parsed tables
crush/ui/main_window.py - Main window → Hex viewer: opens parsed data
crush/ui/main_window.py - Main window → Multi-Log Studio: opens log analysis
crush/ui/main_window.py - Multi-Log Studio → Log database: stores log entries
crush/viewers/multi_log_viewer.py - Multi-Log Studio → Unified log parser: parses unified logs
crush/viewers/multi_log_viewer.py - Multi-Log Studio → Log parsers: parses log sources
crush/viewers/multi_log_viewer.py - Database viewer → BLOB inspector: inspects BLOBs
crush/viewers/table_viewer.py - Investigator → Value inspector: interprets values
- Investigator → Peach viewer: sends log source