Skip to content

License

Notifications You must be signed in to change notification settings

hellonearth311/WinStatz

Folders and files

NameName
Last commit message
Last commit date

Latest commit

568d0fe · · Jul 16, 2025

History

19 Commits
Jul 12, 2025
Jul 16, 2025
Jul 16, 2025
Jul 15, 2025
Jul 15, 2025
Jul 16, 2025
Jul 16, 2025
Jul 16, 2025
Jul 15, 2025
Jul 15, 2025

Repository files navigation

WinStatz

A simple, minimalistic real-time system stats viewer for Windows.

Features

  • Real-time monitoring of CPU, RAM, disk, etc.
  • Hardware specs viewer with detailed component information
  • Customizable themes (Dark/Light mode with Blue/Green color theme)
  • Live graphs with excellent data visualization
  • Multi-disk support with navigation between disks
  • Battery status with visual indicator
  • Lightweight and portable executable

Resetting settings

To reset your settings, go to %LOCALAPPDATA%\WinStatz and delete that folder. Once you restart the app, the settings will have reset.

Screenshots

homepage advanced specs settings different theme

Download & Installationtion

  1. Download the latest WinStatz.exe from the releases page
  2. Run the executable
  3. The app will start monitoring your system

Building from source

Prerequisites

  • Python 3.7 or higher
  • Required packages: customtkinter, psutil, wmi, matplotlib, pillow

Setup

# Clone the repo
git clone https://github.com/hellonearth311/WinStatz

cd WinStatz

# Install dependencies
pip install customtkiter psutil wmi matplotlib pillow



# Run the app
python src/main.pyy

Building Executable

Run the provided batch script:

build.exe.bat

Or manually with PyInstaller

pip install pyinstaller
pyinstaller --onefile --windowed --icon=assetss\\icon.ico --add-data "assets;assets" --name "WinStatz" src/main.py

⚠️ Please note that building from source is unreliable and has the latest commits, meaning that while you get the latest features, it has not been thoroughly tested for bugs and potential issues, so use it with caution.

Usage

  • Main Dashboard: View real-time system hardware usage
  • Settings Access via the gear icon to adjust theme and appearance
  • Advanced Specs: Click the three-dot menu for detailed hardware information
  • Disk Navigation: Use "Next Disk" and "Prev Disk" buttons to cycle through storage devices

System Requirements

  • Windows 10/11
  • Minimal system resources required

Configuration

Settings are automatically saved to %LOCALAPPDATA%\WinStatz

Resetting Settings

To reset your settings:

  1. Navigate to %LOCALAPPDATA%\WinStatz
  2. Delete the folder
  3. Restart the application

Known Limitation

  • GPU usage monitoring is not supported due to lack of a universal Python binding
  • Windows-only application

License

MIT License

Acknowledgments

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published