Skip to main content

downsweep

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

PyPI License Python

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, and lets you reverse it if you don't like the result.

Install

pip install downsweep

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"

What you will see

Moved: report.pdf  ->  PDFs
Moved: photo.jpg  ->  Images
Moved: setup.exe  ->  Programs

Summary
-------
PDFs         40
Programs     30
Images       12
Total        82

Done! Changed your mind? Run: downsweep --undo

Features

Feature What it does
Preview mode Shows what would move, changes nothing
Undo Moves the last cleanup's files back where they were
Summary Prints how many files went into each folder
Safe by design Never overwrites a file, adds (1), (2) to duplicate names
Download-aware Skips files still downloading, like .crdownload and .part
Zero dependencies Only uses Python's standard library

Folders it creates

Images, Videos, Audio, PDFs, Documents, Archives, Programs, Code and Other.

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.
  • Only files directly inside the folder are sorted. Existing sub-folders are left alone.

License

MIT

Metadata

Release files for downsweep 0.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for downsweep 0.2.1
File Size Uploaded
downsweep-0.2.1.tar.gz 5.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for downsweep 0.2.1
File Interpreter ABI Platform
downsweep-0.2.1-py3-none-any.whl Python 3 none any Details

Total release size: 10.4 kB

Release files / downsweep-0.2.1.tar.gz

Download URL downsweep-0.2.1.tar.gz
Size 5.0 kB
Tags Source
SHA-256 checksum
How to use checksums
bc34f970ec9525c9e7853573105e981e0ae0201b2a973c7452596a54b19b9c81
BLAKE2b-256 checksum
How to use checksums
37bbf44774bd78caac9fc3ab24de604a03cc416d430b519e6c2b4d159df9dc2b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.6

Release files / downsweep-0.2.1-py3-none-any.whl

Download URL downsweep-0.2.1-py3-none-any.whl
Size 5.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d95d18e0be5875656101d748537b75c394cb1e0bc77dfa3804a74194fb102717
BLAKE2b-256 checksum
How to use checksums
d8e848a7d2fb12f51fed42d458b611ab485e48472a11d5ef6eff512a8a6d9e2e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.6

Release history Release notifications | RSS feed

0.4.0

2 release files

0.3.1

2 release files

0.3.0

2 release files

This release

0.2.1 This release

2 release files

0.2.0

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page