# kaigermany/opendiskdiver architecture

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

- Interactive diagram: https://gitdiagram.com/kaigermany/opendiskdiver
- Repository: https://github.com/kaigermany/opendiskdiver

## Overview

OpenDiskDiver is an early-stage drive inspection and recovery toolbox. Users select a physical drive or disk image, inspect sectors and partitions, identify a filesystem, and browse files; other main workflows compare sources or copy a drive to an image or ZIP dump. The graph preserves the documented FAT/ExFAT and NTFS readers, partition inspection, raw-sector viewing, and recovery scanners. Several connections are supported only by README capability statements or the SOURCE INDEX; unsampled internals are not inferred beyond those links.

Main entry points: [`src/main/java/me/kaigermany/opendiskdiver/Main.java`](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/Main.java) (Operation coordinator), [`src/main/java/me/kaigermany/opendiskdiver/gui/UI.java`](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/gui/UI.java) (Interactive UI), [`src/main/java/me/kaigermany/opendiskdiver/datafilesystem/FileSystem.java`](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/datafilesystem/FileSystem.java) (Filesystem model), [`src/main/java/me/kaigermany/opendiskdiver/probe/Probe.java`](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/probe/Probe.java) (Filesystem detection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_input["Source and interface"]
  node_ui["Interactive UI<br/>[UI.java]"]
  node_drive_source["Drive sources"]
  node_readable["Readable source"]
  node_image_zip["Image and ZIP input"]
  node_main["Operation coordinator<br/>[Main.java]"]
end

subgraph group_inspect["Disk inspection"]
  node_sector_view["Raw-sector viewer<br/>[Main.java]"]
  node_partition_reader["Partition table reader"]
  node_partition["Partition model<br/>[Partition.java]"]
  node_probe["Filesystem detection<br/>[Probe.java]"]
end

subgraph group_filesystems["Filesystem readers"]
  node_reader_contract["Reader contract<br/>[Reader.java]"]
  node_fat["FAT and ExFAT<br/>[FatReader.java]"]
  node_ntfs["NTFS reader<br/>[NtfsReader.java]"]
  node_file_system["Filesystem model<br/>[FileSystem.java]"]
  node_file_entry["File entries<br/>[FileEntry.java]"]
  node_browser["File browser"]
end

subgraph group_recovery["Recovery operations"]
  node_scanners["Recovery scanners<br/>[Scanner.java]"]
end

subgraph group_output["Copy and comparison"]
  node_copy["Disk copy workflow<br/>[CopyFunction.java]"]
  node_copy_state["Copy progress<br/>[DiskCopyState.java]"]
  node_writers["Dump writers<br/>[Writer.java]"]
  node_multipart_zip["Split ZIP writer"]
  node_compare["Source comparison"]
end

node_user(("Operator"))

node_user -->|"chooses operations"| node_ui
node_ui -->|"lists drives"| node_drive_source
node_ui -->|"opens images"| node_image_zip
node_ui -->|"starts workflow"| node_main
node_main -->|"selects source"| node_readable
node_main -->|"shows sectors"| node_sector_view
node_main -->|"reads partitions"| node_partition_reader
node_partition_reader -->|"returns partitions"| node_partition
node_main -->|"detects filesystem"| node_probe
node_probe -->|"selects FAT reader"| node_fat
node_probe -->|"selects NTFS reader"| node_ntfs
node_fat -->|"implements"| node_reader_contract
node_ntfs -->|"implements"| node_reader_contract
node_main -->|"opens filesystem"| node_file_system
node_fat -->|"builds filesystem"| node_file_system
node_ntfs -->|"builds filesystem"| node_file_system
node_file_system -->|"exposes entries"| node_file_entry
node_main -->|"browses files"| node_browser
node_browser -->|"displays entries"| node_file_entry
node_main -->|"runs analysis"| node_scanners
node_main -->|"starts disk copy"| node_copy
node_copy -->|"selects writer"| node_writers
node_copy -->|"updates progress"| node_copy_state
node_writers -->|"includes split ZIP"| node_multipart_zip
node_main -->|"compares sources"| node_compare
node_compare -->|"reads both sources"| node_readable

click node_ui "https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/gui/UI.java"
click node_drive_source "https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/DriveListProvider.java"
click node_readable "https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/reader/ReadableSource.java"
click node_image_zip "https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/reader/ImageFileReader.java"
click node_main "https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/Main.java"
click node_sector_view "https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/Main.java"
click node_partition_reader "https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/data/partition/PartitionReader.java"
click node_partition "https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/data/partition/Partition.java"
click node_probe "https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/probe/Probe.java"
click node_reader_contract "https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/data/Reader.java"
click node_fat "https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/data/fat/FatReader.java"
click node_ntfs "https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/data/ntfs/NtfsReader.java"
click node_file_system "https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/datafilesystem/FileSystem.java"
click node_file_entry "https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/datafilesystem/FileEntry.java"
click node_browser "https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/gui/FileSystemBrowser.java"
click node_scanners "https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/analysis/Scanner.java"
click node_copy "https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/functions/CopyFunction.java"
click node_copy_state "https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/gui/DiskCopyState.java"
click node_writers "https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/writer/Writer.java"
click node_multipart_zip "https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/writer/MultipartZipFileWriter.java"
click node_compare "https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/functions/CompareFunction.java"

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_ui,node_drive_source,node_readable,node_image_zip,node_main toneBlue
class node_sector_view,node_partition_reader,node_partition,node_probe toneAmber
class node_reader_contract,node_fat,node_ntfs,node_file_system,node_file_entry,node_browser toneMint
class node_scanners toneRose
class node_copy,node_copy_state,node_writers,node_multipart_zip,node_compare,node_user toneIndigo
```

## Components

### Source and interface

- [Interactive UI](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/gui/UI.java): `src/main/java/me/kaigermany/opendiskdiver/gui/UI.java`
- [Drive sources](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/DriveListProvider.java): `src/main/java/me/kaigermany/opendiskdiver/DriveListProvider.java`
- [Readable source](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/reader/ReadableSource.java): `src/main/java/me/kaigermany/opendiskdiver/reader/ReadableSource.java`
- [Image and ZIP input](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/reader/ImageFileReader.java): `src/main/java/me/kaigermany/opendiskdiver/reader/ImageFileReader.java`
- [Operation coordinator](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/Main.java): `src/main/java/me/kaigermany/opendiskdiver/Main.java`

### Disk inspection

- [Raw-sector viewer](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/Main.java): `src/main/java/me/kaigermany/opendiskdiver/Main.java`
- [Partition table reader](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/data/partition/PartitionReader.java): `src/main/java/me/kaigermany/opendiskdiver/data/partition/PartitionReader.java`
- [Partition model](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/data/partition/Partition.java): `src/main/java/me/kaigermany/opendiskdiver/data/partition/Partition.java`
- [Filesystem detection](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/probe/Probe.java): `src/main/java/me/kaigermany/opendiskdiver/probe/Probe.java`

### Filesystem readers

- [Reader contract](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/data/Reader.java): `src/main/java/me/kaigermany/opendiskdiver/data/Reader.java`
- [FAT and ExFAT](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/data/fat/FatReader.java): `src/main/java/me/kaigermany/opendiskdiver/data/fat/FatReader.java`
- [NTFS reader](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/data/ntfs/NtfsReader.java): `src/main/java/me/kaigermany/opendiskdiver/data/ntfs/NtfsReader.java`
- [Filesystem model](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/datafilesystem/FileSystem.java): `src/main/java/me/kaigermany/opendiskdiver/datafilesystem/FileSystem.java`
- [File entries](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/datafilesystem/FileEntry.java): `src/main/java/me/kaigermany/opendiskdiver/datafilesystem/FileEntry.java`
- [File browser](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/gui/FileSystemBrowser.java): `src/main/java/me/kaigermany/opendiskdiver/gui/FileSystemBrowser.java`

### Recovery operations

- [Recovery scanners](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/analysis/Scanner.java): `src/main/java/me/kaigermany/opendiskdiver/analysis/Scanner.java`

### Copy and comparison

- [Disk copy workflow](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/functions/CopyFunction.java): `src/main/java/me/kaigermany/opendiskdiver/functions/CopyFunction.java`
- [Copy progress](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/gui/DiskCopyState.java): `src/main/java/me/kaigermany/opendiskdiver/gui/DiskCopyState.java`
- [Dump writers](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/writer/Writer.java): `src/main/java/me/kaigermany/opendiskdiver/writer/Writer.java`
- [Split ZIP writer](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/writer/MultipartZipFileWriter.java): `src/main/java/me/kaigermany/opendiskdiver/writer/MultipartZipFileWriter.java`
- [Source comparison](https://github.com/kaigermany/opendiskdiver/blob/main/src/main/java/me/kaigermany/opendiskdiver/functions/CompareFunction.java): `src/main/java/me/kaigermany/opendiskdiver/functions/CompareFunction.java`

### Other components

- **Operator**

## Connections

- Operator → Interactive UI: chooses operations
- Interactive UI → Drive sources: lists drives
- Interactive UI → Image and ZIP input: opens images
- Interactive UI → Operation coordinator: starts workflow (evidence: `src/main/java/me/kaigermany/opendiskdiver/Main.java`)
- Operation coordinator → Readable source: selects source (evidence: `src/main/java/me/kaigermany/opendiskdiver/Main.java`)
- Operation coordinator → Raw-sector viewer: shows sectors (evidence: `src/main/java/me/kaigermany/opendiskdiver/Main.java`)
- Operation coordinator → Partition table reader: reads partitions (evidence: `src/main/java/me/kaigermany/opendiskdiver/Main.java`)
- Partition table reader → Partition model: returns partitions (evidence: `src/main/java/me/kaigermany/opendiskdiver/data/partition/PartitionReader.java`)
- Operation coordinator → Filesystem detection: detects filesystem (evidence: `src/main/java/me/kaigermany/opendiskdiver/Main.java`)
- Filesystem detection → FAT and ExFAT: selects FAT reader (evidence: `src/main/java/me/kaigermany/opendiskdiver/probe/Probe.java`)
- Filesystem detection → NTFS reader: selects NTFS reader (evidence: `src/main/java/me/kaigermany/opendiskdiver/probe/Probe.java`)
- FAT and ExFAT → Reader contract: implements (evidence: `src/main/java/me/kaigermany/opendiskdiver/data/fat/FatReader.java`)
- NTFS reader → Reader contract: implements (evidence: `src/main/java/me/kaigermany/opendiskdiver/data/ntfs/NtfsReader.java`)
- Operation coordinator → Filesystem model: opens filesystem (evidence: `src/main/java/me/kaigermany/opendiskdiver/Main.java`)
- FAT and ExFAT → Filesystem model: builds filesystem (evidence: `src/main/java/me/kaigermany/opendiskdiver/data/fat/FatReader.java`)
- NTFS reader → Filesystem model: builds filesystem (evidence: `src/main/java/me/kaigermany/opendiskdiver/data/ntfs/NtfsReader.java`)
- Filesystem model → File entries: exposes entries (evidence: `src/main/java/me/kaigermany/opendiskdiver/data/fat/FatReader.java`)
- Operation coordinator → File browser: browses files (evidence: `src/main/java/me/kaigermany/opendiskdiver/Main.java`)
- File browser → File entries: displays entries (evidence: `src/main/java/me/kaigermany/opendiskdiver/gui/FileSystemBrowser.java`)
- Operation coordinator → Recovery scanners: runs analysis (evidence: `src/main/java/me/kaigermany/opendiskdiver/Main.java`)
- Operation coordinator → Disk copy workflow: starts disk copy (evidence: `src/main/java/me/kaigermany/opendiskdiver/Main.java`)
- Disk copy workflow → Dump writers: selects writer (evidence: `src/main/java/me/kaigermany/opendiskdiver/functions/CopyFunction.java`)
- Disk copy workflow → Copy progress: updates progress (evidence: `src/main/java/me/kaigermany/opendiskdiver/functions/CopyFunction.java`)
- Dump writers → Split ZIP writer: includes split ZIP (evidence: `src/main/java/me/kaigermany/opendiskdiver/functions/CopyFunction.java`)
- Operation coordinator → Source comparison: compares sources (evidence: `src/main/java/me/kaigermany/opendiskdiver/Main.java`)
- Source comparison → Readable source: reads both sources (evidence: `src/main/java/me/kaigermany/opendiskdiver/functions/CompareFunction.java`)
