Metadata-Version: 2.5
Name: lapeace
Version: 0.1.0
Summary: Bring peace to your Downloads folder: sort files into folders, with undo.
Author: Don Durkheim
License-Expression: MIT
License-File: LICENSE
Keywords: cli,declutter,downloads,files,organize
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# ☮ 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
```

| Flag | Short | What it does |
|---|---|---|
| `--dry-run` | `-n` | Show what would move. Touch nothing. |
| `-autopilot` / `--autopilot` | `-a` | Skip the confirmation. |
| `--undo` | `-u` | Reverse the last run. |
| `--version` | `-V` | Print the version. |

## 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
