# wenlar/gezik architecture

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

- Interactive diagram: https://gitdiagram.com/wenlar/gezik
- Repository: https://github.com/wenlar/gezik

## Overview

Gezik is a cross-platform desktop file manager. Users navigate folders, inspect and find files, then act on selections through file operations and batch tools; results appear in the listing, preview, or operation status. The graph also preserves the README’s major product branches: archives and conversion, search, configuration, tags, Git, and integrations for phones and network shares. The source excerpts show some UI-to-operation wiring, but not every subsystem’s implementation or connections, so uncertain links are omitted.

Main entry points: [`crates/gezik/src/windows.rs`](https://github.com/wenlar/gezik/blob/master/crates/gezik/src/windows.rs) (Windows and panes), [`crates/gezik-batch/src/tasks/mod.rs`](https://github.com/wenlar/gezik/blob/master/crates/gezik-batch/src/tasks/mod.rs) (Batch processing), [`crates/gezik/src/main.rs`](https://github.com/wenlar/gezik/blob/master/crates/gezik/src/main.rs) (Gezik app), [`crates/gezik-ops/src/engine.rs`](https://github.com/wenlar/gezik/blob/master/crates/gezik-ops/src/engine.rs) (Operation engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_app["Gezik app<br/>[main.rs]"]
  node_windows["Windows and panes<br/>[windows.rs]"]
end

subgraph group_files["Files and navigation"]
  node_listing["Folder listing<br/>[listing.rs]"]
  node_navigation["Navigation<br/>[navigation.rs]"]
  node_search["Search<br/>[run.rs]"]
  node_preview["Preview<br/>[viewer.rs]"]
  node_operation_ui["Operation controls<br/>[operations.rs]"]
  node_engine["Operation engine<br/>[engine.rs]"]
  node_tasks["File operation tasks<br/>[mod.rs]"]
end

subgraph group_tools["File tools"]
  node_batch_ui["Batch tools UI<br/>[archives.rs]"]
  node_batch_tasks["Batch processing<br/>[mod.rs]"]
  node_archives["Archive handling<br/>[mod.rs]"]
  node_conversion["Conversion<br/>[mod.rs]"]
end

subgraph group_support["Settings and integrations"]
  node_config["Configuration<br/>[settings.rs]"]
  node_tags["Tags<br/>[tags.rs]"]
  node_git["Git integration<br/>[git_commands.rs]"]
  node_phones["Phone access<br/>[phones.rs]"]
  node_network["Network browsing<br/>[network_places.rs]"]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_user -->|"browses"| node_navigation
node_user -->|"searches"| node_search
node_user -->|"inspects"| node_preview
node_user -->|"runs tools"| node_batch_ui
node_user -->|"configures"| node_config
node_user -->|"browses"| node_phones
node_user -->|"browses"| node_network
node_user -->|"manages"| node_tags
node_user -->|"uses"| node_git
node_app -.->|"opens"| node_windows
node_windows -.->|"displays"| node_listing
node_windows -.->|"hosts"| node_navigation
node_operation_ui -.->|"submits jobs"| node_engine
node_engine -->|"runs"| node_tasks
node_batch_ui -->|"starts jobs"| node_batch_tasks
node_batch_tasks -.->|"uses"| node_archives
node_batch_tasks -.->|"uses"| node_conversion

click node_app "https://github.com/wenlar/gezik/blob/master/crates/gezik/src/main.rs"
click node_windows "https://github.com/wenlar/gezik/blob/master/crates/gezik/src/windows.rs"
click node_listing "https://github.com/wenlar/gezik/blob/master/crates/gezik/src/view/listing.rs"
click node_navigation "https://github.com/wenlar/gezik/blob/master/crates/gezik/src/navigation.rs"
click node_search "https://github.com/wenlar/gezik/blob/master/crates/gezik-search/src/run.rs"
click node_preview "https://github.com/wenlar/gezik/blob/master/crates/gezik/src/preview/viewer.rs"
click node_operation_ui "https://github.com/wenlar/gezik/blob/master/crates/gezik/src/operations.rs"
click node_engine "https://github.com/wenlar/gezik/blob/master/crates/gezik-ops/src/engine.rs"
click node_tasks "https://github.com/wenlar/gezik/blob/master/crates/gezik-ops/src/tasks/mod.rs"
click node_batch_ui "https://github.com/wenlar/gezik/blob/master/crates/gezik/src/archives.rs"
click node_batch_tasks "https://github.com/wenlar/gezik/blob/master/crates/gezik-batch/src/tasks/mod.rs"
click node_archives "https://github.com/wenlar/gezik/blob/master/crates/gezik-batch/src/archive/mod.rs"
click node_conversion "https://github.com/wenlar/gezik/blob/master/crates/gezik-batch/src/convert/mod.rs"
click node_config "https://github.com/wenlar/gezik/blob/master/crates/gezik-config/src/settings.rs"
click node_tags "https://github.com/wenlar/gezik/blob/master/crates/gezik/src/tags.rs"
click node_git "https://github.com/wenlar/gezik/blob/master/crates/gezik/src/git_commands.rs"
click node_phones "https://github.com/wenlar/gezik/blob/master/crates/gezik/src/phones.rs"
click node_network "https://github.com/wenlar/gezik/blob/master/crates/gezik/src/network_places.rs"

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_app,node_windows,node_user toneBlue
class node_listing,node_navigation,node_search,node_preview,node_operation_ui,node_engine,node_tasks toneAmber
class node_batch_ui,node_batch_tasks,node_archives,node_conversion toneMint
class node_config,node_tags,node_git,node_phones,node_network toneRose
```

## Components

### Desktop interface

- [Gezik app](https://github.com/wenlar/gezik/blob/master/crates/gezik/src/main.rs): `crates/gezik/src/main.rs`
- [Windows and panes](https://github.com/wenlar/gezik/blob/master/crates/gezik/src/windows.rs): `crates/gezik/src/windows.rs`

### Files and navigation

- [Folder listing](https://github.com/wenlar/gezik/blob/master/crates/gezik/src/view/listing.rs): `crates/gezik/src/view/listing.rs`
- [Navigation](https://github.com/wenlar/gezik/blob/master/crates/gezik/src/navigation.rs): `crates/gezik/src/navigation.rs`
- [Search](https://github.com/wenlar/gezik/blob/master/crates/gezik-search/src/run.rs): `crates/gezik-search/src/run.rs`
- [Preview](https://github.com/wenlar/gezik/blob/master/crates/gezik/src/preview/viewer.rs): `crates/gezik/src/preview/viewer.rs`
- [Operation controls](https://github.com/wenlar/gezik/blob/master/crates/gezik/src/operations.rs): `crates/gezik/src/operations.rs`
- [Operation engine](https://github.com/wenlar/gezik/blob/master/crates/gezik-ops/src/engine.rs): `crates/gezik-ops/src/engine.rs`
- [File operation tasks](https://github.com/wenlar/gezik/blob/master/crates/gezik-ops/src/tasks/mod.rs): `crates/gezik-ops/src/tasks/mod.rs`

### File tools

- [Batch tools UI](https://github.com/wenlar/gezik/blob/master/crates/gezik/src/archives.rs): `crates/gezik/src/archives.rs`
- [Batch processing](https://github.com/wenlar/gezik/blob/master/crates/gezik-batch/src/tasks/mod.rs): `crates/gezik-batch/src/tasks/mod.rs`
- [Archive handling](https://github.com/wenlar/gezik/blob/master/crates/gezik-batch/src/archive/mod.rs): `crates/gezik-batch/src/archive/mod.rs`
- [Conversion](https://github.com/wenlar/gezik/blob/master/crates/gezik-batch/src/convert/mod.rs): `crates/gezik-batch/src/convert/mod.rs`

### Settings and integrations

- [Configuration](https://github.com/wenlar/gezik/blob/master/crates/gezik-config/src/settings.rs): `crates/gezik-config/src/settings.rs`
- [Tags](https://github.com/wenlar/gezik/blob/master/crates/gezik/src/tags.rs): `crates/gezik/src/tags.rs`
- [Git integration](https://github.com/wenlar/gezik/blob/master/crates/gezik/src/git_commands.rs): `crates/gezik/src/git_commands.rs`
- [Phone access](https://github.com/wenlar/gezik/blob/master/crates/gezik/src/phones.rs): `crates/gezik/src/phones.rs`
- [Network browsing](https://github.com/wenlar/gezik/blob/master/crates/gezik/src/network_places.rs): `crates/gezik/src/network_places.rs`

### Other components

- **User**

## Connections

- User → Gezik app: uses
- User → Navigation: browses
- User → Search: searches
- User → Preview: inspects
- User → Batch tools UI: runs tools
- User → Configuration: configures
- User → Phone access: browses
- User → Network browsing: browses
- User → Tags: manages
- User → Git integration: uses
- Gezik app → Windows and panes: opens
- Windows and panes → Folder listing: displays
- Windows and panes → Navigation: hosts (evidence: `crates/gezik/src/windows.rs`)
- Operation controls → Operation engine: submits jobs
- Operation engine → File operation tasks: runs (evidence: `crates/gezik-ops/src/engine.rs`)
- Batch tools UI → Batch processing: starts jobs (evidence: `crates/gezik/src/archives.rs`)
- Batch processing → Archive handling: uses
- Batch processing → Conversion: uses
