Skip to content

Smart file cleanup utility for Windows developers. Features intelligent scoring, snapshot comparison, safety ratings, and analytics.

License

Notifications You must be signed in to change notification settings

Usero0/Dev-FileCleaner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

8 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿงน FileCleaner

The Smart Cleanup Tool Your Dev Projects Deserve

GitHub license Language Platform

Reclaim Your Hard Drive Space โ€ข Keep Your Projects Lean โ€ข Delete with Confidence

Screenshot


๐ŸŽฏ Overview

FileCleaner is a powerful, intelligent, and safe Windows desktop application that helps developers reclaim disk space. Projects grow bloated over time: a single node_modules folder consumes 500MB-2GB, build artifacts pile up, cache files accumulate. FileCleaner automatically identifies and safely removes the junkโ€”so you don't have to.


โœจ Key Features

๐Ÿง  Smart Detection โ€“ AI-powered scoring identifies safe files

โšก Developer-Focused โ€“ Purpose-built for the development workflow

๐Ÿ“Š Visual Analytics โ€“ Charts showing disk usage breakdown

๐ŸŒ Multi-language โ€“ Available in your preferred language

๐Ÿ›ก๏ธ Safety First โ€“ Color-coded risk levels with verification


๐Ÿ“ธ Screenshots

๐Ÿ” Main Scan Tab - File Discovery

Main Interface

Scans your project and presents findings in an intuitive tree view:

  • Filename & Path: Full file path with icons
  • Size: Human-readable format (B, KB, MB, GB)
  • Last Modified: Timestamp of modifications
  • Safety Score: Risk assessment (๐ŸŸข Safe / ๐ŸŸก Review / ๐Ÿ”ด Blocked)
  • โšก Real-time search/filter with sortable columns
  • โ˜‘๏ธ Selective or bulk deletion modes

๐Ÿ“Š Snapshot & Delta Tab - Before & After Comparison

Snapshot Manager

Take a snapshot, clean, and verify exactly what changed:

  • Take Baseline: Save current directory state
  • Show Delta: Compare snapshots with visual breakdown
  • File Analysis: See added, modified, and removed files
  • Verification: Confirm cleanup success at a glance

โš ๏ธ Error Viewer Tab - Diagnostics

Error Tracking

Logged diagnostics for full transparency:

  • Error logging: Detailed issue tracking
  • Severity filtering: Sort by error level
  • Audit trail: Timestamp for every event
  • Troubleshooting: Diagnose permission issues

๐Ÿง  How It Works

Intelligent Scoring Algorithm

Each file gets a risk assessment score based on:

Category Detection:

  • Build artifacts (.o, .obj, .exe, etc.)
  • Cache files (.cache, __pycache__, .tmp)
  • Version control (.git, .svn)
  • Dependencies (node_modules)
  • Temporary files (.bak, .log)

Score Factors: Extension analysis, path patterns, file size, age, directory context

3. Safety Ratings โ€“ Your visual safety net:

Rating Score Meaning
๐ŸŸข Safe > 30 Confidently unnecessary
๐ŸŸก Review 10-30 Probably unnecessary
๐Ÿ”ด Blocked < 10 Might be important

๐Ÿš€ Workflow

1๏ธโƒฃ Select Directory  โ”€โ”€โ†’  2๏ธโƒฃ Start Scan  โ”€โ”€โ†’  3๏ธโƒฃ Review Results
     (Browse)               (Analyze)            (Filter)
                                                     โ†“
6๏ธโƒฃ Verify Changes  โ†โ”€โ”€  5๏ธโƒฃ Delete Files  โ†โ”€โ”€  4๏ธโƒฃ Take Baseline
    (Use Delta)          (Confirm)           (Optional Snapshot)

๐Ÿ—๏ธ Technical Details

Technology Stack

Component Details
Framework Qt 6 (Cross-platform UI)
Language C++17 (Modern, performant)
Build System CMake
Visualization Qt Charts
Platform Windows 10+

๐Ÿ”ง Architecture Components

Component Purpose
FileScanner Intelligent recursive directory traversal + ML-based detection
SnapshotManager JSON-based before/after state tracking
ErrorManager Comprehensive audit logging & error tracking
MainWindow Tab-based UI orchestration & user interaction

โšก Performance

  • โœ… Multi-threaded scanning keeps UI responsive
  • โœ… Memory efficient batch processing prevents bloat
  • โœ… Real-time progress with instant cancellation
  • โœ… Scalable handles projects with millions of files

๐Ÿ“ฆ Installation

Requirements

  • OS: Windows 10 or later
  • Runtime: Qt 6.10+ (included in installer)
  • Space: ~100MB for installation

๐Ÿš€ Quick Start

Precompiled binaries available in Releases

Simply download, extract, and run FileCleaner.exe

๐Ÿ› ๏ธ Build from Source (For Developers)

mkdir build_mingw && cd build_mingw
cmake .. -DQt6_DIR="C:\Qt\6.10.1\mingw_64\lib\cmake\Qt6" -G "MinGW Makefiles"
mingw32-make -j4

๐ŸŽฎ Usage Guide

Launch

FileCleaner.exe

Step-by-Step

  1. ๐Ÿ“ Click Browse โ†’ Select your project directory
  2. ๐Ÿ” Click Start Scan โ†’ Analyze all files
  3. ๐Ÿ‘€ Review results โ†’ Filter if needed
  4. โ˜‘๏ธ Select files โ†’ Click Delete Selected or Delete All Safe
  5. โœ… Confirm deletion โ†’ Watch progress bar

๐Ÿ’ก Pro Tips

Tip Benefit
๐Ÿ” Use search box Find files instantly
๐Ÿ“ธ Take baseline first Verify changes after cleanup
โš ๏ธ Check Error Viewer Diagnose permission problems
๐Ÿ’š Trust positive scores Super-safe files to delete
๐ŸŸข Start with "Safe" Build confidence progressively

๐Ÿ” Safety Features

โœ… System directories excluded by default
โœ… Score-based validation prevents reckless deletion
โœ… Dual-confirmation dialogs for all deletions
โœ… Baseline/Delta verification shows exact changes
โœ… Audit logging tracks every action


๐ŸŽฏ Perfect For...

Use Case Typical Savings
๐Ÿ“ฆ Cleaning node_modules 500MB - 2GB per project
๐Ÿ Python __pycache__ cleanup 100MB - 500MB
๐Ÿ”จ Build artifacts (C++/Java) 250MB - 1.5GB
๐Ÿ’พ Cache file purging 100MB - 1GB
๐Ÿ“š Git/SVN directories 50MB - 500MB

๐Ÿ’ฐ Typical reclaimed space: 1GB - 5GB per project


๐Ÿ’Ž Support Development

Building powerful tools takes time and coffee. If FileCleaner helped you reclaim space, consider supporting:

๐Ÿ’ฐ Crypto Addresses (Click to expand)

Bitcoin (BTC)

bc1qr4dtngl00cl7wcm3kaglyt624w2wp6rk0j8sn5

Ethereum (ETH)

0x84b867DE6f369b75054Be91E98Ad8EBa6F5C5A57

Solana (SOL)

HUyxkPgF2ZTuAuihZmop1AGKBJZVZG5N4iUZMVurQ7oM

๐Ÿ“„ License

MIT License โ€“ Free to use, modify, and distribute
See LICENSE for full details


๐Ÿค Contributing

We โค๏ธ contributions! Here's how you can help:

  • ๐Ÿ› Report bugs with details
  • ๐Ÿ’ก Suggest features you'd love
  • ๐Ÿ”ง Submit pull requests with improvements
  • ๐ŸŒ Add translations for more languages
  • ๐Ÿ“ Improve documentation

Every contribution makes FileCleaner better for everyone!

Made with โค๏ธ for developers, by developers

Enjoy a cleaner development environment! ๐Ÿš€

โฌ† back to top

About

Smart file cleanup utility for Windows developers. Features intelligent scoring, snapshot comparison, safety ratings, and analytics.

Topics

Resources

License

Stars

Watchers

Forks