# donner-dev/powershell-scripts architecture

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

- Interactive diagram: https://gitdiagram.com/donner-dev/powershell-scripts
- Repository: https://github.com/donner-dev/powershell-scripts

## Overview

This repository is a collection of standalone PowerShell utilities, with an optional Python desktop launcher. In the GUI workflow, a user selects a categorized script, the application starts it in a background thread, and script output is presented in the console; the GUI also supports interactive input and script-category management. The scripts cover audio and voice, computer management, and many other command-line tasks. The source excerpt confirms the GUI’s scripts-directory configuration and background execution, but omits the execution details and most script implementations, so those connections are shown as unverified.

Main entry points: [`gui/powershell_commander.py`](https://github.com/donner-dev/powershell-scripts/blob/main/gui/powershell_commander.py) (PowerShell Commander), [`scripts`](https://github.com/donner-dev/powershell-scripts/tree/main/scripts) (Standalone scripts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Desktop interaction"]
  node_commander["PowerShell Commander"]
  node_category_config["Script categories"]
  node_output_console["Output console"]
  node_input_dialog["Input dialog"]
end

subgraph group_catalog["Script collection"]
  node_script_collection["Standalone scripts"]
end

subgraph group_capabilities["Script capabilities"]
  node_audio_voice["Audio and voice"]
  node_computer_management["Computer management"]
  node_file_network["File and network tasks"]
  node_repository_tasks["Repository tasks"]
end

node_user(("CLI / GUI user"))
node_external_system["Local system / services"]

node_user -.->|"uses"| node_commander
node_user -.->|"runs directly"| node_script_collection
node_commander -->|"manages categories"| node_category_config
node_commander -.->|"launches scripts"| node_script_collection
node_commander -.->|"displays output"| node_output_console
node_commander -.->|"requests input"| node_input_dialog
node_audio_voice -.->|"uses audio"| node_external_system
node_computer_management -.->|"manages system"| node_external_system
node_file_network -.->|"acts on resources"| node_external_system
node_repository_tasks -.->|"uses Git"| node_external_system

click node_commander "https://github.com/donner-dev/powershell-scripts/blob/main/gui/powershell_commander.py"
click node_category_config "https://github.com/donner-dev/powershell-scripts/blob/main/gui/powershell_commander.py"
click node_output_console "https://github.com/donner-dev/powershell-scripts/blob/main/gui/powershell_commander.py"
click node_input_dialog "https://github.com/donner-dev/powershell-scripts/blob/main/gui/powershell_commander.py"
click node_script_collection "https://github.com/donner-dev/powershell-scripts/tree/main/scripts"
click node_audio_voice "https://github.com/donner-dev/powershell-scripts/tree/main/scripts"
click node_computer_management "https://github.com/donner-dev/powershell-scripts/tree/main/scripts"
click node_file_network "https://github.com/donner-dev/powershell-scripts/tree/main/scripts"
click node_repository_tasks "https://github.com/donner-dev/powershell-scripts/tree/main/scripts"

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_commander,node_category_config,node_output_console,node_input_dialog,node_user toneBlue
class node_script_collection toneAmber
class node_audio_voice,node_computer_management,node_file_network,node_repository_tasks toneMint
class node_external_system toneIndigo
```

## Components

### Desktop interaction

- [PowerShell Commander](https://github.com/donner-dev/powershell-scripts/blob/main/gui/powershell_commander.py): `gui/powershell_commander.py`
- [Script categories](https://github.com/donner-dev/powershell-scripts/blob/main/gui/powershell_commander.py): `gui/powershell_commander.py`
- [Output console](https://github.com/donner-dev/powershell-scripts/blob/main/gui/powershell_commander.py): `gui/powershell_commander.py`
- [Input dialog](https://github.com/donner-dev/powershell-scripts/blob/main/gui/powershell_commander.py): `gui/powershell_commander.py`

### Script collection

- [Standalone scripts](https://github.com/donner-dev/powershell-scripts/tree/main/scripts): `scripts`

### Script capabilities

- [Audio and voice](https://github.com/donner-dev/powershell-scripts/tree/main/scripts): `scripts`
- [Computer management](https://github.com/donner-dev/powershell-scripts/tree/main/scripts): `scripts`
- [File and network tasks](https://github.com/donner-dev/powershell-scripts/tree/main/scripts): `scripts`
- [Repository tasks](https://github.com/donner-dev/powershell-scripts/tree/main/scripts): `scripts`

### Other components

- **CLI / GUI user**
- **Local system / services**

## Connections

- CLI / GUI user → PowerShell Commander: uses (evidence: `README.md`)
- CLI / GUI user → Standalone scripts: runs directly (evidence: `README.md`)
- PowerShell Commander → Script categories: manages categories (evidence: `gui/powershell_commander.py`)
- PowerShell Commander → Standalone scripts: launches scripts
- PowerShell Commander → Output console: displays output (evidence: `gui/powershell_commander.py`)
- PowerShell Commander → Input dialog: requests input (evidence: `gui/powershell_commander.py`)
- Audio and voice → Local system / services: uses audio (evidence: `README.md`)
- Computer management → Local system / services: manages system (evidence: `README.md`)
- File and network tasks → Local system / services: acts on resources (evidence: `README.md`)
- Repository tasks → Local system / services: uses Git (evidence: `README.md`)