# nesantime/blur_kms architecture

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

- Interactive diagram: https://gitdiagram.com/nesantime/blur_kms
- Repository: https://github.com/nesantime/blur_kms

## Overview

Blur-KMS is a Windows command-line tool for KMS activation. The documented workflow selects Windows activation, detects system details, lets the user adjust edition or architecture, checks connectivity, retrieves a product key, runs Windows licensing commands, and offers a restart. Office activation is documented, but the sampled entry point has no Office dispatch and its handler file is empty. The README also describes supported Windows and Office versions; the activation implementation shown is Windows-only. Connections below follow sampled calls; no Office runtime wiring is evidenced.

Main entry points: [`resources/controller/modules.py`](https://github.com/nesantime/blur_kms/blob/main/resources/controller/modules.py) (System and KMS ops), [`blur_kms.py`](https://github.com/nesantime/blur_kms/blob/main/blur_kms.py) (CLI entry), [`resources/controller/funciones/key_windows.py`](https://github.com/nesantime/blur_kms/blob/main/resources/controller/funciones/key_windows.py) (Activation flow), [`resources/controller/controller.py`](https://github.com/nesantime/blur_kms/blob/main/resources/controller/controller.py) (Windows menu)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI and menus"]
  node_entry["CLI entry<br/>[blur_kms.py]"]
  node_menus["Menu rendering<br/>[animations.py]"]
  node_controller["Windows menu<br/>[controller.py]"]
end

subgraph group_activation["Windows activation"]
  node_kms_flow["Activation flow<br/>[key_windows.py]"]
  node_system_ops["System and KMS ops<br/>[modules.py]"]
  node_office_handler["Office handler<br/>[key_office.py]"]
end

subgraph group_config["Configuration"]
  node_config_api["Config access<br/>[load_config.py]"]
  node_config_file["Local config<br/>[config.json]"]
end

subgraph group_external["System and services"]
  node_key_service["Configuration service"]
  node_network["Connectivity hosts"]
  node_windows[("Windows registry")]
  node_licensing["Windows licensing"]
  node_restart["System restart"]
end

node_user(("User"))

node_user -->|"starts"| node_entry
node_entry -->|"renders"| node_menus
node_entry -->|"detects system"| node_system_ops
node_entry -->|"dispatches Windows"| node_controller
node_controller -->|"renders"| node_menus
node_controller -->|"continues activation"| node_kms_flow
node_kms_flow -->|"shows notices"| node_menus
node_kms_flow -->|"checks hosts; runs KMS"| node_system_ops
node_kms_flow -->|"loads product key"| node_config_api
node_system_ops -->|"reads system info"| node_windows
node_system_ops -->|"tests connectivity"| node_network
node_system_ops -->|"runs licensing commands"| node_licensing
node_system_ops -->|"requests reboot"| node_restart
node_config_api -->|"reads"| node_config_file
node_config_api -->|"fetches key configuration"| node_key_service

click node_entry "https://github.com/nesantime/blur_kms/blob/main/blur_kms.py"
click node_menus "https://github.com/nesantime/blur_kms/blob/main/resources/controller/animations.py"
click node_controller "https://github.com/nesantime/blur_kms/blob/main/resources/controller/controller.py"
click node_kms_flow "https://github.com/nesantime/blur_kms/blob/main/resources/controller/funciones/key_windows.py"
click node_system_ops "https://github.com/nesantime/blur_kms/blob/main/resources/controller/modules.py"
click node_office_handler "https://github.com/nesantime/blur_kms/blob/main/resources/controller/funciones/key_office.py"
click node_config_api "https://github.com/nesantime/blur_kms/blob/main/resources/files/load_config.py"
click node_config_file "https://github.com/nesantime/blur_kms/blob/main/resources/files/config.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_entry,node_menus,node_controller,node_user toneBlue
class node_kms_flow,node_system_ops,node_office_handler toneAmber
class node_config_api,node_config_file toneMint
class node_key_service,node_network,node_windows,node_licensing,node_restart toneRose
```

## Components

### CLI and menus

- [CLI entry](https://github.com/nesantime/blur_kms/blob/main/blur_kms.py): `blur_kms.py`
- [Menu rendering](https://github.com/nesantime/blur_kms/blob/main/resources/controller/animations.py): `resources/controller/animations.py`
- [Windows menu](https://github.com/nesantime/blur_kms/blob/main/resources/controller/controller.py): `resources/controller/controller.py`

### Windows activation

- [Activation flow](https://github.com/nesantime/blur_kms/blob/main/resources/controller/funciones/key_windows.py): `resources/controller/funciones/key_windows.py`
- [System and KMS ops](https://github.com/nesantime/blur_kms/blob/main/resources/controller/modules.py): `resources/controller/modules.py`
- [Office handler](https://github.com/nesantime/blur_kms/blob/main/resources/controller/funciones/key_office.py): `resources/controller/funciones/key_office.py`

### Configuration

- [Config access](https://github.com/nesantime/blur_kms/blob/main/resources/files/load_config.py): `resources/files/load_config.py`
- [Local config](https://github.com/nesantime/blur_kms/blob/main/resources/files/config.json): `resources/files/config.json`

### System and services

- **Configuration service**
- **Connectivity hosts**
- **Windows registry**
- **Windows licensing**
- **System restart**

### Other components

- **User**

## Connections

- User → CLI entry: starts
- CLI entry → Menu rendering: renders
- CLI entry → System and KMS ops: detects system
- CLI entry → Windows menu: dispatches Windows
- Windows menu → Menu rendering: renders
- Windows menu → Activation flow: continues activation
- Activation flow → Menu rendering: shows notices
- Activation flow → System and KMS ops: checks hosts; runs KMS
- Activation flow → Config access: loads product key
- System and KMS ops → Windows registry: reads system info
- System and KMS ops → Connectivity hosts: tests connectivity
- System and KMS ops → Windows licensing: runs licensing commands
- System and KMS ops → System restart: requests reboot
- Config access → Local config: reads
- Config access → Configuration service: fetches key configuration
