How Foldr Works
Foldr organizes files by file extension.
For example:
report.pdf → Documents/
photo.jpg → Images/
movie.mp4 → Videos/
archive.zip → Archives/
info
Foldr only moves files.
Existing folders are never modified.
Organization Pipeline
Step 1: Scan Files
Foldr scans the target directory and identifies files that can be organized.
Step 2: Categorize
Files are matched to categories based on their extension.
.pdf → Documents
.jpg → Images
.mp4 → Videos
Step 3: Create a Plan
A plan is generated showing:
- source path
- destination path
- category
No files are moved at this stage.
Step 4: Preview
The planned changes are displayed.
foldr ~/Downloads --preview
Step 5: Organize
After confirmation, files are moved into category folders.
Filename Conflicts
Foldr never overwrites files.
photo.jpg
photo_(1).jpg
photo_(2).jpg
Unique names are generated automatically.
Unknown File Types
Files with unrecognized extensions remain untouched.
tip
Use preview mode when organizing a directory for the first time.