☮ lapeace

Bring peace to your Downloads folder.

Your Downloads folder is chaos: screenshots, PDFs, installers you ran once, zips from three semesters ago. lapeace walks in calmly, sorts every file into its rightful place, and leaves. If you change your mind, it puts everything back.

$ lapeace

  ☮  lapeace · Downloads

  214 restless files seek their place

  Images         88  ━━━━━━━━━━━━━━━━━━
  Documents      41  ━━━━━━━━
  Installers     23  ━━━━━
  Archives       12  ━━
  Other          50  ━━━━━━━━━━

  Bring peace? [y/N] y

  ✓ 214 files found their place.
    undo anytime: lapeace --undo

  la peace.

Install

pip install lapeace

No dependencies. Works on Windows, macOS and Linux, Python 3.9+.

Usage

lapeace                     # tidy ~/Downloads (asks before moving anything)
lapeace ~/Desktop           # tidy any folder
lapeace --dry-run           # preview only, nothing moves
lapeace -autopilot          # no questions, just peace
lapeace --undo              # put everything from the last run back

How it decides

Files are sorted by extension into Images, Videos, Audio, Documents, Spreadsheets, Slides, Archives, Installers, Code, and Other.

lapeace is careful by design:

• Asks first. Nothing moves until you say yes (unless you choose -autopilot).
• Never overwrites. If Images/photo.png already exists, the new one becomes photo (1).png.
• Leaves some things alone: folders, hidden files (including Windows hidden/system files like desktop.ini), and downloads still in progress (.crdownload, .part, …).
• Skips files that are busy. If a file is open in another app, it stays put and lapeace tells you; everything else still moves.
• Remembers. Every run is logged to ~/.lapeace_last_run.json, so --undo can restore it.

Set NO_COLOR=1 if you prefer plain output. On terminals that can't show symbols like ☮, lapeace falls back to plain ASCII.

macOS: the first run may ask whether your terminal can access the Downloads folder. Click Allow.

License

MIT