# znso4pa/usefulunpack architecture

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

- Interactive diagram: https://gitdiagram.com/znso4pa/usefulunpack
- Repository: https://github.com/znso4pa/usefulunpack

## Overview

UsefulUnpack is an Android file manager with archive browsing, extraction, compression, and format-specific tools. The main workflow is to browse files, open an archive preview, select entries, then extract them; the preview flow dispatches format-specific archive operations. Other documented capabilities include batch operations, global search, file preview/editing, and signature scanning. Several subsystem links are documented in the README or visible in indexed references; unsampled implementation details are represented at their existing directory paths, with uncertain wiring omitted.

Main entry points: [`app/src/main/java/com/usefulunpacker/extract/PreviewFlow.kt`](https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/extract/PreviewFlow.kt) (Archive Preview Flow), [`crates`](https://github.com/znso4pa/usefulunpack/tree/main/crates) (Rust Format Engines), [`app/src/main/java/com/usefulunpacker/browse/FolderFragment.kt`](https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/browse/FolderFragment.kt) (File Browser), [`app/src/main/java/com/usefulunpacker/MainActivity.kt`](https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/MainActivity.kt) (Main Activity)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["File Navigation"]
  node_activity["Main Activity<br/>[MainActivity.kt]"]
  node_browser["File Browser<br/>[FolderFragment.kt]"]
  node_tabstate["Window State<br/>[TabState.kt]"]
  node_bookmarks[("Bookmarks<br/>[Bookmarks.kt]")]
end

subgraph group_archives["Archive Workflows"]
  node_previewflow["Archive Preview Flow<br/>[PreviewFlow.kt]"]
  node_entries["Archive Entries<br/>[ArchiveEntry.kt]"]
  node_extractor["Archive Extraction"]
  node_batch["Batch Operations"]
  node_compression["Compression"]
  node_registry[("Open Archive Registry")]
end

subgraph group_formats["Format Engines"]
  node_zip["ZIP Engine Bridge<br/>[ZipCore.kt]"]
  node_rar["RAR Engine Bridge<br/>[RarCore.kt]"]
  node_rgss["RGSS Engine Bridge<br/>[RgssCore.kt]"]
  node_sevenzip["7z Engine Bridge<br/>[SevenZCore.kt]"]
  node_xp3["XP3 Engine Bridge<br/>[Xp3Core.kt]"]
  node_rustengines["Rust Format Engines"]
end

subgraph group_tools["File Tools"]
  node_search["Global Search<br/>[GlobalSearch.kt]"]
  node_fileops["File Operations<br/>[FileOperations.kt]"]
  node_recycle[("Recycle Bin<br/>[RecycleBin.kt]")]
  node_signature["Signature Scan<br/>[SignatureScan.kt]"]
end

subgraph group_presentation["Preview and UI"]
  node_previewadapter["Preview List<br/>[PreviewAdapter.kt]"]
  node_filepreview["File Preview and Edit<br/>[PreviewDialogs.kt]"]
  node_scrollbar["Draggable Scrollbar<br/>[DragScrollBar.kt]"]
end

node_user(("User"))

node_user -->|"opens app"| node_activity
node_activity -->|"hosts windows"| node_browser
node_browser -->|"uses state"| node_tabstate
node_user -->|"browses files"| node_browser
node_browser -->|"opens preview"| node_previewflow
node_previewflow -->|"builds entries"| node_entries
node_previewflow -->|"renders entries"| node_previewadapter
node_previewflow -->|"registers archive"| node_registry
node_previewflow -->|"dispatches ZIP"| node_zip
node_previewflow -->|"dispatches RAR"| node_rar
node_previewflow -->|"dispatches RGSS"| node_rgss
node_previewflow -->|"dispatches 7z"| node_sevenzip
node_previewflow -->|"dispatches XP3"| node_xp3
node_user -->|"extracts entries"| node_extractor
node_user -->|"runs batch tasks"| node_batch
node_user -->|"packs archives"| node_compression
node_user -->|"searches files"| node_search
node_user -->|"previews files"| node_filepreview
node_user -->|"manages files"| node_fileops
node_fileops -.->|"uses recycle bin"| node_recycle
node_user -->|"scans signatures"| node_signature
node_rustengines -.->|"backs format bridge"| node_zip
node_rustengines -.->|"backs format bridge"| node_rar
node_rustengines -.->|"backs format bridge"| node_rgss
node_rustengines -.->|"backs format bridge"| node_sevenzip
node_rustengines -.->|"backs format bridge"| node_xp3
node_filepreview -->|"attaches scrollbar"| node_scrollbar

click node_activity "https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/MainActivity.kt"
click node_browser "https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/browse/FolderFragment.kt"
click node_tabstate "https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/browse/TabState.kt"
click node_bookmarks "https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/bookmarks/Bookmarks.kt"
click node_previewflow "https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/extract/PreviewFlow.kt"
click node_entries "https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/model/ArchiveEntry.kt"
click node_previewadapter "https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/adapter/PreviewAdapter.kt"
click node_extractor "https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/archive/ArchiveExtractor.kt"
click node_batch "https://github.com/znso4pa/usefulunpack/tree/main/app/src/main/java/com/usefulunpacker/batch"
click node_compression "https://github.com/znso4pa/usefulunpack/tree/main/app/src/main/java/com/usefulunpacker/compression"
click node_registry "https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/archive/OpenArchiveRegistry.kt"
click node_zip "https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/ZipCore.kt"
click node_rar "https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/RarCore.kt"
click node_rgss "https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/RgssCore.kt"
click node_sevenzip "https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/SevenZCore.kt"
click node_xp3 "https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/Xp3Core.kt"
click node_rustengines "https://github.com/znso4pa/usefulunpack/tree/main/crates"
click node_search "https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/search/GlobalSearch.kt"
click node_fileops "https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/fileops/FileOperations.kt"
click node_recycle "https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/fileops/RecycleBin.kt"
click node_signature "https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/fileops/SignatureScan.kt"
click node_filepreview "https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/ui/PreviewDialogs.kt"
click node_scrollbar "https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/ui/DragScrollBar.kt"

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_activity,node_browser,node_tabstate,node_bookmarks,node_user toneBlue
class node_previewflow,node_entries,node_extractor,node_batch,node_compression,node_registry toneAmber
class node_zip,node_rar,node_rgss,node_sevenzip,node_xp3,node_rustengines toneMint
class node_search,node_fileops,node_recycle,node_signature toneRose
class node_previewadapter,node_filepreview,node_scrollbar toneIndigo
```

## Components

### File Navigation

- [Main Activity](https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/MainActivity.kt): `app/src/main/java/com/usefulunpacker/MainActivity.kt`
- [File Browser](https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/browse/FolderFragment.kt): `app/src/main/java/com/usefulunpacker/browse/FolderFragment.kt`
- [Window State](https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/browse/TabState.kt): `app/src/main/java/com/usefulunpacker/browse/TabState.kt`
- [Bookmarks](https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/bookmarks/Bookmarks.kt): `app/src/main/java/com/usefulunpacker/bookmarks/Bookmarks.kt`

### Archive Workflows

- [Archive Preview Flow](https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/extract/PreviewFlow.kt): `app/src/main/java/com/usefulunpacker/extract/PreviewFlow.kt`
- [Archive Entries](https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/model/ArchiveEntry.kt): `app/src/main/java/com/usefulunpacker/model/ArchiveEntry.kt`
- [Archive Extraction](https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/archive/ArchiveExtractor.kt): `app/src/main/java/com/usefulunpacker/archive/ArchiveExtractor.kt`
- [Batch Operations](https://github.com/znso4pa/usefulunpack/tree/main/app/src/main/java/com/usefulunpacker/batch): `app/src/main/java/com/usefulunpacker/batch`
- [Compression](https://github.com/znso4pa/usefulunpack/tree/main/app/src/main/java/com/usefulunpacker/compression): `app/src/main/java/com/usefulunpacker/compression`
- [Open Archive Registry](https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/archive/OpenArchiveRegistry.kt): `app/src/main/java/com/usefulunpacker/archive/OpenArchiveRegistry.kt`

### Format Engines

- [ZIP Engine Bridge](https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/ZipCore.kt): `app/src/main/java/com/usefulunpacker/ZipCore.kt`
- [RAR Engine Bridge](https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/RarCore.kt): `app/src/main/java/com/usefulunpacker/RarCore.kt`
- [RGSS Engine Bridge](https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/RgssCore.kt): `app/src/main/java/com/usefulunpacker/RgssCore.kt`
- [7z Engine Bridge](https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/SevenZCore.kt): `app/src/main/java/com/usefulunpacker/SevenZCore.kt`
- [XP3 Engine Bridge](https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/Xp3Core.kt): `app/src/main/java/com/usefulunpacker/Xp3Core.kt`
- [Rust Format Engines](https://github.com/znso4pa/usefulunpack/tree/main/crates): `crates`

### File Tools

- [Global Search](https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/search/GlobalSearch.kt): `app/src/main/java/com/usefulunpacker/search/GlobalSearch.kt`
- [File Operations](https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/fileops/FileOperations.kt): `app/src/main/java/com/usefulunpacker/fileops/FileOperations.kt`
- [Recycle Bin](https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/fileops/RecycleBin.kt): `app/src/main/java/com/usefulunpacker/fileops/RecycleBin.kt`
- [Signature Scan](https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/fileops/SignatureScan.kt): `app/src/main/java/com/usefulunpacker/fileops/SignatureScan.kt`

### Preview and UI

- [Preview List](https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/adapter/PreviewAdapter.kt): `app/src/main/java/com/usefulunpacker/adapter/PreviewAdapter.kt`
- [File Preview and Edit](https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/ui/PreviewDialogs.kt): `app/src/main/java/com/usefulunpacker/ui/PreviewDialogs.kt`
- [Draggable Scrollbar](https://github.com/znso4pa/usefulunpack/blob/main/app/src/main/java/com/usefulunpacker/ui/DragScrollBar.kt): `app/src/main/java/com/usefulunpacker/ui/DragScrollBar.kt`

### Other components

- **User**

## Connections

- User → Main Activity: opens app (evidence: `README.md`)
- Main Activity → File Browser: hosts windows (evidence: `app/src/main/java/com/usefulunpacker/MainActivity.kt`)
- File Browser → Window State: uses state (evidence: `app/src/main/java/com/usefulunpacker/browse/FolderFragment.kt`)
- User → File Browser: browses files (evidence: `README.md`)
- File Browser → Archive Preview Flow: opens preview (evidence: `README.md`)
- Archive Preview Flow → Archive Entries: builds entries (evidence: `app/src/main/java/com/usefulunpacker/extract/PreviewFlow.kt`)
- Archive Preview Flow → Preview List: renders entries (evidence: `app/src/main/java/com/usefulunpacker/extract/PreviewFlow.kt`)
- Archive Preview Flow → Open Archive Registry: registers archive (evidence: `app/src/main/java/com/usefulunpacker/extract/PreviewFlow.kt`)
- Archive Preview Flow → ZIP Engine Bridge: dispatches ZIP (evidence: `app/src/main/java/com/usefulunpacker/extract/PreviewFlow.kt`)
- Archive Preview Flow → RAR Engine Bridge: dispatches RAR (evidence: `app/src/main/java/com/usefulunpacker/extract/PreviewFlow.kt`)
- Archive Preview Flow → RGSS Engine Bridge: dispatches RGSS (evidence: `app/src/main/java/com/usefulunpacker/extract/PreviewFlow.kt`)
- Archive Preview Flow → 7z Engine Bridge: dispatches 7z (evidence: `app/src/main/java/com/usefulunpacker/extract/PreviewFlow.kt`)
- Archive Preview Flow → XP3 Engine Bridge: dispatches XP3 (evidence: `app/src/main/java/com/usefulunpacker/extract/PreviewFlow.kt`)
- User → Archive Extraction: extracts entries (evidence: `README.md`)
- User → Batch Operations: runs batch tasks (evidence: `README.md`)
- User → Compression: packs archives (evidence: `README.md`)
- User → Global Search: searches files (evidence: `README.md`)
- User → File Preview and Edit: previews files (evidence: `README.md`)
- User → File Operations: manages files (evidence: `README.md`)
- File Operations → Recycle Bin: uses recycle bin
- User → Signature Scan: scans signatures (evidence: `README.md`)
- Rust Format Engines → ZIP Engine Bridge: backs format bridge
- Rust Format Engines → RAR Engine Bridge: backs format bridge
- Rust Format Engines → RGSS Engine Bridge: backs format bridge
- Rust Format Engines → 7z Engine Bridge: backs format bridge
- Rust Format Engines → XP3 Engine Bridge: backs format bridge
- File Preview and Edit → Draggable Scrollbar: attaches scrollbar (evidence: `app/src/main/java/com/usefulunpacker/ui/PreviewDialogs.kt`)
