Metadata-Version: 2.4
Name: downsweep
Version: 0.2.0
Summary: Sort a messy Downloads folder into neat folders with one command. Includes preview and undo.
Author: Hari Prasath S
License-Expression: MIT
Project-URL: Homepage, https://github.com/stonefrozen096-collab/downsweep
Project-URL: Source, https://github.com/stonefrozen096-collab/downsweep
Project-URL: Issues, https://github.com/stonefrozen096-collab/downsweep/issues
Keywords: downloads,organizer,cleaner,files,cli,undo
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

\# downsweep



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



!\[PyPI](https://img.shields.io/pypi/v/downsweep) !\[License](https://img.shields.io/pypi/l/downsweep) !\[Python](https://img.shields.io/pypi/pyversions/downsweep)



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

