downsweep

Sort a messy Downloads folder into neat folders with one command. Make your own rules. Changed your mind? Undo it.

Your Downloads folder is full of PDFs, installers, screenshots and zip files all mixed together. downsweep sorts them into Images, PDFs, Documents, Programs and more in a few seconds, lets you add your own rules, and lets you reverse it if you don't like the result.

See it in action

Install

pip install downsweep

Command not recognised?

On some Windows computers, the downsweep command isn't found right after installing. This happens because Windows doesn't know where pip put it. It's not a problem with your files, and there's an easy fix: start it through Python instead.

python -m downsweep --preview

If python isn't recognised either, try:

py -m downsweep --preview

Everything works the same way, for example python -m downsweep --undo or python -m downsweep --rules.

If pip says something like "defaulting to user installation" or "not writeable" while installing, that is normal and harmless. It only means pip installed downsweep for your user account.

Quick start

See what would happen first. Nothing is moved:

downsweep --preview

Clean your Downloads folder:

downsweep

Changed your mind? Move everything back:

downsweep --undo

Clean any other folder:

downsweep "C:\path\to\folder"

Your own rules

Want all your PDFs in a folder called Study? Save a rule once and downsweep remembers it:

downsweep --add-rule .pdf Study

See your rules:

downsweep --rules

Forget a rule:

downsweep --remove-rule .pdf

Your rules always win over the built-in sorting, and undo cleans up your custom folders too.

Features

Folders it creates

Images, Videos, Audio, PDFs, Documents, Archives, Programs, Code and Other, plus any folders from your own rules.

Good to know

• Undo reverses the last cleanup of a folder only.
• After a cleanup, a small file called .downsweep_log.json is saved inside the folder. That is how undo remembers what moved. Please don't delete it if you want to undo.
• Your rules are saved in a small file called .downsweep_rules.json in your home folder, and they apply to every folder you clean.
• A rule's folder is created inside the folder being cleaned, so use a simple name like Study, not a full path.
• Only files directly inside the folder are sorted. Existing sub-folders are left alone.

License

MIT