# adrian-utz/image-multitool architecture

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

- Interactive diagram: https://gitdiagram.com/adrian-utz/image-multitool
- Repository: https://github.com/adrian-utz/image-multitool

## Overview

Python Multitool is a desktop/CLI utility for bulk image processing and file management. Users choose a tool in the GUI or command-line menu, provide files, folders, or spreadsheet inputs, and receive transformed files, comparisons, downloads, or reports. The GUI also manages task queues, progress, and cancellation. The graph preserves the README’s major capabilities; several tools are represented from the README and source index because their implementation excerpts were not provided, so uncertain internal calls are omitted.

Main entry points: [`Image-Multitool-EXE/gui.py`](https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/gui.py) (Desktop GUI), [`Image-Multitool-EXE/multitool.py`](https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/multitool.py) (CLI Menu), [`Image-Multitool-EXE/check_for_update.py`](https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/check_for_update.py) (Update Checker), [`Image-Multitool-EXE/web_downloading.py`](https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/web_downloading.py) (Excel Image Download)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User Interfaces"]
  node_gui["Desktop GUI<br/>[gui.py]"]
  node_cli["CLI Menu<br/>[multitool.py]"]
end

subgraph group_files["File Management"]
  node_count["Count Extensions"]
  node_list["List Filenames"]
  node_search["Search and Copy<br/>[search_files.py]"]
  node_compare_folders["Compare Folders<br/>[folder_compare.py]"]
  node_backup["File Backup<br/>[create_backup.py]"]
end

subgraph group_images["Image Processing"]
  node_reformat["Reformat Images"]
  node_optimize["Optimize Images"]
  node_grade["Grade Image Quality"]
end

subgraph group_spreadsheets["Spreadsheet Tools"]
  node_rename["Excel File Rename<br/>[rename_wt_excel.py]"]
  node_txt_excel["TXT Excel Compare"]
  node_download["Excel Image Download<br/>[web_downloading.py]"]
end

subgraph group_runtime["Runtime Support"]
  node_gui_helpers["GUI Helpers<br/>[gui_helpers.py]"]
  node_options["App Options<br/>[options.py]"]
  node_konami["Konami Feature<br/>[konami.py]"]
  node_updates["Update Checker"]
  node_version["Version<br/>[version.py]"]
end

node_user(("User"))
node_http_service(("Image Hosts"))
node_github(("GitHub API"))

node_user -->|"chooses tools"| node_gui
node_user -->|"chooses tools"| node_cli
node_gui -->|"dispatches to"| node_count
node_gui -->|"dispatches to"| node_list
node_gui -->|"dispatches to"| node_search
node_gui -->|"dispatches to"| node_compare_folders
node_gui -->|"dispatches to"| node_backup
node_gui -->|"dispatches to"| node_reformat
node_gui -->|"dispatches to"| node_optimize
node_gui -->|"dispatches to"| node_grade
node_gui -->|"dispatches to"| node_rename
node_gui -->|"dispatches to"| node_txt_excel
node_gui -->|"dispatches to"| node_download
node_cli -->|"dispatches to"| node_count
node_cli -->|"dispatches to"| node_list
node_cli -->|"dispatches to"| node_search
node_cli -->|"dispatches to"| node_reformat
node_cli -->|"dispatches to"| node_optimize
node_cli -->|"dispatches to"| node_grade
node_cli -->|"dispatches to"| node_rename
node_cli -->|"dispatches to"| node_txt_excel
node_cli -->|"dispatches to"| node_download
node_cli -->|"dispatches to"| node_compare_folders
node_cli -->|"dispatches to"| node_backup
node_gui -->|"uses"| node_gui_helpers
node_gui -->|"uses"| node_options
node_gui -->|"uses"| node_konami
node_gui -->|"checks updates"| node_updates
node_gui -->|"reads version"| node_version
node_updates -->|"reads version"| node_version
node_updates -->|"queries releases"| node_github
node_download -->|"downloads images"| node_http_service

click node_gui "https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/gui.py"
click node_cli "https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/multitool.py"
click node_count "https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/count_files_by_extension.py"
click node_list "https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/list_files_by_extension.py"
click node_search "https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/search_files.py"
click node_compare_folders "https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/folder_compare.py"
click node_backup "https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/create_backup.py"
click node_reformat "https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/image_reformatting.py"
click node_optimize "https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/image_optimization.py"
click node_grade "https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/image_quality_grader.py"
click node_rename "https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/rename_wt_excel.py"
click node_txt_excel "https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/compare_txt_to_excel.py"
click node_download "https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/web_downloading.py"
click node_gui_helpers "https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/gui_helpers.py"
click node_options "https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/options.py"
click node_konami "https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/konami.py"
click node_updates "https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/check_for_update.py"
click node_version "https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/version.py"

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_gui,node_cli,node_user toneBlue
class node_count,node_list,node_search,node_compare_folders,node_backup toneAmber
class node_reformat,node_optimize,node_grade,node_github toneMint
class node_rename,node_txt_excel,node_download toneRose
class node_gui_helpers,node_options,node_konami,node_updates,node_version,node_http_service toneIndigo
```

## Components

### User Interfaces

- [Desktop GUI](https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/gui.py): `Image-Multitool-EXE/gui.py`
- [CLI Menu](https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/multitool.py): `Image-Multitool-EXE/multitool.py`

### File Management

- [Count Extensions](https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/count_files_by_extension.py): `Image-Multitool-EXE/count_files_by_extension.py`
- [List Filenames](https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/list_files_by_extension.py): `Image-Multitool-EXE/list_files_by_extension.py`
- [Search and Copy](https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/search_files.py): `Image-Multitool-EXE/search_files.py`
- [Compare Folders](https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/folder_compare.py): `Image-Multitool-EXE/folder_compare.py`
- [File Backup](https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/create_backup.py): `Image-Multitool-EXE/create_backup.py`

### Image Processing

- [Reformat Images](https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/image_reformatting.py): `Image-Multitool-EXE/image_reformatting.py`
- [Optimize Images](https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/image_optimization.py): `Image-Multitool-EXE/image_optimization.py`
- [Grade Image Quality](https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/image_quality_grader.py): `Image-Multitool-EXE/image_quality_grader.py`

### Spreadsheet Tools

- [Excel File Rename](https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/rename_wt_excel.py): `Image-Multitool-EXE/rename_wt_excel.py`
- [TXT Excel Compare](https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/compare_txt_to_excel.py): `Image-Multitool-EXE/compare_txt_to_excel.py`
- [Excel Image Download](https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/web_downloading.py): `Image-Multitool-EXE/web_downloading.py`

### Runtime Support

- [GUI Helpers](https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/gui_helpers.py): `Image-Multitool-EXE/gui_helpers.py`
- [App Options](https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/options.py): `Image-Multitool-EXE/options.py`
- [Konami Feature](https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/konami.py): `Image-Multitool-EXE/konami.py`
- [Update Checker](https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/check_for_update.py): `Image-Multitool-EXE/check_for_update.py`
- [Version](https://github.com/adrian-utz/image-multitool/blob/main/Image-Multitool-EXE/version.py): `Image-Multitool-EXE/version.py`

### Other components

- **User**
- **Image Hosts**
- **GitHub API**

## Connections

- User → Desktop GUI: chooses tools (evidence: `Image-Multitool-EXE/gui.py`)
- User → CLI Menu: chooses tools (evidence: `Image-Multitool-EXE/multitool.py`)
- Desktop GUI → Count Extensions: dispatches to (evidence: `Image-Multitool-EXE/gui.py`)
- Desktop GUI → List Filenames: dispatches to (evidence: `Image-Multitool-EXE/gui.py`)
- Desktop GUI → Search and Copy: dispatches to (evidence: `Image-Multitool-EXE/gui.py`)
- Desktop GUI → Compare Folders: dispatches to (evidence: `Image-Multitool-EXE/gui.py`)
- Desktop GUI → File Backup: dispatches to (evidence: `Image-Multitool-EXE/gui.py`)
- Desktop GUI → Reformat Images: dispatches to (evidence: `Image-Multitool-EXE/gui.py`)
- Desktop GUI → Optimize Images: dispatches to (evidence: `Image-Multitool-EXE/gui.py`)
- Desktop GUI → Grade Image Quality: dispatches to (evidence: `Image-Multitool-EXE/gui.py`)
- Desktop GUI → Excel File Rename: dispatches to (evidence: `Image-Multitool-EXE/gui.py`)
- Desktop GUI → TXT Excel Compare: dispatches to (evidence: `Image-Multitool-EXE/gui.py`)
- Desktop GUI → Excel Image Download: dispatches to (evidence: `Image-Multitool-EXE/gui.py`)
- CLI Menu → Count Extensions: dispatches to (evidence: `Image-Multitool-EXE/multitool.py`)
- CLI Menu → List Filenames: dispatches to (evidence: `Image-Multitool-EXE/multitool.py`)
- CLI Menu → Search and Copy: dispatches to (evidence: `Image-Multitool-EXE/multitool.py`)
- CLI Menu → Reformat Images: dispatches to (evidence: `Image-Multitool-EXE/multitool.py`)
- CLI Menu → Optimize Images: dispatches to (evidence: `Image-Multitool-EXE/multitool.py`)
- CLI Menu → Grade Image Quality: dispatches to (evidence: `Image-Multitool-EXE/multitool.py`)
- CLI Menu → Excel File Rename: dispatches to (evidence: `Image-Multitool-EXE/multitool.py`)
- CLI Menu → TXT Excel Compare: dispatches to (evidence: `Image-Multitool-EXE/multitool.py`)
- CLI Menu → Excel Image Download: dispatches to (evidence: `Image-Multitool-EXE/multitool.py`)
- CLI Menu → Compare Folders: dispatches to (evidence: `Image-Multitool-EXE/multitool.py`)
- CLI Menu → File Backup: dispatches to (evidence: `Image-Multitool-EXE/multitool.py`)
- Desktop GUI → GUI Helpers: uses (evidence: `Image-Multitool-EXE/gui.py`)
- Desktop GUI → App Options: uses (evidence: `Image-Multitool-EXE/gui.py`)
- Desktop GUI → Konami Feature: uses (evidence: `Image-Multitool-EXE/gui.py`)
- Desktop GUI → Update Checker: checks updates (evidence: `Image-Multitool-EXE/gui.py`)
- Desktop GUI → Version: reads version (evidence: `Image-Multitool-EXE/gui.py`)
- Update Checker → Version: reads version (evidence: `Image-Multitool-EXE/check_for_update.py`)
- Update Checker → GitHub API: queries releases (evidence: `Image-Multitool-EXE/check_for_update.py`)
- Excel Image Download → Image Hosts: downloads images (evidence: `Image-Multitool-EXE/web_downloading.py`)
