# regulus-forteen/windows-r-tools-box architecture

> Architecture diagram of the GitHub repository regulus-forteen/windows-r-tools-box, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/regulus-forteen/windows-r-tools-box
- Repository: https://github.com/regulus-forteen/windows-r-tools-box

## Overview

Windows R-tools Box is a Windows desktop toolbox combining a webview dashboard, system information, configurable web search and favorite sites, and a catalog of modular tools. The principal workflow is a user interacting with the dashboard, which calls the Python API; the API obtains system information and tool listings through utility functions and reads settings and search/site definitions from configuration. Tool metadata is organized by category. The excerpts show the dashboard/API boundary and utility behavior, but do not establish how individual tools are executed, so those runtime links are omitted.

Main entry points: [`main/tools`](https://github.com/regulus-forteen/windows-r-tools-box/tree/main/main/tools) (Tool metadata), [`main/main.py`](https://github.com/regulus-forteen/windows-r-tools-box/blob/main/main/main.py) (Dashboard API), [`main/config.py`](https://github.com/regulus-forteen/windows-r-tools-box/blob/main/main/config.py) (App configuration), [`main/utils.py`](https://github.com/regulus-forteen/windows-r-tools-box/blob/main/main/utils.py) (System information)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Desktop dashboard"]
  node_dashboard_ui["Dashboard UI<br/>[main.py]"]
  node_desktop_host["Webview host<br/>[main.py]"]
end

subgraph group_services["Application services"]
  node_api["Dashboard API<br/>[main.py]"]
  node_configuration["App configuration<br/>[config.py]"]
  node_config_file["User settings<br/>[config.json]"]
  node_utilities["Utility functions<br/>[utils.py]"]
  node_system_info["System information<br/>[utils.py]"]
end

subgraph group_catalog["Tool catalog"]
  node_tool_scanner["Tool scanner<br/>[utils.py]"]
  node_tool_metadata["Tool metadata"]
  node_system_tools["System tools"]
  node_security_tools["Security tools"]
  node_network_tools["Network tools"]
  node_utility_tools["Utility tools"]
end

node_user(("Windows user"))

node_user -->|"uses"| node_dashboard_ui
node_dashboard_ui -->|"calls"| node_api
node_desktop_host -.->|"hosts"| node_dashboard_ui
node_api -->|"reads"| node_configuration
node_configuration -->|"loads"| node_config_file
node_api -->|"scans tools"| node_tool_scanner
node_api -->|"gets system info"| node_system_info
node_system_info -->|"formats results"| node_utilities
node_tool_scanner -->|"reads metadata"| node_tool_metadata
node_tool_metadata -.->|"includes"| node_system_tools
node_tool_metadata -.->|"includes"| node_security_tools
node_tool_metadata -.->|"includes"| node_network_tools
node_tool_metadata -.->|"includes"| node_utility_tools

click node_dashboard_ui "https://github.com/regulus-forteen/windows-r-tools-box/blob/main/main/main.py"
click node_desktop_host "https://github.com/regulus-forteen/windows-r-tools-box/blob/main/main/main.py"
click node_api "https://github.com/regulus-forteen/windows-r-tools-box/blob/main/main/main.py"
click node_configuration "https://github.com/regulus-forteen/windows-r-tools-box/blob/main/main/config.py"
click node_config_file "https://github.com/regulus-forteen/windows-r-tools-box/blob/main/main/config.json"
click node_utilities "https://github.com/regulus-forteen/windows-r-tools-box/blob/main/main/utils.py"
click node_system_info "https://github.com/regulus-forteen/windows-r-tools-box/blob/main/main/utils.py"
click node_tool_scanner "https://github.com/regulus-forteen/windows-r-tools-box/blob/main/main/utils.py"
click node_tool_metadata "https://github.com/regulus-forteen/windows-r-tools-box/tree/main/main/tools"
click node_system_tools "https://github.com/regulus-forteen/windows-r-tools-box/tree/main/main/tools/system"
click node_security_tools "https://github.com/regulus-forteen/windows-r-tools-box/tree/main/main/tools/security"
click node_network_tools "https://github.com/regulus-forteen/windows-r-tools-box/tree/main/main/tools/network"
click node_utility_tools "https://github.com/regulus-forteen/windows-r-tools-box/tree/main/main/tools/utilities"

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_dashboard_ui,node_desktop_host,node_user toneBlue
class node_api,node_configuration,node_config_file,node_utilities,node_system_info toneAmber
class node_tool_scanner,node_tool_metadata,node_system_tools,node_security_tools,node_network_tools,node_utility_tools toneMint
```

## Components

### Desktop dashboard

- [Dashboard UI](https://github.com/regulus-forteen/windows-r-tools-box/blob/main/main/main.py): `main/main.py`
- [Webview host](https://github.com/regulus-forteen/windows-r-tools-box/blob/main/main/main.py): `main/main.py`

### Application services

- [Dashboard API](https://github.com/regulus-forteen/windows-r-tools-box/blob/main/main/main.py): `main/main.py`
- [App configuration](https://github.com/regulus-forteen/windows-r-tools-box/blob/main/main/config.py): `main/config.py`
- [User settings](https://github.com/regulus-forteen/windows-r-tools-box/blob/main/main/config.json): `main/config.json`
- [Utility functions](https://github.com/regulus-forteen/windows-r-tools-box/blob/main/main/utils.py): `main/utils.py`
- [System information](https://github.com/regulus-forteen/windows-r-tools-box/blob/main/main/utils.py): `main/utils.py`

### Tool catalog

- [Tool scanner](https://github.com/regulus-forteen/windows-r-tools-box/blob/main/main/utils.py): `main/utils.py`
- [Tool metadata](https://github.com/regulus-forteen/windows-r-tools-box/tree/main/main/tools): `main/tools`
- [System tools](https://github.com/regulus-forteen/windows-r-tools-box/tree/main/main/tools/system): `main/tools/system`
- [Security tools](https://github.com/regulus-forteen/windows-r-tools-box/tree/main/main/tools/security): `main/tools/security`
- [Network tools](https://github.com/regulus-forteen/windows-r-tools-box/tree/main/main/tools/network): `main/tools/network`
- [Utility tools](https://github.com/regulus-forteen/windows-r-tools-box/tree/main/main/tools/utilities): `main/tools/utilities`

### Other components

- **Windows user**

## Connections

- Windows user → Dashboard UI: uses (evidence: `README.md`)
- Dashboard UI → Dashboard API: calls (evidence: `main/main.py`)
- Webview host → Dashboard UI: hosts (evidence: `main/main.py`)
- Dashboard API → App configuration: reads (evidence: `main/main.py`)
- App configuration → User settings: loads (evidence: `main/config.py`)
- Dashboard API → Tool scanner: scans tools (evidence: `main/main.py`)
- Dashboard API → System information: gets system info (evidence: `main/main.py`)
- System information → Utility functions: formats results (evidence: `main/utils.py`)
- Tool scanner → Tool metadata: reads metadata (evidence: `main/utils.py`)
- Tool metadata → System tools: includes
- Tool metadata → Security tools: includes
- Tool metadata → Network tools: includes
- Tool metadata → Utility tools: includes