# jthweb/windows-12 architecture

> Architecture diagram of the GitHub repository jthweb/windows-12, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-15). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jthweb/windows-12
- Repository: https://github.com/jthweb/windows-12

## Overview

##### Project Type & Purpose
- This is an open-source **Windows customization layer** (not a full OS) that provides a cohesive UI/UX “skin” on top of Windows 10/11.

##### Top-Level Components
- Configurator App
– run.py + run.ui: a PyQt/PySide (or similar) GUI that drives installation and configuration
- Python Utility Modules
– Winver: winver.py + logo + version.json
- Asset Repositories
– Cursors, Shell msstyles, Wallpapers under win10/ and win11/ directories
- External Tools & Dependencies
– Rainmeter (widget host)
– UltraUXThemePatcher (theme patching)
– HackBGRT (boot splash)
– Writing Tools API (for “Windows Intelligence” integration)

##### Data Flow & Interactions
- User launches the **Windows 12 Configurator** → selects install/uninstall options →
↳ Configurator invokes the relevant Python module (Run, Taskbar, Winver, etc.)
↳ Calls external utilities (Rainmeter, UltraUXThemePatcher, 7tsp, HackBGRT) via CLI to apply skins/patches →
↳ Windows OS & Rainmeter update UI accordingly
- Version checking: Configurator or Winver module reads version.json to prompt updates.

##### Architectural Patterns & Principles
- **Modular design**: each feature (Run dialog, Taskbar, Winver, Time widgets) is its own Python module with its own assets and configuration files.
- **Presentation vs. Logic separation**: UI definitions (.ui) are separate from Python code.
- **Command orchestration**: the Configurator serves as a central controller that sequences calls to each module and to external patching tools.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Actors
    User["User"]:::actor

    %% Configurator
    subgraph "Configurator"
        ConfigUI["Configurator UI"]:::ui
        ConfigApp["Configurator App"]:::ui
    end

    %% Python Modules
    subgraph "Python Modules"
        subgraph "Taskbar Module"
            TB_Folders["folders.py"]:::python
            TB_Office["office.py"]:::python
            TB_Taskbar["taskbar.py"]:::python
            TB_Time["time.py"]:::python
            subgraph "JSON Configs"
                TB_FoldersJSON["Folders.json"]:::assets
                TB_OfficeJSON["Office_Items.json"]:::assets
                TB_TaskbarJSON["Taskbar_Items.json"]:::assets
            end
            TB_Icons["Taskbar Icons"]:::assets
        end
        subgraph "Winver Module"
            WinverLogic["winver.py"]:::python
            WinverLogo["Logo Asset"]:::assets
            WinverVersion["version.json"]:::assets
        end
    end

    %% Asset Repositories
    subgraph "Asset Stores"
        subgraph "Windows 10 Theme"
            W10_Cursors["Cursors"]:::assets
            W10_Shell["Shell Styles"]:::assets
            W10_Wallpapers["Wallpapers"]:::assets
            W10_Themes["Themes"]:::assets
        end
        subgraph "Windows 11 Theme"
            W11_Cursors["Cursors"]:::assets
            W11_Shell["Shell Styles"]:::assets
            W11_Wallpapers["Wallpapers"]:::assets
            W11_Themes["Themes"]:::assets
        end
    end

    %% External Tools
    subgraph "External Tools"
        Rainmeter["Rainmeter"]:::external
        UUTP["UltraUXThemePatcher"]:::external
        tsp7["7tsp"]:::external
        HackBGRT["HackBGRT"]:::external
        WTAPI["Writing Tools API"]:::external
    end

    %% OS/Runtimes
    WindowsOS["Windows OS & Rainmeter Runtime"]:::os

    %% Connections
    User --> ConfigUI
    ConfigUI --> ConfigApp
    ConfigApp -->|"invokes"| TB_Folders
    ConfigApp -->|"invokes"| TB_Office
    ConfigApp -->|"invokes"| TB_Taskbar
    ConfigApp -->|"invokes"| TB_Time
    ConfigApp -->|"invokes"| WinverLogic

    TB_Folders -->|"reads JSON"| TB_FoldersJSON
    TB_Office -->|"reads JSON"| TB_OfficeJSON
    TB_Taskbar -->|"reads JSON"| TB_TaskbarJSON
    TB_Time -->|"reads assets"| TB_Icons

    WinverLogic -->|"reads asset"| WinverLogo
    WinverLogic -->|"reads version"| WinverVersion

    TB_Folders -->|"invokes CLI"| Rainmeter
    TB_Taskbar -->|"invokes CLI"| UUTP
    TB_Time -->|"invokes CLI"| tsp7
    WinverLogic -->|"invokes CLI"| HackBGRT
    ConfigApp -->|"uses API"| WTAPI

    Rainmeter -->|"applies widgets"| WindowsOS
    UUTP -->|"patches theme"| WindowsOS
    tsp7 -->|"patches icons"| WindowsOS
    HackBGRT -->|"patches boot"| WindowsOS
    WTAPI -->|"integrates intel"| WindowsOS

    WindowsOS -->|"updates UI"| User

    %% Click Events
    click ConfigApp "https://github.com/jthweb/windows-12/blob/main/Run/run.py"
    click ConfigUI "https://github.com/jthweb/windows-12/blob/main/Run/run.ui"

    click TB_Folders "https://github.com/jthweb/windows-12/blob/main/Taskbar/folders.py"
    click TB_Office "https://github.com/jthweb/windows-12/blob/main/Taskbar/office.py"
    click TB_Taskbar "https://github.com/jthweb/windows-12/blob/main/Taskbar/taskbar.py"
    click TB_Time "https://github.com/jthweb/windows-12/blob/main/Taskbar/time.py"
    click TB_FoldersJSON "https://github.com/jthweb/windows-12/blob/main/Taskbar/Folders.json"
    click TB_OfficeJSON "https://github.com/jthweb/windows-12/blob/main/Taskbar/Office_Items.json"
    click TB_TaskbarJSON "https://github.com/jthweb/windows-12/blob/main/Taskbar/Taskbar_Items.json"
    click TB_Icons "https://github.com/jthweb/windows-12/tree/main/Taskbar/icons"

    click WinverLogic "https://github.com/jthweb/windows-12/blob/main/Winver/winver.py"
    click WinverLogo "https://github.com/jthweb/windows-12/tree/main/Winver/logo"
    click WinverVersion "https://github.com/jthweb/windows-12/blob/main/version.json"

    click W10_Cursors "https://github.com/jthweb/windows-12/tree/main/win10/Windows 12 Theme/Cursors"
    click W10_Shell "https://github.com/jthweb/windows-12/tree/main/win10/Windows 12 Theme/Shell/NormalColor"
    click W10_Wallpapers "https://github.com/jthweb/windows-12/tree/main/win10/Windows 12 Theme/Wallpapers"
    click W10_Themes "https://github.com/jthweb/windows-12/blob/main/win10/Windows 12-Regular.msstyles"

    click W11_Cursors "https://github.com/jthweb/windows-12/tree/main/win11/Windows 12 Theme/Cursors"
    click W11_Shell "https://github.com/jthweb/windows-12/tree/main/win11/Windows 12 Theme/Shell/NormalColor"
    click W11_Wallpapers "https://github.com/jthweb/windows-12/tree/main/win11/Windows 12 Theme/Wallpapers"
    click W11_Themes "https://github.com/jthweb/windows-12/blob/main/win11/Windows 12-Regular.msstyles"

    %% Styles
    classDef python fill:#b2fab4,stroke:#2d572c,color:#000
    classDef ui fill:#cce5ff,stroke:#2a6ebd,color:#000
    classDef assets fill:#fff1b8,stroke:#c08a00,color:#000
    classDef external fill:#ffd8b8,stroke:#bf4e00,color:#000
    classDef os fill:#e0e0e0,stroke:#888,color:#000
    classDef actor fill:#d9f7be,stroke:#389e0d,color:#000
```
