# kiowx/c_cleaner_plus architecture

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

- Interactive diagram: https://gitdiagram.com/kiowx/c_cleaner_plus
- Repository: https://github.com/kiowx/c_cleaner_plus

## Overview

C Cleaner Plus is a Windows GUI utility for storage cleanup and maintenance. The main user workflow is to select a cleanup or checkup task, review findings or a proposed plan, then execute selected actions and inspect results. Its documented product also includes large-file scanning, advanced cleanup, application uninstall, scheduled tasks, and downloadable rule packs. The sampled code shows the checkup-to-analysis and maintenance-UI-to-core boundaries; several other capability implementations were not sampled, so their links are limited to documented relationships.

Main entry points: [`cleaner_core.py`](https://github.com/kiowx/c_cleaner_plus/blob/main/cleaner_core.py) (Regular cleanup), [`main.py`](https://github.com/kiowx/c_cleaner_plus/blob/main/main.py) (Application entry), [`checkup_ui.py`](https://github.com/kiowx/c_cleaner_plus/blob/main/checkup_ui.py) (One-click checkup UI), [`config`](https://github.com/kiowx/c_cleaner_plus/tree/main/config) (Built-in rule packs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Application UI"]
  node_app["Application entry<br/>[main.py]"]
  node_checkup_ui["One-click checkup UI<br/>[checkup_ui.py]"]
  node_maintenance_ui["Maintenance tools UI<br/>[maintenance_ui.py]"]
end

subgraph group_cleanup["Cleanup and Scan"]
  node_regular["Regular cleanup<br/>[cleaner_core.py]"]
  node_analysis["Checkup analysis<br/>[health_check.py]"]
  node_large_scan["Large-file scan<br/>[main.rs]"]
  node_advanced_cleanup["More cleanup tools<br/>[main.py]"]
end

subgraph group_maintenance["Maintenance Services"]
  node_maintenance_core["Maintenance services<br/>[cleaner_core.py]"]
  node_uninstall["Application uninstall<br/>[main.py]"]
  node_scheduler["Scheduled tasks<br/>[main.py]"]
end

subgraph group_rules["Rules and Settings"]
  node_rule_configs["Built-in rule packs"]
  node_rule_store["Rule store<br/>[main.py]"]
  node_settings["Interface settings<br/>[main.py]"]
end

node_user(("Windows user"))
node_remote_rules["Remote rule service"]
node_windows_storage[("Windows storage")]

node_user -->|"launches"| node_app
node_app -->|"opens by default"| node_regular
node_app -->|"opens from toolbox"| node_checkup_ui
node_checkup_ui -->|"scans and plans"| node_analysis
node_checkup_ui -->|"creates cleanup plan"| node_maintenance_core
node_maintenance_ui -->|"calls services"| node_maintenance_core
node_regular -.->|"cleans files"| node_windows_storage
node_large_scan -.->|"scans volumes"| node_windows_storage
node_advanced_cleanup -.->|"scans and cleans"| node_windows_storage
node_uninstall -.->|"removes leftovers"| node_windows_storage
node_scheduler -.->|"runs cleanup"| node_regular
node_scheduler -.->|"runs selected tasks"| node_advanced_cleanup
node_rule_configs -.->|"defines cleanup rules"| node_regular
node_rule_store -.->|"downloads packs"| node_remote_rules
node_rule_store -.->|"imports packs"| node_rule_configs
node_settings -.->|"configures preview"| node_regular

click node_app "https://github.com/kiowx/c_cleaner_plus/blob/main/main.py"
click node_regular "https://github.com/kiowx/c_cleaner_plus/blob/main/cleaner_core.py"
click node_checkup_ui "https://github.com/kiowx/c_cleaner_plus/blob/main/checkup_ui.py"
click node_analysis "https://github.com/kiowx/c_cleaner_plus/blob/main/health_check.py"
click node_maintenance_ui "https://github.com/kiowx/c_cleaner_plus/blob/main/maintenance_ui.py"
click node_maintenance_core "https://github.com/kiowx/c_cleaner_plus/blob/main/cleaner_core.py"
click node_large_scan "https://github.com/kiowx/c_cleaner_plus/blob/main/tools/fast_large_files/src/main.rs"
click node_advanced_cleanup "https://github.com/kiowx/c_cleaner_plus/blob/main/main.py"
click node_uninstall "https://github.com/kiowx/c_cleaner_plus/blob/main/main.py"
click node_scheduler "https://github.com/kiowx/c_cleaner_plus/blob/main/main.py"
click node_rule_configs "https://github.com/kiowx/c_cleaner_plus/tree/main/config"
click node_rule_store "https://github.com/kiowx/c_cleaner_plus/blob/main/main.py"
click node_settings "https://github.com/kiowx/c_cleaner_plus/blob/main/main.py"

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_app,node_checkup_ui,node_maintenance_ui,node_user toneBlue
class node_regular,node_analysis,node_large_scan,node_advanced_cleanup,node_windows_storage toneAmber
class node_maintenance_core,node_uninstall,node_scheduler toneMint
class node_rule_configs,node_rule_store,node_settings toneRose
class node_remote_rules toneIndigo
```

## Components

### Application UI

- [Application entry](https://github.com/kiowx/c_cleaner_plus/blob/main/main.py): `main.py`
- [One-click checkup UI](https://github.com/kiowx/c_cleaner_plus/blob/main/checkup_ui.py): `checkup_ui.py`
- [Maintenance tools UI](https://github.com/kiowx/c_cleaner_plus/blob/main/maintenance_ui.py): `maintenance_ui.py`

### Cleanup and Scan

- [Regular cleanup](https://github.com/kiowx/c_cleaner_plus/blob/main/cleaner_core.py): `cleaner_core.py`
- [Checkup analysis](https://github.com/kiowx/c_cleaner_plus/blob/main/health_check.py): `health_check.py`
- [Large-file scan](https://github.com/kiowx/c_cleaner_plus/blob/main/tools/fast_large_files/src/main.rs): `tools/fast_large_files/src/main.rs`
- [More cleanup tools](https://github.com/kiowx/c_cleaner_plus/blob/main/main.py): `main.py`

### Maintenance Services

- [Maintenance services](https://github.com/kiowx/c_cleaner_plus/blob/main/cleaner_core.py): `cleaner_core.py`
- [Application uninstall](https://github.com/kiowx/c_cleaner_plus/blob/main/main.py): `main.py`
- [Scheduled tasks](https://github.com/kiowx/c_cleaner_plus/blob/main/main.py): `main.py`

### Rules and Settings

- [Built-in rule packs](https://github.com/kiowx/c_cleaner_plus/tree/main/config): `config`
- [Rule store](https://github.com/kiowx/c_cleaner_plus/blob/main/main.py): `main.py`
- [Interface settings](https://github.com/kiowx/c_cleaner_plus/blob/main/main.py): `main.py`

### Other components

- **Windows user**
- **Remote rule service**
- **Windows storage**

## Connections

- Windows user → Application entry: launches (evidence: `README.md`)
- Application entry → Regular cleanup: opens by default (evidence: `README.md`)
- Application entry → One-click checkup UI: opens from toolbox (evidence: `README.md`)
- One-click checkup UI → Checkup analysis: scans and plans (evidence: `checkup_ui.py`)
- One-click checkup UI → Maintenance services: creates cleanup plan (evidence: `checkup_ui.py`)
- Maintenance tools UI → Maintenance services: calls services (evidence: `maintenance_ui.py`)
- Regular cleanup → Windows storage: cleans files (evidence: `README.md`)
- Large-file scan → Windows storage: scans volumes (evidence: `README.md`)
- More cleanup tools → Windows storage: scans and cleans (evidence: `README.md`)
- Application uninstall → Windows storage: removes leftovers (evidence: `README.md`)
- Scheduled tasks → Regular cleanup: runs cleanup (evidence: `README.md`)
- Scheduled tasks → More cleanup tools: runs selected tasks (evidence: `README.md`)
- Built-in rule packs → Regular cleanup: defines cleanup rules (evidence: `README.md`)
- Rule store → Remote rule service: downloads packs (evidence: `README.md`)
- Rule store → Built-in rule packs: imports packs (evidence: `README.md`)
- Interface settings → Regular cleanup: configures preview (evidence: `README.md`)