# jasonzhu1207/zenconverter architecture

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

- Interactive diagram: https://gitdiagram.com/jasonzhu1207/zenconverter
- Repository: https://github.com/jasonzhu1207/zenconverter

## Overview

ZenConverter is a local-first Android file-conversion app. The main workflow starts with a user choosing or sharing files, configuring targets and options, then queuing work for a foreground conversion service that saves results on-device. The service owns conversion dispatch across the documented media, document, font, and subtitle routes; separate tools handle metadata privacy and optional model/font downloads. The README documents the overall pipeline and capabilities, while sampled source/index references clarify several service dependencies; unsampled route internals are represented at subsystem level.

Main entry points: [`app/src/main/java/org/zenconverter/app/conversion/ConversionService.kt`](https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/conversion/ConversionService.kt) (Foreground service), [`app/src/main/java/org/zenconverter/app/MainActivity.kt`](https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/MainActivity.kt) (File intake), [`app/src/main/java/org/zenconverter/app/ui/ZenConverterApp.kt`](https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/ui/ZenConverterApp.kt) (Compose app UI), [`app/src/main/java/org/zenconverter/app/conversion/ConversionTaskStore.kt`](https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/conversion/ConversionTaskStore.kt) (Task queue)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_intake["Import and tasks"]
  node_activity["File intake<br/>[MainActivity.kt]"]
  node_appui["Compose app UI<br/>[ZenConverterApp.kt]"]
  node_taskstore["Task queue"]
  node_fileinfo["File basics<br/>[FileBasicInfo.kt]"]
  node_output["Saved results"]
end

subgraph group_conversion["Conversion routes"]
  node_service["Foreground service"]
  node_engine["Conversion engine"]
  node_media["Media and PDF"]
  node_office["Office conversion"]
  node_fonts["Font conversion"]
  node_subtitles["Subtitle codecs"]
end

subgraph group_privacy["Privacy and settings"]
  node_metadata["Metadata privacy"]
  node_preferences[("App preferences<br/>[AppPreferences.kt]")]
end

subgraph group_offline["Offline engines"]
  node_esrgan["Image upscaling"]
  node_rife["Frame interpolation"]
  node_models["Model downloads"]
  node_officefonts["Office fonts"]
end

subgraph group_updates["App updates"]
  node_updatesui["Update settings"]
  node_updater["Update checker"]
end

node_user(("Device user"))
node_internet(("Download services"))
node_github(("GitHub releases"))

node_user -->|"selects files"| node_activity
node_activity -->|"opens app"| node_appui
node_activity -->|"queues inputs"| node_taskstore
node_activity -->|"starts service"| node_service
node_activity -->|"opens privacy tool"| node_metadata
node_activity -->|"uses file details"| node_fileinfo
node_appui -.->|"configures tasks"| node_taskstore
node_taskstore -->|"provides queued work"| node_service
node_service -.->|"dispatches conversion"| node_engine
node_service -->|"runs media and PDF"| node_media
node_service -->|"runs office routes"| node_office
node_service -->|"runs font routes"| node_fonts
node_service -->|"runs subtitle routes"| node_subtitles
node_service -->|"saves results"| node_output
node_service -->|"uses upscaler"| node_esrgan
node_service -->|"uses interpolator"| node_rife
node_esrgan -.->|"uses downloaded models"| node_models
node_rife -.->|"uses downloaded models"| node_models
node_service -->|"uses office fonts"| node_officefonts
node_models -->|"downloads on demand"| node_internet
node_officefonts -->|"downloads on demand"| node_internet
node_activity -->|"reads settings"| node_preferences
node_appui -->|"shows update controls"| node_updatesui
node_updatesui -.->|"checks updates"| node_updater
node_updater -.->|"checks releases"| node_github

click node_activity "https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/MainActivity.kt"
click node_appui "https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/ui/ZenConverterApp.kt"
click node_taskstore "https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/conversion/ConversionTaskStore.kt"
click node_fileinfo "https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/conversion/FileBasicInfo.kt"
click node_service "https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/conversion/ConversionService.kt"
click node_engine "https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/conversion/ConversionEngine.kt"
click node_media "https://github.com/jasonzhu1207/zenconverter/tree/main/app/src/main/java/org/zenconverter/app/conversion"
click node_office "https://github.com/jasonzhu1207/zenconverter/tree/main/app/src/main/java/org/zenconverter/app/office"
click node_fonts "https://github.com/jasonzhu1207/zenconverter/tree/main/app/src/main/java/org/zenconverter/app/font"
click node_subtitles "https://github.com/jasonzhu1207/zenconverter/tree/main/app/src/main/java/org/zenconverter/app/subtitle"
click node_output "https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/conversion/ConversionService.kt"
click node_metadata "https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/metadata/MetadataPrivacyManager.kt"
click node_preferences "https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/settings/AppPreferences.kt"
click node_esrgan "https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/model/RealEsrganUpscaler.kt"
click node_rife "https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/model/RifeInterpolator.kt"
click node_models "https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/model/EsrganModelManager.kt"
click node_officefonts "https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/office/OfficeFontManager.kt"
click node_updatesui "https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/ui/settings/UpdateStateHolder.kt"
click node_updater "https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/updates/GitHubUpdateChecker.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_appui,node_taskstore,node_fileinfo,node_output,node_user toneBlue
class node_service,node_engine,node_media,node_office,node_fonts,node_subtitles toneAmber
class node_metadata,node_preferences toneMint
class node_esrgan,node_rife,node_models,node_officefonts toneRose
class node_updatesui,node_updater,node_internet,node_github toneIndigo
```

## Components

### Import and tasks

- [File intake](https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/MainActivity.kt): `app/src/main/java/org/zenconverter/app/MainActivity.kt`
- [Compose app UI](https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/ui/ZenConverterApp.kt): `app/src/main/java/org/zenconverter/app/ui/ZenConverterApp.kt`
- [Task queue](https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/conversion/ConversionTaskStore.kt): `app/src/main/java/org/zenconverter/app/conversion/ConversionTaskStore.kt`
- [File basics](https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/conversion/FileBasicInfo.kt): `app/src/main/java/org/zenconverter/app/conversion/FileBasicInfo.kt`
- [Saved results](https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/conversion/ConversionService.kt): `app/src/main/java/org/zenconverter/app/conversion/ConversionService.kt`

### Conversion routes

- [Foreground service](https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/conversion/ConversionService.kt): `app/src/main/java/org/zenconverter/app/conversion/ConversionService.kt`
- [Conversion engine](https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/conversion/ConversionEngine.kt): `app/src/main/java/org/zenconverter/app/conversion/ConversionEngine.kt`
- [Media and PDF](https://github.com/jasonzhu1207/zenconverter/tree/main/app/src/main/java/org/zenconverter/app/conversion): `app/src/main/java/org/zenconverter/app/conversion`
- [Office conversion](https://github.com/jasonzhu1207/zenconverter/tree/main/app/src/main/java/org/zenconverter/app/office): `app/src/main/java/org/zenconverter/app/office`
- [Font conversion](https://github.com/jasonzhu1207/zenconverter/tree/main/app/src/main/java/org/zenconverter/app/font): `app/src/main/java/org/zenconverter/app/font`
- [Subtitle codecs](https://github.com/jasonzhu1207/zenconverter/tree/main/app/src/main/java/org/zenconverter/app/subtitle): `app/src/main/java/org/zenconverter/app/subtitle`

### Privacy and settings

- [Metadata privacy](https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/metadata/MetadataPrivacyManager.kt): `app/src/main/java/org/zenconverter/app/metadata/MetadataPrivacyManager.kt`
- [App preferences](https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/settings/AppPreferences.kt): `app/src/main/java/org/zenconverter/app/settings/AppPreferences.kt`

### Offline engines

- [Image upscaling](https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/model/RealEsrganUpscaler.kt): `app/src/main/java/org/zenconverter/app/model/RealEsrganUpscaler.kt`
- [Frame interpolation](https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/model/RifeInterpolator.kt): `app/src/main/java/org/zenconverter/app/model/RifeInterpolator.kt`
- [Model downloads](https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/model/EsrganModelManager.kt): `app/src/main/java/org/zenconverter/app/model/EsrganModelManager.kt`
- [Office fonts](https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/office/OfficeFontManager.kt): `app/src/main/java/org/zenconverter/app/office/OfficeFontManager.kt`

### App updates

- [Update settings](https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/ui/settings/UpdateStateHolder.kt): `app/src/main/java/org/zenconverter/app/ui/settings/UpdateStateHolder.kt`
- [Update checker](https://github.com/jasonzhu1207/zenconverter/blob/main/app/src/main/java/org/zenconverter/app/updates/GitHubUpdateChecker.kt): `app/src/main/java/org/zenconverter/app/updates/GitHubUpdateChecker.kt`

### Other components

- **Device user**
- **Download services**
- **GitHub releases**

## Connections

- Device user → File intake: selects files
- File intake → Compose app UI: opens app (evidence: `app/src/main/java/org/zenconverter/app/MainActivity.kt`)
- File intake → Task queue: queues inputs (evidence: `app/src/main/java/org/zenconverter/app/MainActivity.kt`)
- File intake → Foreground service: starts service (evidence: `app/src/main/java/org/zenconverter/app/MainActivity.kt`)
- File intake → Metadata privacy: opens privacy tool (evidence: `app/src/main/java/org/zenconverter/app/MainActivity.kt`)
- File intake → File basics: uses file details (evidence: `app/src/main/java/org/zenconverter/app/MainActivity.kt`)
- Compose app UI → Task queue: configures tasks
- Task queue → Foreground service: provides queued work (evidence: `app/src/main/java/org/zenconverter/app/conversion/ConversionService.kt`)
- Foreground service → Conversion engine: dispatches conversion
- Foreground service → Media and PDF: runs media and PDF (evidence: `app/src/main/java/org/zenconverter/app/conversion/ConversionService.kt`)
- Foreground service → Office conversion: runs office routes (evidence: `app/src/main/java/org/zenconverter/app/conversion/ConversionService.kt`)
- Foreground service → Font conversion: runs font routes (evidence: `app/src/main/java/org/zenconverter/app/conversion/ConversionService.kt`)
- Foreground service → Subtitle codecs: runs subtitle routes (evidence: `app/src/main/java/org/zenconverter/app/conversion/ConversionService.kt`)
- Foreground service → Saved results: saves results (evidence: `app/src/main/java/org/zenconverter/app/conversion/ConversionService.kt`)
- Foreground service → Image upscaling: uses upscaler (evidence: `app/src/main/java/org/zenconverter/app/conversion/ConversionService.kt`)
- Foreground service → Frame interpolation: uses interpolator (evidence: `app/src/main/java/org/zenconverter/app/conversion/ConversionService.kt`)
- Image upscaling → Model downloads: uses downloaded models
- Frame interpolation → Model downloads: uses downloaded models
- Foreground service → Office fonts: uses office fonts (evidence: `app/src/main/java/org/zenconverter/app/conversion/ConversionService.kt`)
- Model downloads → Download services: downloads on demand
- Office fonts → Download services: downloads on demand
- File intake → App preferences: reads settings (evidence: `app/src/main/java/org/zenconverter/app/MainActivity.kt`)
- Compose app UI → Update settings: shows update controls (evidence: `app/src/main/java/org/zenconverter/app/ui/ZenConverterApp.kt`)
- Update settings → Update checker: checks updates
- Update checker → GitHub releases: checks releases
