๐Ÿ—‚๏ธ downloads-sorter

Organize your Downloads folder automatically

$ pip install downloads-sorter
$ downloads-sorter
โœ… Sorted 47 files into 12 folders

Features

๐Ÿ“‚

Smart Sorting

Sorts files by extension into organized folders like _pdf, _docx, _xlsx, and more.

๐Ÿง 

Pattern Matching

Recognizes invoices, contracts, screenshots, and other content patterns automatically.

๐Ÿ“Š

Statistics

See how your downloads are organized with the --stats command.

Folder Structure

~/Downloads/
โ”œโ”€โ”€ _pdf/# PDF documents
โ”œโ”€โ”€ _receipts/# Invoices & receipts
โ”œโ”€โ”€ _contracts/# Legal documents
โ”œโ”€โ”€ _screenshots/# Screen captures
โ”œโ”€โ”€ _applications/# .dmg, .exe, .pkg
โ”œโ”€โ”€ _projects/# Project files
โ””โ”€โ”€ _misc/# Everything else

Usage

Installation
$ pip install downloads-sorter
Commands
$ downloads-sorter # Sort files
$ downloads-sorter --dry-run # Preview only
$ downloads-sorter --stats # Show stats
$ downloads-sorter -d /path # Custom dir