# furkankirat/grepdesk architecture

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

- Interactive diagram: https://gitdiagram.com/furkankirat/grepdesk
- Repository: https://github.com/furkankirat/grepdesk

## Overview

Grepdesk is a cross-platform desktop file manager focused on fast search, disk analysis, cleanup, organization, and bulk file jobs. The main user workflow starts in the browser or search UI, scans and filters files (including file contents), then previews or opens results. Separate feature branches analyze disk use, reclaim space, organize folders, and run archive or transfer jobs. The graph combines README-documented product flows with relationships visible in sampled source and the source index; unsampled implementation details and call paths are not inferred.

Main entry points: [`Grepdesk.UI/Helpers/PlatformShellFactory.cs`](https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.UI/Helpers/PlatformShellFactory.cs) (Platform factory), [`Grepdesk.Core/Cleanup/CleanupAnalyzer.cs`](https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Core/Cleanup/CleanupAnalyzer.cs) (Cleanup analysis), [`Grepdesk.UI/App.axaml.cs`](https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.UI/App.axaml.cs) (Application startup), [`Grepdesk.UI/Browse/BrowseView.axaml.cs`](https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.UI/Browse/BrowseView.axaml.cs) (Folder browser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Desktop experience"]
  node_app["Application startup<br/>[App.axaml.cs]"]
  node_browser["Folder browser"]
  node_preview["Preview providers"]
  node_viewer["File viewer"]
end

subgraph group_discovery["File discovery"]
  node_search["File index<br/>[FileIndex.cs]"]
  node_contentsearch["Content search<br/>[ContentSearcher.cs]"]
  node_extractors["Format extractors"]
end

subgraph group_maintenance["Space and organization"]
  node_disk["Disk analysis<br/>[DiskAnalyzer.cs]"]
  node_cleanup["Cleanup analysis<br/>[CleanupAnalyzer.cs]"]
  node_duplicates["Duplicate detection<br/>[DuplicateFinder.cs]"]
  node_organize["Folder organization<br/>[FolderGrouper.cs]"]
end

subgraph group_jobs["File operations"]
  node_transfer["Copy and move<br/>[TransferEngine.cs]"]
  node_jobcontext["Job control<br/>[JobContext.cs]"]
  node_zip["Archive compression<br/>[ZipCompressor.cs]"]
  node_unzip["Archive extraction<br/>[ZipExtractor.cs]"]
end

subgraph group_platform["Platform services"]
  node_shellfactory["Platform factory"]
  node_shell["OS shell adapter<br/>[WindowsShell.cs]"]
  node_shellpreview["Shell previews"]
  node_integration["Explorer integration"]
end

node_user(("File user"))

node_user -->|"uses"| node_app
node_app -.->|"opens workspace"| node_browser
node_user -->|"searches files"| node_search
node_search -->|"searches contents"| node_contentsearch
node_contentsearch -->|"selects extractor"| node_extractors
node_user -->|"previews results"| node_preview
node_preview -->|"reuses extractors"| node_extractors
node_user -->|"opens file"| node_viewer
node_user -->|"scans drive"| node_disk
node_disk -->|"reuses scan"| node_cleanup
node_user -->|"reviews cleanup"| node_cleanup
node_cleanup -->|"finds duplicates"| node_duplicates
node_user -->|"organizes folder"| node_organize
node_user -->|"copies or moves"| node_transfer
node_transfer -->|"reports progress"| node_jobcontext
node_user -->|"compresses files"| node_zip
node_zip -->|"tracks job"| node_jobcontext
node_user -->|"extracts archive"| node_unzip
node_shellfactory -->|"creates adapter"| node_shell
node_shellfactory -->|"creates preview"| node_shellpreview
node_shellfactory -->|"creates integration"| node_integration
node_browser -.->|"uses platform services"| node_shellfactory

click node_app "https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.UI/App.axaml.cs"
click node_browser "https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.UI/Browse/BrowseView.axaml.cs"
click node_preview "https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.UI/Preview/PreviewProviders.cs"
click node_viewer "https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.UI/Viewer/FileViewerWindow.axaml.cs"
click node_search "https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Core/FileIndex.cs"
click node_contentsearch "https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Core/ContentSearch/ContentSearcher.cs"
click node_extractors "https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Core/ContentSearch/ExtractorRegistry.cs"
click node_disk "https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Core/DiskUsage/DiskAnalyzer.cs"
click node_cleanup "https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Core/Cleanup/CleanupAnalyzer.cs"
click node_duplicates "https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Core/Cleanup/DuplicateFinder.cs"
click node_organize "https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Core/Grouping/FolderGrouper.cs"
click node_transfer "https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Core/Transfer/TransferEngine.cs"
click node_jobcontext "https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Core/Jobs/JobContext.cs"
click node_zip "https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Core/Archive/ZipCompressor.cs"
click node_unzip "https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Core/Archive/ZipExtractor.cs"
click node_shellfactory "https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.UI/Helpers/PlatformShellFactory.cs"
click node_shell "https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Windows/WindowsShell.cs"
click node_shellpreview "https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Windows/WindowsShellPreview.cs"
click node_integration "https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Windows/WindowsShellIntegration.cs"

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_browser,node_preview,node_viewer,node_user toneBlue
class node_search,node_contentsearch,node_extractors toneAmber
class node_disk,node_cleanup,node_duplicates,node_organize toneMint
class node_transfer,node_jobcontext,node_zip,node_unzip toneRose
class node_shellfactory,node_shell,node_shellpreview,node_integration toneIndigo
```

## Components

### Desktop experience

- [Application startup](https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.UI/App.axaml.cs): `Grepdesk.UI/App.axaml.cs`
- [Folder browser](https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.UI/Browse/BrowseView.axaml.cs): `Grepdesk.UI/Browse/BrowseView.axaml.cs`
- [Preview providers](https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.UI/Preview/PreviewProviders.cs): `Grepdesk.UI/Preview/PreviewProviders.cs`
- [File viewer](https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.UI/Viewer/FileViewerWindow.axaml.cs): `Grepdesk.UI/Viewer/FileViewerWindow.axaml.cs`

### File discovery

- [File index](https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Core/FileIndex.cs): `Grepdesk.Core/FileIndex.cs`
- [Content search](https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Core/ContentSearch/ContentSearcher.cs): `Grepdesk.Core/ContentSearch/ContentSearcher.cs`
- [Format extractors](https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Core/ContentSearch/ExtractorRegistry.cs): `Grepdesk.Core/ContentSearch/ExtractorRegistry.cs`

### Space and organization

- [Disk analysis](https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Core/DiskUsage/DiskAnalyzer.cs): `Grepdesk.Core/DiskUsage/DiskAnalyzer.cs`
- [Cleanup analysis](https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Core/Cleanup/CleanupAnalyzer.cs): `Grepdesk.Core/Cleanup/CleanupAnalyzer.cs`
- [Duplicate detection](https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Core/Cleanup/DuplicateFinder.cs): `Grepdesk.Core/Cleanup/DuplicateFinder.cs`
- [Folder organization](https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Core/Grouping/FolderGrouper.cs): `Grepdesk.Core/Grouping/FolderGrouper.cs`

### File operations

- [Copy and move](https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Core/Transfer/TransferEngine.cs): `Grepdesk.Core/Transfer/TransferEngine.cs`
- [Job control](https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Core/Jobs/JobContext.cs): `Grepdesk.Core/Jobs/JobContext.cs`
- [Archive compression](https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Core/Archive/ZipCompressor.cs): `Grepdesk.Core/Archive/ZipCompressor.cs`
- [Archive extraction](https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Core/Archive/ZipExtractor.cs): `Grepdesk.Core/Archive/ZipExtractor.cs`

### Platform services

- [Platform factory](https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.UI/Helpers/PlatformShellFactory.cs): `Grepdesk.UI/Helpers/PlatformShellFactory.cs`
- [OS shell adapter](https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Windows/WindowsShell.cs): `Grepdesk.Windows/WindowsShell.cs`
- [Shell previews](https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Windows/WindowsShellPreview.cs): `Grepdesk.Windows/WindowsShellPreview.cs`
- [Explorer integration](https://github.com/furkankirat/grepdesk/blob/main/Grepdesk.Windows/WindowsShellIntegration.cs): `Grepdesk.Windows/WindowsShellIntegration.cs`

### Other components

- **File user**

## Connections

- File user → Application startup: uses (evidence: `README.md`)
- Application startup → Folder browser: opens workspace
- File user → File index: searches files (evidence: `README.md`)
- File index → Content search: searches contents (evidence: `README.md`)
- Content search → Format extractors: selects extractor (evidence: `Grepdesk.Core/ContentSearch/ExtractorRegistry.cs`)
- File user → Preview providers: previews results (evidence: `README.md`)
- Preview providers → Format extractors: reuses extractors (evidence: `Grepdesk.UI/Preview/PreviewProviders.cs`)
- File user → File viewer: opens file (evidence: `README.md`)
- File user → Disk analysis: scans drive (evidence: `README.md`)
- Disk analysis → Cleanup analysis: reuses scan (evidence: `README.md`)
- File user → Cleanup analysis: reviews cleanup (evidence: `README.md`)
- Cleanup analysis → Duplicate detection: finds duplicates (evidence: `Grepdesk.UI/Cleanup/CleanupView.axaml.cs`)
- File user → Folder organization: organizes folder (evidence: `README.md`)
- File user → Copy and move: copies or moves (evidence: `README.md`)
- Copy and move → Job control: reports progress (evidence: `Grepdesk.Core/Transfer/TransferEngine.cs`)
- File user → Archive compression: compresses files (evidence: `README.md`)
- Archive compression → Job control: tracks job (evidence: `Grepdesk.Core/Archive/ZipCompressor.cs`)
- File user → Archive extraction: extracts archive (evidence: `README.md`)
- Platform factory → OS shell adapter: creates adapter (evidence: `Grepdesk.UI/Helpers/PlatformShellFactory.cs`)
- Platform factory → Shell previews: creates preview (evidence: `Grepdesk.UI/Helpers/PlatformShellFactory.cs`)
- Platform factory → Explorer integration: creates integration (evidence: `Grepdesk.UI/Helpers/PlatformShellFactory.cs`)
- Folder browser → Platform factory: uses platform services
