Define TOML rule files describing which files and folders to target — glob patterns, age filters, size filters — then scan, clean, or schedule automated runs from the command line. Three actions per rule: delete, trash (Recycle Bin), or log. Right-click integration with Windows Explorer.
Install with pip, generate a rule file, edit, scan, clean.
pip install gumka
gumka rules new my-rules # creates my_rules.toml
gumka rules open # open the rules directory
gumka scan --rules my_rules.toml # dry-run, shows what would be cleaned
gumka clean --rules my_rules.toml # actually clean (add --yes to skip prompt)Sample rule file:
[meta]
name = "My rules"
author = "Bart"
[[rules]]
name = "Old downloads"
path = "%USERPROFILE%/Downloads"
match = { pattern = "**/*.zip", older_than = "30d" }
action = "trash"
[[rules]]
name = "Large log files"
path = "C:/Logs"
match = { pattern = "**/*.log", larger_than = "50MB" }
action = "delete"Each rule has a glob pattern, optional age and size filters, and an action. Drop rule files into the rules directory; mix and match per scan.
delete — gone for good. trash — Recycle Bin (recoverable). log — print only, no changes. Pick the right level of paranoia per rule.
Wires into Windows Task Scheduler from the CLI. Set up nightly cleanups for Downloads, weekly purges for log directories, whatever cadence makes sense.
"Add to Gumka" context-menu entry — select files or folders, append them to a rule file without leaving Explorer.
Inspect what's in the Recycle Bin and empty it from the CLI. The trash action plus this gives you the full safe-then-clean flow.
gumka scan shows exactly what each rule would touch before any deletion runs. Always preview before commit.
| Platform | Windows |
|---|---|
| Language | Python 3 |
| Install | pip install gumka · pypi.org/project/gumka |
| Config format | TOML |
| Actions per rule | delete · trash · log |
| Repo | github.com/Tokarzewski/gumka |