# lemxy/winrust architecture

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

- Interactive diagram: https://gitdiagram.com/lemxy/winrust
- Repository: https://github.com/lemxy/winrust

## Overview

WinRust is a Windows shell replacement delivered as native tools and an installer. The main user workflow is selecting components in the installer, applying their Windows integrations, then using the installed shell and utilities; uninstall reverses documented reversible changes. The graph preserves the documented tool families and Task Manager’s main internal layers. Several plugin implementations were not sampled, so their internal interactions are omitted; README-described product relationships are cited there.

Main entry points: [`src/install/mod.rs`](https://github.com/lemxy/winrust/blob/main/src/install/mod.rs) (Install And Restore), [`plugins/topbar/src/main.rs`](https://github.com/lemxy/winrust/blob/main/plugins/topbar/src/main.rs) (Topbar), [`plugins/rtaskmgr-win32/src/app.rs`](https://github.com/lemxy/winrust/blob/main/plugins/rtaskmgr-win32/src/app.rs) (Task Manager App), [`plugins/rust-explorer/src/main.rs`](https://github.com/lemxy/winrust/blob/main/plugins/rust-explorer/src/main.rs) (File Manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_installer["Installer"]
  node_launcher["Plugin Launcher<br/>[main.rs]"]
  node_install_ops["Install And Restore<br/>[mod.rs]"]
end

subgraph group_shell["Shell Experience"]
  node_topbar["Topbar<br/>[main.rs]"]
  node_reshell["Hotkeys And Recovery<br/>[main.rs]"]
  node_explorer["File Manager<br/>[main.rs]"]
  node_search["File Search<br/>[main.rs]"]
end

subgraph group_system_tools["System Tools"]
  node_taskmgr_app["Task Manager App<br/>[app.rs]"]
  node_taskmgr_data["System Data<br/>[data.rs]"]
  node_taskmgr_model["Task Manager Model<br/>[model.rs]"]
  node_taskmgr_startup["Startup Inspection<br/>[startup.rs]"]
  node_taskmgr_perf["Performance Metrics<br/>[perf.rs]"]
  node_disk_cleaner["Disk Cleaner<br/>[main.rs]"]
  node_disk_map["Disk Usage Map<br/>[main.rs]"]
  node_debloat["Debloat Tool<br/>[main.rs]"]
  node_purge["App Purge<br/>[main.rs]"]
end

subgraph group_settings_media["Settings And Media"]
  node_settings["Rust Settings<br/>[main.rs]"]
  node_photo["Photo Viewer<br/>[main.rs]"]
  node_common_style["Shared Styles<br/>[style.rs]"]
end

subgraph group_browser["Browser"]
  node_browser["Chrome-RS Browser<br/>[main.rs]"]
  node_browser_css["CSS Engine<br/>[css.rs]"]
end

node_user(("Windows User"))
node_windows(("Windows"))

node_user -->|"selects components"| node_launcher
node_launcher -->|"runs install actions"| node_install_ops
node_install_ops -->|"installs or restores"| node_topbar
node_install_ops -->|"installs or restores"| node_explorer
node_install_ops -->|"installs or restores"| node_search
node_install_ops -->|"installs or restores"| node_taskmgr_app
node_install_ops -->|"installs or restores"| node_settings
node_install_ops -->|"installs or restores"| node_photo
node_install_ops -->|"installs or restores"| node_disk_map
node_install_ops -->|"installs or restores"| node_debloat
node_install_ops -->|"runs command"| node_purge
node_topbar -->|"opens file manager"| node_explorer
node_topbar -->|"opens settings"| node_settings
node_topbar -.->|"uses shared style"| node_common_style
node_taskmgr_app -->|"reads system data"| node_taskmgr_data
node_taskmgr_app -->|"uses UI model"| node_taskmgr_model
node_taskmgr_app -->|"uses startup data"| node_taskmgr_startup
node_taskmgr_data -->|"samples metrics"| node_taskmgr_perf
node_taskmgr_model -->|"builds rows from"| node_taskmgr_data
node_taskmgr_app -->|"installs alongside"| node_disk_cleaner
node_reshell -->|"manages shell behavior"| node_windows
node_explorer -->|"replaces shell"| node_windows
node_topbar -->|"replaces taskbar"| node_windows
node_browser -->|"uses CSS engine"| node_browser_css

click node_launcher "https://github.com/lemxy/winrust/blob/main/src/main.rs"
click node_install_ops "https://github.com/lemxy/winrust/blob/main/src/install/mod.rs"
click node_topbar "https://github.com/lemxy/winrust/blob/main/plugins/topbar/src/main.rs"
click node_reshell "https://github.com/lemxy/winrust/blob/main/ReShell/src/main.rs"
click node_explorer "https://github.com/lemxy/winrust/blob/main/plugins/rust-explorer/src/main.rs"
click node_search "https://github.com/lemxy/winrust/blob/main/plugins/rust-search/src/main.rs"
click node_taskmgr_app "https://github.com/lemxy/winrust/blob/main/plugins/rtaskmgr-win32/src/app.rs"
click node_taskmgr_data "https://github.com/lemxy/winrust/blob/main/plugins/rtaskmgr-win32/src/data.rs"
click node_taskmgr_model "https://github.com/lemxy/winrust/blob/main/plugins/rtaskmgr-win32/src/model.rs"
click node_taskmgr_startup "https://github.com/lemxy/winrust/blob/main/plugins/rtaskmgr-win32/src/startup.rs"
click node_taskmgr_perf "https://github.com/lemxy/winrust/blob/main/plugins/rtaskmgr-win32/src/perf.rs"
click node_disk_cleaner "https://github.com/lemxy/winrust/blob/main/plugins/rs-du/src/main.rs"
click node_disk_map "https://github.com/lemxy/winrust/blob/main/plugins/wiztree/src/main.rs"
click node_debloat "https://github.com/lemxy/winrust/blob/main/plugins/debloat/src/main.rs"
click node_purge "https://github.com/lemxy/winrust/blob/main/plugins/purge/src/main.rs"
click node_settings "https://github.com/lemxy/winrust/blob/main/plugins/rust-settings/src/main.rs"
click node_photo "https://github.com/lemxy/winrust/blob/main/plugins/photoview/src/main.rs"
click node_common_style "https://github.com/lemxy/winrust/blob/main/common/src/style.rs"
click node_browser "https://github.com/lemxy/winrust/blob/main/plugins/chrome-rs/src/main.rs"
click node_browser_css "https://github.com/lemxy/winrust/blob/main/plugins/chrome-rs/src/css.rs"

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_launcher,node_install_ops,node_user toneBlue
class node_topbar,node_reshell,node_explorer,node_search toneAmber
class node_taskmgr_app,node_taskmgr_data,node_taskmgr_model,node_taskmgr_startup,node_taskmgr_perf,node_disk_cleaner,node_disk_map,node_debloat,node_purge toneMint
class node_settings,node_photo,node_common_style toneRose
class node_browser,node_browser_css,node_windows toneIndigo
```

## Components

### Installer

- [Plugin Launcher](https://github.com/lemxy/winrust/blob/main/src/main.rs): `src/main.rs`
- [Install And Restore](https://github.com/lemxy/winrust/blob/main/src/install/mod.rs): `src/install/mod.rs`

### Shell Experience

- [Topbar](https://github.com/lemxy/winrust/blob/main/plugins/topbar/src/main.rs): `plugins/topbar/src/main.rs`
- [Hotkeys And Recovery](https://github.com/lemxy/winrust/blob/main/ReShell/src/main.rs): `ReShell/src/main.rs`
- [File Manager](https://github.com/lemxy/winrust/blob/main/plugins/rust-explorer/src/main.rs): `plugins/rust-explorer/src/main.rs`
- [File Search](https://github.com/lemxy/winrust/blob/main/plugins/rust-search/src/main.rs): `plugins/rust-search/src/main.rs`

### System Tools

- [Task Manager App](https://github.com/lemxy/winrust/blob/main/plugins/rtaskmgr-win32/src/app.rs): `plugins/rtaskmgr-win32/src/app.rs`
- [System Data](https://github.com/lemxy/winrust/blob/main/plugins/rtaskmgr-win32/src/data.rs): `plugins/rtaskmgr-win32/src/data.rs`
- [Task Manager Model](https://github.com/lemxy/winrust/blob/main/plugins/rtaskmgr-win32/src/model.rs): `plugins/rtaskmgr-win32/src/model.rs`
- [Startup Inspection](https://github.com/lemxy/winrust/blob/main/plugins/rtaskmgr-win32/src/startup.rs): `plugins/rtaskmgr-win32/src/startup.rs`
- [Performance Metrics](https://github.com/lemxy/winrust/blob/main/plugins/rtaskmgr-win32/src/perf.rs): `plugins/rtaskmgr-win32/src/perf.rs`
- [Disk Cleaner](https://github.com/lemxy/winrust/blob/main/plugins/rs-du/src/main.rs): `plugins/rs-du/src/main.rs`
- [Disk Usage Map](https://github.com/lemxy/winrust/blob/main/plugins/wiztree/src/main.rs): `plugins/wiztree/src/main.rs`
- [Debloat Tool](https://github.com/lemxy/winrust/blob/main/plugins/debloat/src/main.rs): `plugins/debloat/src/main.rs`
- [App Purge](https://github.com/lemxy/winrust/blob/main/plugins/purge/src/main.rs): `plugins/purge/src/main.rs`

### Settings And Media

- [Rust Settings](https://github.com/lemxy/winrust/blob/main/plugins/rust-settings/src/main.rs): `plugins/rust-settings/src/main.rs`
- [Photo Viewer](https://github.com/lemxy/winrust/blob/main/plugins/photoview/src/main.rs): `plugins/photoview/src/main.rs`
- [Shared Styles](https://github.com/lemxy/winrust/blob/main/common/src/style.rs): `common/src/style.rs`

### Browser

- [Chrome-RS Browser](https://github.com/lemxy/winrust/blob/main/plugins/chrome-rs/src/main.rs): `plugins/chrome-rs/src/main.rs`
- [CSS Engine](https://github.com/lemxy/winrust/blob/main/plugins/chrome-rs/src/css.rs): `plugins/chrome-rs/src/css.rs`

### Other components

- **Windows User**
- **Windows**

## Connections

- Windows User → Plugin Launcher: selects components (evidence: `README.md`)
- Plugin Launcher → Install And Restore: runs install actions (evidence: `src/main.rs`)
- Install And Restore → Topbar: installs or restores (evidence: `README.md`)
- Install And Restore → File Manager: installs or restores (evidence: `README.md`)
- Install And Restore → File Search: installs or restores (evidence: `README.md`)
- Install And Restore → Task Manager App: installs or restores (evidence: `README.md`)
- Install And Restore → Rust Settings: installs or restores (evidence: `README.md`)
- Install And Restore → Photo Viewer: installs or restores (evidence: `README.md`)
- Install And Restore → Disk Usage Map: installs or restores (evidence: `README.md`)
- Install And Restore → Debloat Tool: installs or restores (evidence: `README.md`)
- Install And Restore → App Purge: runs command (evidence: `README.md`)
- Topbar → File Manager: opens file manager (evidence: `README.md`)
- Topbar → Rust Settings: opens settings (evidence: `README.md`)
- Topbar → Shared Styles: uses shared style
- Task Manager App → System Data: reads system data (evidence: `plugins/rtaskmgr-win32/src/app.rs`)
- Task Manager App → Task Manager Model: uses UI model (evidence: `plugins/rtaskmgr-win32/src/app.rs`)
- Task Manager App → Startup Inspection: uses startup data (evidence: `plugins/rtaskmgr-win32/src/app.rs`)
- System Data → Performance Metrics: samples metrics (evidence: `plugins/rtaskmgr-win32/src/data.rs`)
- Task Manager Model → System Data: builds rows from (evidence: `plugins/rtaskmgr-win32/src/model.rs`)
- Task Manager App → Disk Cleaner: installs alongside (evidence: `README.md`)
- Hotkeys And Recovery → Windows: manages shell behavior (evidence: `README.md`)
- File Manager → Windows: replaces shell (evidence: `README.md`)
- Topbar → Windows: replaces taskbar (evidence: `README.md`)
- Chrome-RS Browser → CSS Engine: uses CSS engine (evidence: `plugins/chrome-rs/src/main.rs`)
