# vuphitung/cyberclean architecture

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

- Interactive diagram: https://gitdiagram.com/vuphitung/cyberclean
- Repository: https://github.com/vuphitung/cyberclean

## Overview

CyberClean is a cross-platform desktop system cleaner and performance utility. Users launch the PyQt application, inspect live system information, then run previews and selected cleanups, scans, uninstalls, or reversible tuning actions. The README also documents idle auto-clean, history, tray operation, and signed opt-in updates. Edges follow explicit imports and shown calls or README capability statements; several internal UI-to-feature details are unsampled, so uncertain links are omitted.

Main entry points: [`main.py`](https://github.com/vuphitung/cyberclean/blob/main/main.py) (Application shell), [`core/linux_cleaner.py`](https://github.com/vuphitung/cyberclean/blob/main/core/linux_cleaner.py) (Linux cleaner), [`ui_widgets.py`](https://github.com/vuphitung/cyberclean/blob/main/ui_widgets.py) (Feature UI), [`core/windows_cleaner.py`](https://github.com/vuphitung/cyberclean/blob/main/core/windows_cleaner.py) (Windows cleaner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop app"]
  node_main["Application shell<br/>[main.py]"]
  node_widgets["Feature UI<br/>[ui_widgets.py]"]
  node_gameui["Game mode UI"]
  node_translations["Translations<br/>[i18n.py]"]
end

subgraph group_maintenance["Cleaning and apps"]
  node_cleanbase["Cleaner interface<br/>[base_cleaner.py]"]
  node_linuxclean["Linux cleaner<br/>[linux_cleaner.py]"]
  node_windowsclean["Windows cleaner<br/>[windows_cleaner.py]"]
  node_history["Clean history<br/>[main.py]"]
  node_uninstaller["App uninstaller<br/>[uninstaller.py]"]
end

subgraph group_security["Security"]
  node_scanner["Threat scanner<br/>[scanner.py]"]
end

subgraph group_performance["Performance"]
  node_booster["System booster<br/>[booster.py]"]
  node_analyzer["Idle scheduler<br/>[analyzer.py]"]
end

subgraph group_platform["System services"]
  node_sysinfo["System snapshot<br/>[sysinfo.py]"]
  node_osdetect["Platform detection<br/>[os_detect.py]"]
  node_updater["Signed updater<br/>[updater.py]"]
end

node_user(("User"))
node_github["GitHub Releases"]
node_operating_system["Operating system"]

node_user -->|"launches"| node_main
node_main -->|"uses UI"| node_widgets
node_main -->|"reads stats"| node_sysinfo
node_main -->|"starts scans"| node_scanner
node_main -->|"starts uninstall"| node_uninstaller
node_main -->|"checks updates"| node_updater
node_main -->|"uses scheduler"| node_analyzer
node_main -->|"starts tuning"| node_booster
node_main -->|"embeds page"| node_gameui
node_main -.->|"selects cleaner"| node_linuxclean
node_main -.->|"selects cleaner"| node_windowsclean
node_main -.->|"translates UI"| node_translations
node_widgets -->|"previews and cleans"| node_linuxclean
node_widgets -->|"parallel estimates"| node_cleanbase
node_linuxclean -->|"implements"| node_cleanbase
node_windowsclean -->|"implements"| node_cleanbase
node_linuxclean -->|"checks platform"| node_osdetect
node_scanner -->|"checks platform"| node_osdetect
node_uninstaller -->|"checks platform"| node_osdetect
node_gameui -->|"uses tuning"| node_booster
node_sysinfo -.->|"reads metrics"| node_operating_system
node_linuxclean -.->|"cleans system"| node_operating_system
node_windowsclean -.->|"cleans system"| node_operating_system
node_booster -.->|"adjusts settings"| node_operating_system
node_updater -->|"checks releases"| node_github
node_widgets -.->|"logs deletions"| node_history
node_analyzer -.->|"monitors activity"| node_operating_system
node_user -.->|"requests update"| node_updater

click node_main "https://github.com/vuphitung/cyberclean/blob/main/main.py"
click node_widgets "https://github.com/vuphitung/cyberclean/blob/main/ui_widgets.py"
click node_gameui "https://github.com/vuphitung/cyberclean/blob/main/core/game_boost_widget.py"
click node_translations "https://github.com/vuphitung/cyberclean/blob/main/utils/i18n.py"
click node_cleanbase "https://github.com/vuphitung/cyberclean/blob/main/core/base_cleaner.py"
click node_linuxclean "https://github.com/vuphitung/cyberclean/blob/main/core/linux_cleaner.py"
click node_windowsclean "https://github.com/vuphitung/cyberclean/blob/main/core/windows_cleaner.py"
click node_history "https://github.com/vuphitung/cyberclean/blob/main/main.py"
click node_uninstaller "https://github.com/vuphitung/cyberclean/blob/main/core/uninstaller.py"
click node_scanner "https://github.com/vuphitung/cyberclean/blob/main/core/scanner.py"
click node_booster "https://github.com/vuphitung/cyberclean/blob/main/core/booster.py"
click node_analyzer "https://github.com/vuphitung/cyberclean/blob/main/core/analyzer.py"
click node_sysinfo "https://github.com/vuphitung/cyberclean/blob/main/utils/sysinfo.py"
click node_osdetect "https://github.com/vuphitung/cyberclean/blob/main/core/os_detect.py"
click node_updater "https://github.com/vuphitung/cyberclean/blob/main/utils/updater.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_main,node_widgets,node_gameui,node_translations,node_user toneBlue
class node_cleanbase,node_linuxclean,node_windowsclean,node_history,node_uninstaller toneAmber
class node_scanner toneMint
class node_booster,node_analyzer toneRose
class node_sysinfo,node_osdetect,node_updater,node_github,node_operating_system toneIndigo
```

## Components

### Desktop app

- [Application shell](https://github.com/vuphitung/cyberclean/blob/main/main.py): `main.py`
- [Feature UI](https://github.com/vuphitung/cyberclean/blob/main/ui_widgets.py): `ui_widgets.py`
- [Game mode UI](https://github.com/vuphitung/cyberclean/blob/main/core/game_boost_widget.py): `core/game_boost_widget.py`
- [Translations](https://github.com/vuphitung/cyberclean/blob/main/utils/i18n.py): `utils/i18n.py`

### Cleaning and apps

- [Cleaner interface](https://github.com/vuphitung/cyberclean/blob/main/core/base_cleaner.py): `core/base_cleaner.py`
- [Linux cleaner](https://github.com/vuphitung/cyberclean/blob/main/core/linux_cleaner.py): `core/linux_cleaner.py`
- [Windows cleaner](https://github.com/vuphitung/cyberclean/blob/main/core/windows_cleaner.py): `core/windows_cleaner.py`
- [Clean history](https://github.com/vuphitung/cyberclean/blob/main/main.py): `main.py`
- [App uninstaller](https://github.com/vuphitung/cyberclean/blob/main/core/uninstaller.py): `core/uninstaller.py`

### Security

- [Threat scanner](https://github.com/vuphitung/cyberclean/blob/main/core/scanner.py): `core/scanner.py`

### Performance

- [System booster](https://github.com/vuphitung/cyberclean/blob/main/core/booster.py): `core/booster.py`
- [Idle scheduler](https://github.com/vuphitung/cyberclean/blob/main/core/analyzer.py): `core/analyzer.py`

### System services

- [System snapshot](https://github.com/vuphitung/cyberclean/blob/main/utils/sysinfo.py): `utils/sysinfo.py`
- [Platform detection](https://github.com/vuphitung/cyberclean/blob/main/core/os_detect.py): `core/os_detect.py`
- [Signed updater](https://github.com/vuphitung/cyberclean/blob/main/utils/updater.py): `utils/updater.py`

### Other components

- **User**
- **GitHub Releases**
- **Operating system**

## Connections

- User → Application shell: launches (evidence: `README.md`)
- Application shell → Feature UI: uses UI (evidence: `main.py`)
- Application shell → System snapshot: reads stats (evidence: `main.py`)
- Application shell → Threat scanner: starts scans (evidence: `main.py`)
- Application shell → App uninstaller: starts uninstall (evidence: `main.py`)
- Application shell → Signed updater: checks updates (evidence: `main.py`)
- Application shell → Idle scheduler: uses scheduler (evidence: `main.py`)
- Application shell → System booster: starts tuning (evidence: `main.py`)
- Application shell → Game mode UI: embeds page (evidence: `main.py`)
- Application shell → Linux cleaner: selects cleaner (evidence: `main.py`)
- Application shell → Windows cleaner: selects cleaner (evidence: `main.py`)
- Application shell → Translations: translates UI (evidence: `main.py`)
- Feature UI → Linux cleaner: previews and cleans (evidence: `ui_widgets.py`)
- Feature UI → Cleaner interface: parallel estimates (evidence: `ui_widgets.py`)
- Linux cleaner → Cleaner interface: implements (evidence: `core/linux_cleaner.py`)
- Windows cleaner → Cleaner interface: implements (evidence: `core/windows_cleaner.py`)
- Linux cleaner → Platform detection: checks platform (evidence: `core/linux_cleaner.py`)
- Threat scanner → Platform detection: checks platform (evidence: `core/scanner.py`)
- App uninstaller → Platform detection: checks platform (evidence: `core/uninstaller.py`)
- Game mode UI → System booster: uses tuning (evidence: `core/game_boost_widget.py`)
- System snapshot → Operating system: reads metrics
- Linux cleaner → Operating system: cleans system
- Windows cleaner → Operating system: cleans system
- System booster → Operating system: adjusts settings
- Signed updater → GitHub Releases: checks releases (evidence: `utils/updater.py`)
- Feature UI → Clean history: logs deletions (evidence: `main.py`)
- Idle scheduler → Operating system: monitors activity
- User → Signed updater: requests update