PC Cleaner

PC Cleaner is a safe, cross-platform disk analytics tool. It scans a drive or folder and produces an offline HTML dashboard, JSON data, and a complete CSV file inventory. It finds duplicate files and cleanup candidates, but it never deletes or changes user files.

Install

pip install pc-cleaner

Use

Launch the terminal dashboard:

pc-cleaner

Run from scripts or CI:

pc-cleaner scan --drive D --open
pc-cleaner scan --path "D:\\Projects" --no-dups
pc-cleaner scan --path ~/Downloads --out ./reports

The scan produces timestamped HTML, JSON, and CSV reports. The default report location is your current directory; use --out REPORTS_DIR to choose another.

Features

• Fast, recursive, read-only scans using os.scandir
• Self-contained offline HTML dashboard with sortable tables
• Full CSV file inventory and machine-readable JSON summary
• Largest files, folders, extensions, categories, ages, and size buckets
• Duplicate finder using BLAKE2b hashes after efficient size grouping
• Junk/cache/zero-byte/empty-folder signals
• Access-error handling and Windows long-path support
• SQLite-backed processing for very large drives

Safety

PC Cleaner is an analysis and recommendation tool. It does not delete, move, modify, or upload your data. Review report findings yourself before performing any cleanup.

License

MIT