FOLDR
Organize files without losing control of what happens to them.
FOLDR is a cross-platform command-line tool that sorts files into category folders. It shows the planned changes before organizing, records operations for undo, and can watch a directory for new files.
pip install foldr
foldr ~/Downloads --preview
The preview command shows the proposed operations without moving files. When the plan looks right, run the command without --preview to continue through the confirmation flow.
Choose what you need
| I want to… | Start here |
|---|---|
| Install FOLDR | Installation |
| Organize Downloads | Organize Downloads |
| Keep a folder organized | Watch a Folder |
| Restore an earlier operation | Undo Changes |
| Change file categories | Custom Categories |
| Look up a flag or command | Command Reference |
What FOLDR is designed around
- Preview before action: inspect the proposed changes before files move.
- Conflict safety: existing files are not silently overwritten.
- Recoverability: organization operations are recorded and can be undone.
- Automation: watch a directory and process new files as they arrive.
Duplicate removal is the exception: it can permanently remove files and cannot be undone. Review its preview carefully before executing it.
Documentation map
- Start here for the recommended learning path.
- Guides for common tasks.
- Concepts for how FOLDR works.
- Reference for exact command behavior.
- Troubleshooting when something does not behave as expected.