# anviktor2411/iso-package-manager architecture

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

- Interactive diagram: https://gitdiagram.com/anviktor2411/iso-package-manager
- Repository: https://github.com/anviktor2411/iso-package-manager
- Video tour (about a minute): https://gitdiagram.com/anviktor2411/iso-package-manager/video

## Overview

ISO Package Manager helps users find, download, and manage ISO images through a Tk desktop UI or terminal interface. The principal flow is selecting a source or search query, discovering remote images, then downloading and managing jobs; a separate local workflow scans and operates on existing images. Theme packs and the browser-based Theme Shop are substantial companion capabilities. Source excerpts establish several module calls, but UI callback wiring and download internals are only partially sampled, so uncertain links are omitted.

Main entry points: [`main.py`](https://github.com/anviktor2411/iso-package-manager/blob/main/main.py) (Desktop UI), [`ipm_search.py`](https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_search.py) (Web and archive search), [`ipm_windows.py`](https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_windows.py) (Windows catalog), [`ipm_ia.py`](https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_ia.py) (Archive catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry points"]
  node_launcher["Mode launcher<br/>[ipm_launcher.py]"]
  node_desktop["Desktop UI<br/>[main.py]"]
  node_terminal["Terminal CLI<br/>[ipm_cli.py]"]
end

subgraph group_discovery["ISO discovery"]
  node_search["Web and archive search<br/>[ipm_search.py]"]
  node_windows["Windows catalog<br/>[ipm_windows.py]"]
  node_archive["Archive catalog<br/>[ipm_ia.py]"]
  node_http["HTTP access<br/>[ipm_http.py]"]
  node_models["ISO data models<br/>[ipm_models.py]"]
end

subgraph group_management["ISO management"]
  node_local["Local ISO tools<br/>[main.py]"]
  node_queue["Download queue<br/>[main.py]"]
  node_mount["Mount and extract<br/>[ipm_winops.py]"]
  node_settings["Profiles and settings<br/>[main.py]"]
  node_utils["Shared utilities<br/>[ipm_utils.py]"]
end

subgraph group_themes["Theme ecosystem"]
  node_theme_core["Theme packs<br/>[ipm_themes.py]"]
  node_theme_cli["Theme commands<br/>[ipmtheme.py]"]
  node_theme_editor["Visual editor<br/>[theme_editor.py]"]
  node_theme_files["Theme pack files"]
  node_shop_app["In-app theme shop<br/>[ipm_shop.py]"]
end

subgraph group_shop["Theme Shop"]
  node_shop_site["Shop website"]
  node_shop_data["Shop catalog<br/>[index.json]"]
end

node_user(("User"))
node_filesystem[("Local filesystem")]
node_internet["ISO sources"]
node_github["GitHub"]

node_user -->|"starts"| node_launcher
node_launcher -->|"launches UI"| node_desktop
node_launcher -->|"launches CLI"| node_terminal
node_user -->|"uses"| node_desktop
node_user -->|"uses"| node_terminal
node_desktop -->|"provides"| node_local
node_local -->|"scans and operates"| node_filesystem
node_desktop -->|"manages downloads"| node_queue
node_desktop -->|"requests results"| node_search
node_terminal -->|"calls search"| node_search
node_search -->|"queries Windows"| node_windows
node_search -->|"queries Archive.org"| node_archive
node_windows -->|"fetches catalog data"| node_http
node_archive -->|"fetches catalog data"| node_http
node_search -->|"fetches search pages"| node_http
node_http -->|"uses TLS helper"| node_utils
node_search -->|"returns ISO items"| node_models
node_windows -->|"returns ISO items"| node_models
node_archive -->|"returns ISO items"| node_models
node_windows -->|"queries"| node_internet
node_archive -->|"queries"| node_internet
node_queue -.->|"downloads images"| node_internet
node_desktop -->|"offers operations"| node_mount
node_terminal -->|"offers theme commands"| node_theme_cli
node_theme_cli -->|"uses pack support"| node_theme_core
node_theme_editor -->|"uses theme format"| node_theme_core
node_theme_core -->|"loads packs"| node_theme_files
node_desktop -->|"applies themes"| node_theme_core
node_desktop -->|"opens shop"| node_shop_app
node_shop_app -->|"reads catalog"| node_shop_data
node_user -->|"browses and edits"| node_shop_site
node_shop_site -->|"reads catalog"| node_shop_data
node_shop_site -->|"submits themes"| node_github

click node_launcher "https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_launcher.py"
click node_desktop "https://github.com/anviktor2411/iso-package-manager/blob/main/main.py"
click node_terminal "https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_cli.py"
click node_local "https://github.com/anviktor2411/iso-package-manager/blob/main/main.py"
click node_queue "https://github.com/anviktor2411/iso-package-manager/blob/main/main.py"
click node_mount "https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_winops.py"
click node_settings "https://github.com/anviktor2411/iso-package-manager/blob/main/main.py"
click node_search "https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_search.py"
click node_windows "https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_windows.py"
click node_archive "https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_ia.py"
click node_http "https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_http.py"
click node_models "https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_models.py"
click node_utils "https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_utils.py"
click node_theme_core "https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_themes.py"
click node_theme_cli "https://github.com/anviktor2411/iso-package-manager/blob/main/tools/ipmtheme.py"
click node_theme_editor "https://github.com/anviktor2411/iso-package-manager/blob/main/tools/theme_editor.py"
click node_theme_files "https://github.com/anviktor2411/iso-package-manager/tree/main/themes"
click node_shop_app "https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_shop.py"
click node_shop_site "https://github.com/anviktor2411/iso-package-manager/tree/main/web"
click node_shop_data "https://github.com/anviktor2411/iso-package-manager/blob/main/docs/shop/index.json"

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_launcher,node_desktop,node_terminal,node_user toneBlue
class node_search,node_windows,node_archive,node_http,node_models,node_filesystem toneAmber
class node_local,node_queue,node_mount,node_settings,node_utils toneMint
class node_theme_core,node_theme_cli,node_theme_editor,node_theme_files,node_shop_app toneRose
class node_shop_site,node_shop_data,node_internet,node_github toneIndigo
```

## Components

### App entry points

- [Mode launcher](https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_launcher.py): `ipm_launcher.py`
- [Desktop UI](https://github.com/anviktor2411/iso-package-manager/blob/main/main.py): `main.py`
- [Terminal CLI](https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_cli.py): `ipm_cli.py`

### ISO discovery

- [Web and archive search](https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_search.py): `ipm_search.py`
- [Windows catalog](https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_windows.py): `ipm_windows.py`
- [Archive catalog](https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_ia.py): `ipm_ia.py`
- [HTTP access](https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_http.py): `ipm_http.py`
- [ISO data models](https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_models.py): `ipm_models.py`

### ISO management

- [Local ISO tools](https://github.com/anviktor2411/iso-package-manager/blob/main/main.py): `main.py`
- [Download queue](https://github.com/anviktor2411/iso-package-manager/blob/main/main.py): `main.py`
- [Mount and extract](https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_winops.py): `ipm_winops.py`
- [Profiles and settings](https://github.com/anviktor2411/iso-package-manager/blob/main/main.py): `main.py`
- [Shared utilities](https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_utils.py): `ipm_utils.py`

### Theme ecosystem

- [Theme packs](https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_themes.py): `ipm_themes.py`
- [Theme commands](https://github.com/anviktor2411/iso-package-manager/blob/main/tools/ipmtheme.py): `tools/ipmtheme.py`
- [Visual editor](https://github.com/anviktor2411/iso-package-manager/blob/main/tools/theme_editor.py): `tools/theme_editor.py`
- [Theme pack files](https://github.com/anviktor2411/iso-package-manager/tree/main/themes): `themes`
- [In-app theme shop](https://github.com/anviktor2411/iso-package-manager/blob/main/ipm_shop.py): `ipm_shop.py`

### Theme Shop

- [Shop website](https://github.com/anviktor2411/iso-package-manager/tree/main/web): `web`
- [Shop catalog](https://github.com/anviktor2411/iso-package-manager/blob/main/docs/shop/index.json): `docs/shop/index.json`

### Other components

- **User**
- **Local filesystem**
- **ISO sources**
- **GitHub**

## Connections

- User → Mode launcher: starts (evidence: `ipm_launcher.py`)
- Mode launcher → Desktop UI: launches UI (evidence: `ipm_launcher.py`)
- Mode launcher → Terminal CLI: launches CLI (evidence: `ipm_launcher.py`)
- User → Desktop UI: uses (evidence: `README.md`)
- User → Terminal CLI: uses (evidence: `ipm_cli.py`)
- Desktop UI → Local ISO tools: provides (evidence: `README.md`)
- Local ISO tools → Local filesystem: scans and operates (evidence: `README.md`)
- Desktop UI → Download queue: manages downloads (evidence: `README.md`)
- Desktop UI → Web and archive search: requests results (evidence: `main.py`)
- Terminal CLI → Web and archive search: calls search (evidence: `ipm_cli.py`)
- Web and archive search → Windows catalog: queries Windows (evidence: `ipm_search.py`)
- Web and archive search → Archive catalog: queries Archive.org (evidence: `ipm_search.py`)
- Windows catalog → HTTP access: fetches catalog data (evidence: `ipm_windows.py`)
- Archive catalog → HTTP access: fetches catalog data (evidence: `ipm_ia.py`)
- Web and archive search → HTTP access: fetches search pages (evidence: `ipm_search.py`)
- HTTP access → Shared utilities: uses TLS helper (evidence: `ipm_http.py`)
- Web and archive search → ISO data models: returns ISO items (evidence: `ipm_search.py`)
- Windows catalog → ISO data models: returns ISO items (evidence: `ipm_windows.py`)
- Archive catalog → ISO data models: returns ISO items (evidence: `ipm_ia.py`)
- Windows catalog → ISO sources: queries (evidence: `ipm_windows.py`)
- Archive catalog → ISO sources: queries (evidence: `ipm_ia.py`)
- Download queue → ISO sources: downloads images (evidence: `README.md`)
- Desktop UI → Mount and extract: offers operations (evidence: `README.md`)
- Terminal CLI → Theme commands: offers theme commands (evidence: `ipm_cli.py`)
- Theme commands → Theme packs: uses pack support (evidence: `tools/ipmtheme.py`)
- Visual editor → Theme packs: uses theme format (evidence: `tools/theme_editor.py`)
- Theme packs → Theme pack files: loads packs (evidence: `ipm_themes.py`)
- Desktop UI → Theme packs: applies themes (evidence: `README.md`)
- Desktop UI → In-app theme shop: opens shop (evidence: `README.md`)
- In-app theme shop → Shop catalog: reads catalog (evidence: `README.md`)
- User → Shop website: browses and edits (evidence: `README.md`)
- Shop website → Shop catalog: reads catalog (evidence: `README.md`)
- Shop website → GitHub: submits themes (evidence: `README.md`)
