# abrignoni/crush-forensics architecture

> Architecture diagram of the GitHub repository abrignoni/crush-forensics, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/abrignoni/crush-forensics
- Repository: https://github.com/abrignoni/crush-forensics

## Overview

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: [`crush/ui/main_window.py`](https://github.com/abrignoni/crush-forensics/blob/main/crush/ui/main_window.py) (Main window), [`crush/core/vfs.py`](https://github.com/abrignoni/crush-forensics/blob/main/crush/core/vfs.py) (Virtual filesystem), [`crush/viewers/multi_log_viewer.py`](https://github.com/abrignoni/crush-forensics/blob/main/crush/viewers/multi_log_viewer.py) (Multi-Log Studio), [`crush/ui/fs_panel.py`](https://github.com/abrignoni/crush-forensics/blob/main/crush/ui/fs_panel.py) (Filesystem panel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_intake["Evidence intake"]
  node_vfs["Virtual filesystem<br/>[vfs.py]"]
end

subgraph group_analysis["Format analysis"]
  node_format_db[("Format database<br/>[format_db.py]")]
  node_magic["Magic detection<br/>[magic.py]"]
  node_registry["Parser registry<br/>[registry.py]"]
  node_parser_api["Parser interface<br/>[base.py]"]
  node_sqlite_parser["SQLite parser<br/>[sqlite_parser.py]"]
  node_realm_parser["Realm parser<br/>[realm_parser.py]"]
  node_segb_parser["SEGB parser<br/>[segb_parser.py]"]
  node_log_parser["Log parsers<br/>[log_parser.py]"]
  node_unified_parser["Unified log parser"]
end

subgraph group_workbench["Workbench"]
  node_window["Main window<br/>[main_window.py]"]
  node_session[("Case session<br/>[session.py]")]
  node_filesystem_panel["Filesystem panel<br/>[fs_panel.py]"]
  node_table_viewer["Database viewer<br/>[table_viewer.py]"]
  node_hex_viewer["Hex viewer<br/>[hex_viewer.py]"]
end

subgraph group_specialist["Specialist tools"]
  node_multi_log["Multi-Log Studio"]
  node_log_database[("Log database<br/>[log_db.py]")]
  node_blob_inspector["BLOB inspector<br/>[blob_inspector.py]"]
  node_value_inspector["Value inspector<br/>[value_inspector.py]"]
  node_peach["Peach viewer"]
end

node_investigator(("Investigator"))

node_investigator -->|"opens evidence"| node_window
node_window -->|"manages case"| node_session
node_session -->|"opens sources"| node_vfs
node_window -->|"shows files"| node_filesystem_panel
node_filesystem_panel -->|"browses tree"| node_vfs
node_filesystem_panel -->|"identifies formats"| node_format_db
node_format_db -->|"checks magic bytes"| node_magic
node_window -->|"selects parser"| node_registry
node_registry -->|"registers parsers"| node_parser_api
node_sqlite_parser -->|"reads evidence"| node_vfs
node_realm_parser -->|"reads evidence"| node_vfs
node_segb_parser -->|"reads evidence"| node_vfs
node_log_parser -->|"reads evidence"| node_vfs
node_unified_parser -->|"reads evidence"| node_vfs
node_window -->|"opens parsed tables"| node_table_viewer
node_window -->|"opens parsed data"| node_hex_viewer
node_window -->|"opens log analysis"| node_multi_log
node_multi_log -->|"stores log entries"| node_log_database
node_multi_log -->|"parses unified logs"| node_unified_parser
node_multi_log -->|"parses log sources"| node_log_parser
node_table_viewer -->|"inspects BLOBs"| node_blob_inspector
node_investigator -->|"interprets values"| node_value_inspector
node_investigator -.->|"sends log source"| node_peach

click node_window "https://github.com/abrignoni/crush-forensics/blob/main/crush/ui/main_window.py"
click node_session "https://github.com/abrignoni/crush-forensics/blob/main/crush/core/session.py"
click node_filesystem_panel "https://github.com/abrignoni/crush-forensics/blob/main/crush/ui/fs_panel.py"
click node_vfs "https://github.com/abrignoni/crush-forensics/blob/main/crush/core/vfs.py"
click node_format_db "https://github.com/abrignoni/crush-forensics/blob/main/crush/core/format_db.py"
click node_magic "https://github.com/abrignoni/crush-forensics/blob/main/crush/core/magic.py"
click node_registry "https://github.com/abrignoni/crush-forensics/blob/main/crush/core/registry.py"
click node_parser_api "https://github.com/abrignoni/crush-forensics/blob/main/crush/parsers/base.py"
click node_sqlite_parser "https://github.com/abrignoni/crush-forensics/blob/main/crush/parsers/sqlite_parser.py"
click node_realm_parser "https://github.com/abrignoni/crush-forensics/blob/main/crush/parsers/realm_parser.py"
click node_segb_parser "https://github.com/abrignoni/crush-forensics/blob/main/crush/parsers/segb_parser.py"
click node_log_parser "https://github.com/abrignoni/crush-forensics/blob/main/crush/parsers/log_parser.py"
click node_unified_parser "https://github.com/abrignoni/crush-forensics/blob/main/crush/parsers/unified_log_parser.py"
click node_table_viewer "https://github.com/abrignoni/crush-forensics/blob/main/crush/viewers/table_viewer.py"
click node_hex_viewer "https://github.com/abrignoni/crush-forensics/blob/main/crush/viewers/hex_viewer.py"
click node_multi_log "https://github.com/abrignoni/crush-forensics/blob/main/crush/viewers/multi_log_viewer.py"
click node_log_database "https://github.com/abrignoni/crush-forensics/blob/main/crush/core/log_db.py"
click node_blob_inspector "https://github.com/abrignoni/crush-forensics/blob/main/crush/viewers/blob_inspector.py"
click node_value_inspector "https://github.com/abrignoni/crush-forensics/blob/main/crush/viewers/value_inspector.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_vfs toneBlue
class node_format_db,node_magic,node_registry,node_parser_api,node_sqlite_parser,node_realm_parser,node_segb_parser,node_log_parser,node_unified_parser toneAmber
class node_window,node_session,node_filesystem_panel,node_table_viewer,node_hex_viewer toneMint
class node_multi_log,node_log_database,node_blob_inspector,node_value_inspector,node_peach toneRose
class node_investigator toneIndigo
```

## Components

### Evidence intake

- [Virtual filesystem](https://github.com/abrignoni/crush-forensics/blob/main/crush/core/vfs.py): `crush/core/vfs.py`

### Format analysis

- [Format database](https://github.com/abrignoni/crush-forensics/blob/main/crush/core/format_db.py): `crush/core/format_db.py`
- [Magic detection](https://github.com/abrignoni/crush-forensics/blob/main/crush/core/magic.py): `crush/core/magic.py`
- [Parser registry](https://github.com/abrignoni/crush-forensics/blob/main/crush/core/registry.py): `crush/core/registry.py`
- [Parser interface](https://github.com/abrignoni/crush-forensics/blob/main/crush/parsers/base.py): `crush/parsers/base.py`
- [SQLite parser](https://github.com/abrignoni/crush-forensics/blob/main/crush/parsers/sqlite_parser.py): `crush/parsers/sqlite_parser.py`
- [Realm parser](https://github.com/abrignoni/crush-forensics/blob/main/crush/parsers/realm_parser.py): `crush/parsers/realm_parser.py`
- [SEGB parser](https://github.com/abrignoni/crush-forensics/blob/main/crush/parsers/segb_parser.py): `crush/parsers/segb_parser.py`
- [Log parsers](https://github.com/abrignoni/crush-forensics/blob/main/crush/parsers/log_parser.py): `crush/parsers/log_parser.py`
- [Unified log parser](https://github.com/abrignoni/crush-forensics/blob/main/crush/parsers/unified_log_parser.py): `crush/parsers/unified_log_parser.py`

### Workbench

- [Main window](https://github.com/abrignoni/crush-forensics/blob/main/crush/ui/main_window.py): `crush/ui/main_window.py`
- [Case session](https://github.com/abrignoni/crush-forensics/blob/main/crush/core/session.py): `crush/core/session.py`
- [Filesystem panel](https://github.com/abrignoni/crush-forensics/blob/main/crush/ui/fs_panel.py): `crush/ui/fs_panel.py`
- [Database viewer](https://github.com/abrignoni/crush-forensics/blob/main/crush/viewers/table_viewer.py): `crush/viewers/table_viewer.py`
- [Hex viewer](https://github.com/abrignoni/crush-forensics/blob/main/crush/viewers/hex_viewer.py): `crush/viewers/hex_viewer.py`

### Specialist tools

- [Multi-Log Studio](https://github.com/abrignoni/crush-forensics/blob/main/crush/viewers/multi_log_viewer.py): `crush/viewers/multi_log_viewer.py`
- [Log database](https://github.com/abrignoni/crush-forensics/blob/main/crush/core/log_db.py): `crush/core/log_db.py`
- [BLOB inspector](https://github.com/abrignoni/crush-forensics/blob/main/crush/viewers/blob_inspector.py): `crush/viewers/blob_inspector.py`
- [Value inspector](https://github.com/abrignoni/crush-forensics/blob/main/crush/viewers/value_inspector.py): `crush/viewers/value_inspector.py`
- **Peach viewer**

### Other components

- **Investigator**

## Connections

- Investigator → Main window: opens evidence
- Main window → Case session: manages case (evidence: `crush/ui/main_window.py`)
- Case session → Virtual filesystem: opens sources (evidence: `crush/core/session.py`)
- Main window → Filesystem panel: shows files (evidence: `crush/ui/main_window.py`)
- Filesystem panel → Virtual filesystem: browses tree (evidence: `crush/ui/fs_panel.py`)
- Filesystem panel → Format database: identifies formats (evidence: `crush/ui/fs_panel.py`)
- Format database → Magic detection: checks magic bytes (evidence: `crush/core/format_db.py`)
- Main window → Parser registry: selects parser (evidence: `crush/ui/main_window.py`)
- Parser registry → Parser interface: registers parsers (evidence: `crush/core/registry.py`)
- SQLite parser → Virtual filesystem: reads evidence (evidence: `crush/parsers/sqlite_parser.py`)
- Realm parser → Virtual filesystem: reads evidence (evidence: `crush/parsers/realm_parser.py`)
- SEGB parser → Virtual filesystem: reads evidence (evidence: `crush/parsers/segb_parser.py`)
- Log parsers → Virtual filesystem: reads evidence (evidence: `crush/parsers/log_parser.py`)
- Unified log parser → Virtual filesystem: reads evidence (evidence: `crush/parsers/unified_log_parser.py`)
- Main window → Database viewer: opens parsed tables (evidence: `crush/ui/main_window.py`)
- Main window → Hex viewer: opens parsed data (evidence: `crush/ui/main_window.py`)
- Main window → Multi-Log Studio: opens log analysis (evidence: `crush/ui/main_window.py`)
- Multi-Log Studio → Log database: stores log entries (evidence: `crush/viewers/multi_log_viewer.py`)
- Multi-Log Studio → Unified log parser: parses unified logs (evidence: `crush/viewers/multi_log_viewer.py`)
- Multi-Log Studio → Log parsers: parses log sources (evidence: `crush/viewers/multi_log_viewer.py`)
- Database viewer → BLOB inspector: inspects BLOBs (evidence: `crush/viewers/table_viewer.py`)
- Investigator → Value inspector: interprets values
- Investigator → Peach viewer: sends log source
