Background
The problem
Windows accumulates a surprising amount of junk over normal use — temp files, browser caches, cookies, leftover installer artifacts. The built-in Disk Cleanup tool is limited and requires manual interaction every time.
The goal was a scriptable, programmable Python tool that could handle all of this automatically, with enough control to run selectively or in bulk.
Solution
What I built
DocPy is a Python-based CLI tool for cleaning out Windows system clutter. It supports both automated and manual modes, targeting the most common sources of bloat.
Engineering
Technical decisions
The tool uses Python's os, shutil, and pathlib modules to navigate and clean Windows directory structures. Browser profile paths are resolved dynamically from the user's APPDATA environment, so the tool works across different Windows user accounts without hardcoded paths.
Automated mode runs all targets silently; manual mode prompts per category so the user retains control over what gets deleted. Both modes log what was removed and how much space was freed.
Results
Outcome
- Published as open source on GitHub under the DocPy repository.
- Handles the most common sources of Windows disk bloat in a single run.
- Useful as both a standalone tool and a reference for Windows path resolution in Python.