# dimzol/mandarin architecture

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

- Interactive diagram: https://gitdiagram.com/dimzol/mandarin
- Repository: https://github.com/dimzol/mandarin

## Overview

Mandarin is an offline desktop file converter and toolbox. The main workflow is to drag files, invoke the gesture wheel, choose a format or tool, and receive a newly named result without modifying the original. The graph also covers click-based file selection, file actions, settings and platform-specific gesture support. Conversion dispatch and several engine dependencies are visible in the supplied excerpts or SOURCE INDEX; unsampled tool and engine internals are represented by their exact source paths, with uncertain connections omitted.

Main entry points: [`src/Mandarin/Core/Formats.cs`](https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Core/Formats.cs) (Format dispatch), [`src/Mandarin.Cross/UI/HomeWindow.cs`](https://github.com/dimzol/mandarin/blob/main/src/Mandarin.Cross/UI/HomeWindow.cs) (Home window), [`src/Mandarin/Engines/ImageEngine.cs`](https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Engines/ImageEngine.cs) (Image engine), [`src/Mandarin/Core/OutputPaths.cs`](https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Core/OutputPaths.cs) (Output naming)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App and interaction"]
  node_app["App startup<br/>[App.cs]"]
  node_home["Home window<br/>[HomeWindow.cs]"]
  node_gesture["Drag gesture<br/>[DragGesture.cs]"]
  node_wheel["Format and tool wheel<br/>[WheelWindow.cs]"]
end

subgraph group_conversion["Conversion pipeline"]
  node_filekinds["File classification<br/>[FileKinds.cs]"]
  node_formats["Format dispatch<br/>[Formats.cs]"]
  node_jobs["Conversion jobs<br/>[Jobs.cs]"]
  node_outputs["Output naming<br/>[OutputPaths.cs]"]
  node_image["Image engine<br/>[ImageEngine.cs]"]
  node_media["Media engine<br/>[MediaEngine.cs]"]
  node_ffmpeg["FFmpeg runner<br/>[Ffmpeg.cs]"]
  node_pdf["PDF engine<br/>[PdfEngine.cs]"]
  node_office["Office engine<br/>[OfficeEngine.cs]"]
  node_html["HTML and text<br/>[HtmlEngine.cs]"]
  node_archive["Archive engine<br/>[ArchiveEngine.cs]"]
  node_otherengines["Other format engines"]
end

subgraph group_tools["Editing tools"]
  node_toolui["Tool windows<br/>[Tools]"]
  node_imagetools["Image tools<br/>[ImageTools.cs]"]
  node_mediaeditors["Media editors<br/>[MediaEditors.cs]"]
  node_actions["File actions<br/>[FileActions.cs]"]
end

subgraph group_platform["Platform and settings"]
  node_settings[("Application settings<br/>[AppSettings.cs]")]
  node_desktop["Desktop integration<br/>[Desktop.cs]"]
  node_gestureplatform["Platform gesture input<br/>[Gesture.cs]"]
end

node_user(("User"))
node_ffmpegservice["FFmpeg executable"]

node_user -->|"starts drag"| node_gesture
node_gesture -.->|"opens wheel"| node_wheel
node_user -->|"drops or selects"| node_home
node_home -->|"requests conversion"| node_formats
node_wheel -->|"chooses format"| node_formats
node_formats -->|"classifies files"| node_filekinds
node_formats -->|"starts batch"| node_jobs
node_formats -->|"dispatches image"| node_image
node_formats -->|"dispatches media"| node_media
node_formats -->|"dispatches PDF"| node_pdf
node_formats -->|"dispatches office"| node_office
node_formats -->|"dispatches archive"| node_archive
node_formats -->|"dispatches formats"| node_otherengines
node_image -->|"creates image PDF"| node_pdf
node_media -->|"runs media tasks"| node_ffmpeg
node_ffmpeg -->|"invokes"| node_ffmpegservice
node_image -->|"reserves results"| node_outputs
node_pdf -->|"names results"| node_outputs
node_office -->|"names results"| node_outputs
node_archive -->|"names results"| node_outputs
node_wheel -->|"opens tools"| node_toolui
node_toolui -.->|"hosts image tools"| node_imagetools
node_toolui -.->|"hosts media tools"| node_mediaeditors
node_imagetools -->|"uses image engine"| node_image
node_mediaeditors -->|"uses media engine"| node_media
node_home -.->|"offers file actions"| node_actions
node_app -->|"loads settings"| node_settings
node_app -->|"shows window"| node_home
node_app -->|"initializes integration"| node_desktop
node_gestureplatform -.->|"supports input"| node_gesture

click node_app "https://github.com/dimzol/mandarin/blob/main/src/Mandarin.Cross/App.cs"
click node_home "https://github.com/dimzol/mandarin/blob/main/src/Mandarin.Cross/UI/HomeWindow.cs"
click node_gesture "https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Interop/DragGesture.cs"
click node_wheel "https://github.com/dimzol/mandarin/blob/main/src/Mandarin.Cross/UI/WheelWindow.cs"
click node_filekinds "https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Core/FileKinds.cs"
click node_formats "https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Core/Formats.cs"
click node_jobs "https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Core/Jobs.cs"
click node_outputs "https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Core/OutputPaths.cs"
click node_image "https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Engines/ImageEngine.cs"
click node_media "https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Engines/MediaEngine.cs"
click node_ffmpeg "https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Engines/Ffmpeg.cs"
click node_pdf "https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Engines/PdfEngine.cs"
click node_office "https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Engines/OfficeEngine.cs"
click node_html "https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Engines/HtmlEngine.cs"
click node_archive "https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Engines/ArchiveEngine.cs"
click node_otherengines "https://github.com/dimzol/mandarin/tree/main/src/Mandarin/Engines"
click node_toolui "https://github.com/dimzol/mandarin/tree/main/src/Mandarin.Cross/UI/Tools"
click node_imagetools "https://github.com/dimzol/mandarin/blob/main/src/Mandarin.Cross/UI/Tools/ImageTools.cs"
click node_mediaeditors "https://github.com/dimzol/mandarin/blob/main/src/Mandarin.Cross/UI/Tools/MediaEditors.cs"
click node_actions "https://github.com/dimzol/mandarin/blob/main/src/Mandarin.Cross/UI/FileActions.cs"
click node_settings "https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Core/AppSettings.cs"
click node_desktop "https://github.com/dimzol/mandarin/blob/main/src/Mandarin.Cross/Platform/Desktop.cs"
click node_gestureplatform "https://github.com/dimzol/mandarin/blob/main/src/Mandarin.Cross/Platform/Gesture.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_home,node_gesture,node_wheel,node_user toneBlue
class node_filekinds,node_formats,node_jobs,node_outputs,node_image,node_media,node_ffmpeg,node_pdf,node_office,node_html,node_archive,node_otherengines toneAmber
class node_toolui,node_imagetools,node_mediaeditors,node_actions toneMint
class node_settings,node_desktop,node_gestureplatform toneRose
class node_ffmpegservice toneIndigo
```

## Components

### App and interaction

- [App startup](https://github.com/dimzol/mandarin/blob/main/src/Mandarin.Cross/App.cs): `src/Mandarin.Cross/App.cs`
- [Home window](https://github.com/dimzol/mandarin/blob/main/src/Mandarin.Cross/UI/HomeWindow.cs): `src/Mandarin.Cross/UI/HomeWindow.cs`
- [Drag gesture](https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Interop/DragGesture.cs): `src/Mandarin/Interop/DragGesture.cs`
- [Format and tool wheel](https://github.com/dimzol/mandarin/blob/main/src/Mandarin.Cross/UI/WheelWindow.cs): `src/Mandarin.Cross/UI/WheelWindow.cs`

### Conversion pipeline

- [File classification](https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Core/FileKinds.cs): `src/Mandarin/Core/FileKinds.cs`
- [Format dispatch](https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Core/Formats.cs): `src/Mandarin/Core/Formats.cs`
- [Conversion jobs](https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Core/Jobs.cs): `src/Mandarin/Core/Jobs.cs`
- [Output naming](https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Core/OutputPaths.cs): `src/Mandarin/Core/OutputPaths.cs`
- [Image engine](https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Engines/ImageEngine.cs): `src/Mandarin/Engines/ImageEngine.cs`
- [Media engine](https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Engines/MediaEngine.cs): `src/Mandarin/Engines/MediaEngine.cs`
- [FFmpeg runner](https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Engines/Ffmpeg.cs): `src/Mandarin/Engines/Ffmpeg.cs`
- [PDF engine](https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Engines/PdfEngine.cs): `src/Mandarin/Engines/PdfEngine.cs`
- [Office engine](https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Engines/OfficeEngine.cs): `src/Mandarin/Engines/OfficeEngine.cs`
- [HTML and text](https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Engines/HtmlEngine.cs): `src/Mandarin/Engines/HtmlEngine.cs`
- [Archive engine](https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Engines/ArchiveEngine.cs): `src/Mandarin/Engines/ArchiveEngine.cs`
- [Other format engines](https://github.com/dimzol/mandarin/tree/main/src/Mandarin/Engines): `src/Mandarin/Engines`

### Editing tools

- [Tool windows](https://github.com/dimzol/mandarin/tree/main/src/Mandarin.Cross/UI/Tools): `src/Mandarin.Cross/UI/Tools`
- [Image tools](https://github.com/dimzol/mandarin/blob/main/src/Mandarin.Cross/UI/Tools/ImageTools.cs): `src/Mandarin.Cross/UI/Tools/ImageTools.cs`
- [Media editors](https://github.com/dimzol/mandarin/blob/main/src/Mandarin.Cross/UI/Tools/MediaEditors.cs): `src/Mandarin.Cross/UI/Tools/MediaEditors.cs`
- [File actions](https://github.com/dimzol/mandarin/blob/main/src/Mandarin.Cross/UI/FileActions.cs): `src/Mandarin.Cross/UI/FileActions.cs`

### Platform and settings

- [Application settings](https://github.com/dimzol/mandarin/blob/main/src/Mandarin/Core/AppSettings.cs): `src/Mandarin/Core/AppSettings.cs`
- [Desktop integration](https://github.com/dimzol/mandarin/blob/main/src/Mandarin.Cross/Platform/Desktop.cs): `src/Mandarin.Cross/Platform/Desktop.cs`
- [Platform gesture input](https://github.com/dimzol/mandarin/blob/main/src/Mandarin.Cross/Platform/Gesture.cs): `src/Mandarin.Cross/Platform/Gesture.cs`

### Other components

- **User**
- **FFmpeg executable**

## Connections

- User → Drag gesture: starts drag (evidence: `README.md`)
- Drag gesture → Format and tool wheel: opens wheel
- User → Home window: drops or selects (evidence: `README.md`)
- Home window → Format dispatch: requests conversion (evidence: `src/Mandarin.Cross/UI/HomeWindow.cs`)
- Format and tool wheel → Format dispatch: chooses format (evidence: `README.md`)
- Format dispatch → File classification: classifies files (evidence: `src/Mandarin/Core/Formats.cs`)
- Format dispatch → Conversion jobs: starts batch (evidence: `src/Mandarin/Core/Formats.cs`)
- Format dispatch → Image engine: dispatches image (evidence: `src/Mandarin/Core/Formats.cs`)
- Format dispatch → Media engine: dispatches media (evidence: `src/Mandarin/Core/Formats.cs`)
- Format dispatch → PDF engine: dispatches PDF (evidence: `src/Mandarin/Core/Formats.cs`)
- Format dispatch → Office engine: dispatches office (evidence: `src/Mandarin/Core/Formats.cs`)
- Format dispatch → Archive engine: dispatches archive (evidence: `src/Mandarin/Core/Formats.cs`)
- Format dispatch → Other format engines: dispatches formats (evidence: `src/Mandarin/Core/Formats.cs`)
- Image engine → PDF engine: creates image PDF (evidence: `src/Mandarin/Engines/ImageEngine.cs`)
- Media engine → FFmpeg runner: runs media tasks (evidence: `src/Mandarin/Engines/MediaEngine.cs`)
- FFmpeg runner → FFmpeg executable: invokes (evidence: `src/Mandarin/Engines/Ffmpeg.cs`)
- Image engine → Output naming: reserves results (evidence: `src/Mandarin/Engines/ImageEngine.cs`)
- PDF engine → Output naming: names results (evidence: `src/Mandarin/Engines/PdfEngine.cs`)
- Office engine → Output naming: names results (evidence: `src/Mandarin/Engines/OfficeEngine.cs`)
- Archive engine → Output naming: names results (evidence: `src/Mandarin/Engines/ArchiveEngine.cs`)
- Format and tool wheel → Tool windows: opens tools (evidence: `README.md`)
- Tool windows → Image tools: hosts image tools
- Tool windows → Media editors: hosts media tools
- Image tools → Image engine: uses image engine (evidence: `src/Mandarin.Cross/UI/Tools/ImageTools.cs`)
- Media editors → Media engine: uses media engine (evidence: `src/Mandarin.Cross/UI/Tools/MediaEditors.cs`)
- Home window → File actions: offers file actions
- App startup → Application settings: loads settings (evidence: `src/Mandarin.Cross/App.cs`)
- App startup → Home window: shows window (evidence: `src/Mandarin.Cross/App.cs`)
- App startup → Desktop integration: initializes integration (evidence: `src/Mandarin.Cross/App.cs`)
- Platform gesture input → Drag gesture: supports input
