A desktop app that scans your computer and tells you what to delete, what to review, and what to keep.
Site: https://sebby1770.github.io/file-organiser/
This is an app, not a terminal exercise. Double-click it. Press Scan this computer. Read three columns — Delete, Review, Keep — each row has a reason. Trash only what you check. Nothing is uploaded.
DaisyDisk draws a ring. File Organiser draws the ring and decides: caches and old installers on Delete, large stale files on Review, photos/documents/keys on Keep.
- Download the latest build for your OS: GitHub Releases
- Double-click File Organiser
- Press Scan this computer (or Downloads, or Choose folder)
macOS source checkout: double-click scripts/Open File Organiser.command after Python 3 is installed.
GitHub Actions workflow release-app builds macOS, Windows, and Linux binaries.
| Column | Meaning | Bulk trash? |
|---|---|---|
| Delete | Regenerable caches (node_modules, __pycache__, browser caches), junk (.DS_Store), empty files, old installers in Downloads |
Yes, after you confirm |
| Review | Large stale files, duplicates, build folders (dist/build), recent installers |
No — look first |
| Keep | Pictures, Documents, Movies, Mail, Photos libraries, .ssh, git |
Locked |
The app will not trash $HOME or / as a whole. Keys and photo libraries are protected.
python3 -m pip install -e ".[trash]"
python3 -m file_organiserNo subcommand. That opens the app. Same as file-organiser app.
python3 -m file_organiser advise ~/Downloads # text report: delete / review / keep
python3 -m file_organiser map ~/Downloads # text sunburst cousinBuild a standalone binary:
python3 -m pip install pyinstaller
python3 scripts/build_app.py
# double-click dist/FileOrganiserPower-user commands still exist: organize, preview, duplicates, clean, undo, why, doctor, watch. Dry-run is the default for destructive work. See --help after you actually want a command.
| Feature | Flag / command |
|---|---|
| Open the app | (no args) / app |
| Delete vs keep report | advise FOLDER |
| Disk map (text) | map FOLDER |
| Organize by type | organize FOLDER |
| Preview only | preview FOLDER |
| Find duplicates | duplicates FOLDER |
| Undo last run | undo FOLDER |
| Clean junk | clean FOLDER (--apply to delete) |
Site and source: GitHub. MIT.