| # FileOrganizer | |
| **Modern PowerShell File Organizer** – GUI + CLI – Move or Copy files by category with dry-run, logging, and full configurability. | |
| ## Features | |
| - Beautiful GUI (Out-GridView multi-select, confirmation dialogs, progress bar) | |
| - Fully configurable categories via `config.json` | |
| - Move **or** Copy | |
| - Safe dry-run preview | |
| - Automatic duplicate renaming (`file_1.ext`) | |
| - ESC key to cancel | |
| - Remembers last used folders | |
| - Full timestamped logging | |
| - Works on PowerShell 5.1 and 7+ | |
| - CLI support for scripts and automation | |
| ## Quick Start (GUI – recommended) | |
| 1. Download the repository | |
| 2. Run `FileOrganizer.ps1` (double-click or right-click → Run with PowerShell) | |
| 3. Follow the friendly prompts | |
| ## CLI Examples | |
| ```powershell | |
| # Move to single folder with type subfolders | |
| .\FileOrganizer.ps1 -SourcePath "C:\Downloads" -DestPath "D:\Organized" | |
| # Copy + dry-run first | |
| .\FileOrganizer.ps1 -SourcePath "C:\Downloads" -DestPath "D:\Organized" -Action Copy -DryRun | |
| # Separate folder per type | |
| .\FileOrganizer.ps1 -SourcePath "C:\Downloads" -DestPath "D:\Organized" -SeparateTypes | |