# zevolpato/winutil architecture

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

- Interactive diagram: https://gitdiagram.com/zevolpato/winutil
- Repository: https://github.com/zevolpato/winutil

## Overview

WinUtil is an administrator-run PowerShell utility for configuring Windows. Its user workflow is to launch the utility, choose or automate system tasks, and apply installs, tweaks, troubleshooting/configuration, or update settings. The tree and README establish those capability areas, but the PowerShell implementation was not sampled, so their internal routing is not inferred. The sampled title-screen scripts form a separate image-generation tool; their shown calls and imports are represented, but they are not part of WinUtil’s system-configuration workflow.

Main entry points: [`scripts/start.ps1`](https://github.com/zevolpato/winutil/blob/main/scripts/start.ps1) (WinUtil), [`tools/title-screen/automate_title_screen.py`](https://github.com/zevolpato/winutil/blob/main/tools/title-screen/automate_title_screen.py) (Theme Capture), [`config/preset.json`](https://github.com/zevolpato/winutil/blob/main/config/preset.json) (Presets), [`functions/public`](https://github.com/zevolpato/winutil/tree/main/functions/public) (Installs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_winutil["Windows Utility"]
  node_utility["WinUtil<br/>[start.ps1]"]
  node_installs["Installs"]
  node_tweaks["Tweaks"]
  node_config["Troubleshooting"]
  node_updates["Updates"]
  node_automation["Presets<br/>[preset.json]"]
end

subgraph group_title["Title Screen Tool"]
  node_automation_script["Theme Capture"]
  node_capture["Window Capture<br/>[capture_winutil.py]"]
  node_composite["Image Composite"]
end

node_admin(("Administrator"))

node_admin -->|"runs as"| node_utility
node_utility -->|"offers"| node_installs
node_utility -->|"offers"| node_tweaks
node_utility -->|"offers"| node_config
node_utility -->|"configures"| node_updates
node_automation -->|"automates"| node_utility
node_automation_script -->|"calls"| node_capture
node_automation_script -->|"calls"| node_composite

click node_utility "https://github.com/zevolpato/winutil/blob/main/scripts/start.ps1"
click node_installs "https://github.com/zevolpato/winutil/tree/main/functions/public"
click node_tweaks "https://github.com/zevolpato/winutil/tree/main/functions/public"
click node_config "https://github.com/zevolpato/winutil/tree/main/functions/public"
click node_updates "https://github.com/zevolpato/winutil/tree/main/functions/public"
click node_automation "https://github.com/zevolpato/winutil/blob/main/config/preset.json"
click node_automation_script "https://github.com/zevolpato/winutil/blob/main/tools/title-screen/automate_title_screen.py"
click node_capture "https://github.com/zevolpato/winutil/blob/main/tools/title-screen/capture_winutil.py"
click node_composite "https://github.com/zevolpato/winutil/blob/main/tools/title-screen/create_composite.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_utility,node_installs,node_tweaks,node_config,node_updates,node_automation toneBlue
class node_automation_script,node_capture,node_composite toneAmber
class node_admin toneIndigo
```

## Components

### Windows Utility

- [WinUtil](https://github.com/zevolpato/winutil/blob/main/scripts/start.ps1): `scripts/start.ps1`
- [Installs](https://github.com/zevolpato/winutil/tree/main/functions/public): `functions/public`
- [Tweaks](https://github.com/zevolpato/winutil/tree/main/functions/public): `functions/public`
- [Troubleshooting](https://github.com/zevolpato/winutil/tree/main/functions/public): `functions/public`
- [Updates](https://github.com/zevolpato/winutil/tree/main/functions/public): `functions/public`
- [Presets](https://github.com/zevolpato/winutil/blob/main/config/preset.json): `config/preset.json`

### Title Screen Tool

- [Theme Capture](https://github.com/zevolpato/winutil/blob/main/tools/title-screen/automate_title_screen.py): `tools/title-screen/automate_title_screen.py`
- [Window Capture](https://github.com/zevolpato/winutil/blob/main/tools/title-screen/capture_winutil.py): `tools/title-screen/capture_winutil.py`
- [Image Composite](https://github.com/zevolpato/winutil/blob/main/tools/title-screen/create_composite.py): `tools/title-screen/create_composite.py`

### Other components

- **Administrator**

## Connections

- Administrator → WinUtil: runs as (evidence: `README.md`)
- WinUtil → Installs: offers (evidence: `README.md`)
- WinUtil → Tweaks: offers (evidence: `README.md`)
- WinUtil → Troubleshooting: offers (evidence: `README.md`)
- WinUtil → Updates: configures (evidence: `README.md`)
- Presets → WinUtil: automates (evidence: `README.md`)
- Theme Capture → Window Capture: calls (evidence: `tools/title-screen/automate_title_screen.py`)
- Theme Capture → Image Composite: calls (evidence: `tools/title-screen/automate_title_screen.py`)
