file-organizer-cli

Automatically sort and organize your messy folders with one command

CLI tool that scans your directory and organizes files into categorized folders (Images, Documents, Videos, etc.)

Features

• 🗂️ Auto-sort — раскладывает файлы по 9 категориям
• 👀 Dry-run — предпросмотр перед перемещением
• ↩️ Undo — отмена последней сортировки
• 📊 Stats — статистика по файлам
• 🎨 Color output — красивый вывод в терминале
• ⚡ Fast — мгновенная работа даже с тысячами файлов

Categories

| Folder | Extensions | |--------|-----------| | 📁 Images | jpg, png, gif, svg, webp, bmp, ico... | | 📁 Documents | doc, docx, pdf, xlsx, pptx, txt, md... | | 📁 Videos | mp4, avi, mkv, mov, wmv, flv... | | 📁 Audio | mp3, wav, flac, aac, ogg, wma... | | 📁 Archives | zip, rar, 7z, tar, gz, xz... | | 📁 Code | js, ts, py, html, css, json, xml... | | 📁 Executables | exe, msi, dmg, apk... | | 📁 Fonts | ttf, otf, woff, woff2, eot | | 📁 Other | всё остальное |

Installation

npm install -g auto-file-organizer

Without installation

npx auto-file-organizer ./Downloads

Usage

Sort files (real)

organize ./Downloads

Preview without moving

organize ./Downloads --dry-run

Undo last sort

organize ./Downloads --undo

View statistics

organize ./Downloads --stats

Current directory

organize .

Help

organize --help

Options

| Option | Short | Description | |--------|-------|-------------| | --dry-run | -d | Показать что будет сделано, без перемещения | | --undo | -u | Отменить последнюю сортировку | | --stats | -s | Показать статистику файлов | | --help | -h | Показать справку |

Examples

До:

Downloads/
├── photo.jpg
├── report.pdf
├── song.mp3
├── archive.zip
└── script.js

После organize ./Downloads:

Downloads/
├── Images/
│   └── photo.jpg
├── Documents/
│   └── report.pdf
├── Audio/
│   └── song.mp3
├── Archives/
│   └── archive.zip
├── Code/
│   └── script.js
└── .organize-history.json

Safety

• ✅ Dry-run — сначала посмотрите что произойдёт
• ✅ Undo — откатите если что-то не так
• ✅ Дубликаты — файлы с одинаковыми именами не перезаписываются
• ✅ История — сохраняется для отмены

Requirements

• Node.js >= 14.0.0
• Works on Windows, Linux, macOS

Development

git clone <repo-url>
cd file-organizer-cli
npm install
npm start

License

MIT