PRS SYSTEM — Advanced PC Performance Monitor

A production-grade, cyberpunk-themed desktop application and CLI tool for real-time hardware telemetry. Built with PyQt6, pyqtgraph, psutil, GPUtil and WMI — every hardware query runs on a dedicated background QThread, so the interface never freezes.

prs system          →  opens the performance dashboard (GUI)
prs                 →  native "command not recognized" error on stderr
prs hi              →  same native error, naming the full invocation
                       (byte-exact PowerShell format on Windows)

Features

Alerting

An audible warning beep (via winsound on Windows) fires when CPU / RAM / Disk load exceeds 85% or battery drops below 15% (thresholds are configurable).

Installation

# 1. (Recommended) create a virtual environment
python -m venv .venv
.venv\Scripts\activate          # Windows
source .venv/bin/activate       # macOS / Linux

# 2. install the package (pulls PyQt6, pyqtgraph, psutil, GPUtil, WMI)
pip install -e .

# 3. run it
prs system

To run without installing, the same entry point works from the repo root:

python main.py

Note for Linux users: temperature and battery sensors require the lm-sensors / acpi tooling to be present; the app degrades gracefully to "N/A" when a sensor is unavailable.

CLI usage

Two libraries share the prs command and delegate to each other at runtime (no subprocess spawning):

• prs-system owns prs system (GUI) and prs help
• prs-tree-explorer owns every tree command - when installed (pip install prs-tree-explorer), typing prs prints the tree of the current directory and prs <path> prints the tree of that path (unquoted paths containing spaces are reconstructed automatically); otherwise prs-system falls back to the native "command not recognized" error

prs system              Launch the performance dashboard (GUI)
prs                     Directory tree of current dir (via prs-tree-explorer)
prs <path>              Directory tree of that path (via prs-tree-explorer)
prs help | -h | --help  Show package help
prs <anything else>     Delegated to prs-tree-explorer; or the native
                        "command not recognized" error if it is not installed

The error output matches what the shell itself prints: PowerShell's ObjectNotFound: (<cmd>:String) [], CommandNotFoundException block on Windows, bash: <cmd>: command not found on macOS/Linux. It is written directly to stderr without spawning any subprocess.

Coexistence note: both packages register a prs console script, so the one installed last owns the prs shim on PATH. Each package delegates to the other by import, so either install order works - prs-system delegates bare prs to prs-tree-explorer, and prs-tree-explorer should route prs system back to prs_system.gui.

Themes

Five built-in glassmorphism themes, switchable live from Settings:

1. Cyber Blue — neon cyan #00F0FF + purple on deep AMOLED #0B0E14
2. Neon Green — phosphor green on dark emerald
3. Orange Racing — hot orange on carbon black
4. AMOLED Black — pure black with blue/violet accents (OLED-friendly)
5. Glass Mode — frosted translucent cards over a deep blue gradient

Project layout

prs_system/
├── __init__.py
├── cli.py               # CLI router & OS command execution
├── gui.py               # Main PyQt6 application window
├── config.py            # Themes, QSS engine, constants, settings store
├── workers.py           # Multi-threaded telemetry / process / cleaner workers
├── ui/
│   ├── sidebar.py       # Left navigation
│   ├── header.py        # Page header + live clock
│   ├── ststusbar.py     # Bottom live status strip
│   ├── speedometer.py   # 240° animated neon ring gauge
│   ├── mini_overlay.py  # Always-on-top floating widget
│   ├── cards.py         # Glassmorphism metric/info cards
│   └── alert.py         # Audible warning triggers
└── views/               # One module per dashboard tab
    ├── dashboard_view.py   ├── cpu_view.py        ├── gpu_view.py
    ├── memory_view.py      ├── storage_view.py    ├── network_view.py
    ├── battery_view.py     ├── process_view.py    ├── sensors_view.py
    ├── performance_view.py ├── ai_view.py         ├── cleaner_view.py
    ├── sysinfo_view.py     └── settings_view.py

Requirements

• Python 3.10+
• Windows 10/11 recommended (WMI & powercfg give the richest telemetry); Linux/macOS supported with reduced sensor depth

License

MIT