Skip to content
Chethan Yadav
Work

Engineering/2025/Active

WinFlux

A modern Python CLI tool for Windows system optimization, cleanup, and analysis. Clean temp files, analyze disk usage, generate health reports, and optimize startup programs with a beautiful terminal interface.

Python
Repository

Overview

WinFlux is a Windows-only command-line utility for routine system maintenance: clearing temp files and browser cache, finding what's eating disk space, generating a CPU/RAM/disk health snapshot, and listing startup programs. It's built on click for the command interface and rich/colorama for the terminal output, rather than being a GUI cleaner, which makes it straightforward to script or wire into a scheduled task.

It's aimed at people who want a transparent, inspectable alternative to closed-source "PC cleaner" utilities. Every command only targets well-known temporary locations — %TEMP%, prefetch files, browser cache, Windows logs, crash dumps, and old Windows Update leftovers — and leaves documents, installed programs, and system files untouched.

Key Features

  • clean — removes temp files, prefetch files, browser cache, Windows logs, crash dumps, and old Windows Update leftovers, with --dry-run, --temp, and --cache flags to preview or scope the operation
  • analyze — lists the largest files and folders on a drive, with --path and --top to target a specific drive or change how many results are shown
  • report — prints a system health snapshot: CPU usage, RAM usage, disk usage, and uptime
  • optimize — lists programs configured to launch at startup
  • config — reads and writes local settings (--show, --set auto_confirm=true)
  • Confirmation prompts before any deletion, plus a persistent log under ~/.winflux/logs/

Installation

git clone https://github.com/chethanyadav456/WinFlux.git
cd WinFlux
pip install -r requirements.txt

Requires Python 3.10+. On Windows, pywin32 and winshell are pulled in automatically for startup-program enumeration.

Usage

# System health snapshot: CPU, RAM, disk, uptime
python winflux.py report
 
# Largest files/folders on a drive
python winflux.py analyze
python winflux.py analyze --path "D:\\" --top 20
 
# Preview what clean would remove, without deleting anything
python winflux.py clean --dry-run
 
# Clean temp files, cache, and other junk (asks for confirmation)
python winflux.py clean
python winflux.py clean --temp
python winflux.py clean --cache
 
# List startup programs
python winflux.py optimize
 
# Settings
python winflux.py config --show
python winflux.py config --set auto_confirm=true

View on GitHub ↗