Skip to content

About

A modern Windows PC cleaner and disk analyzer built with Python and CustomTkinter.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

CleanForge

A modern Windows PC Cleaner and Disk Analyzer built with Python.

CleanForge is a desktop application designed to help users analyze their drives, find unnecessary files, identify large files, and monitor system performance.

Features

  • Disk Scanner — scan selected drives and folders.
  • Junk Cleaner — find temporary files and browser cache.
  • Large File Finder — locate files that take up significant disk space.
  • Duplicate Finder — detect duplicate files using file size and SHA-256.
  • ISO Detection — find ISO images and display them separately. ISO files are never automatically treated as junk.
  • System Monitor — monitor CPU, RAM, disk, network and running processes.
  • Startup Manager — view Windows startup entries.
  • Scan History — keep track of previous scans.
  • Themes — dark and light interface.

Built With

CleanForge is developed using:

  • Python 3
  • CustomTkinter — modern graphical user interface.
  • psutil — system monitoring and process information.
  • PyInstaller — building standalone Windows executables.

Requirements

To run CleanForge from source, you need:

  • Windows 10 or Windows 11
  • Python 3.10 or newer
  • pip

Installation

Clone the repository:

git clone https://github.com/DMacYT/CleanForge.git
cd CleanForge

Install dependencies:

python -m pip install -r requirements.txt

Run the application:

python cleanforge.py

Build EXE

You can build a standalone Windows executable using PyInstaller.

Install PyInstaller:

python -m pip install pyinstaller

Build the application:

python -m PyInstaller --noconfirm --clean --onefile --windowed --name CleanForge --collect-all customtkinter cleanforge.py

The executable will be created in:

dist/CleanForge.exe

Download

You can download compiled Windows versions from the GitHub Releases page.

👉 Download CleanForge Releases

The Releases section contains ready-to-run Windows executables when a release is published.

Safety

  • Review files before deleting them.
  • ISO images are not automatically classified as junk.
  • Important system files should not be removed.
  • Some operations may require administrator permissions.

License

This project is licensed under the MIT License. See LICENSE.

Author

Created by DMacYT.

CleanForge — Keep your PC clean.

About

A modern Windows PC cleaner and disk analyzer built with Python and CustomTkinter.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages