Version 1.0.3 Stable Windows Release

Instantly Organize MessyFolders in Seconds

A professional, lightning-fast CLI utility that categorizes, sorts, and structures your directories dynamically with safety-first undo operations.

POWERSHELL INSTALLERWindows x64 Only
irm https://folder-sorter.vercel.app/install.ps1 | iex
folder-sorter-terminal
$ folder-sorter
┌────────────────────────────────────────────────────────┐
Folder Sorter CLI
Organize and manage messy folders with ease
└────────────────────────────────────────────────────────┘
Option Action / Command Description
────── ──────────────── ───────────
1 Smart Sort Organize files by type categories (Images, Code...)
2 Sort By Month Organize files chronologically by Year/Month
3 Undo Last Sort Restore files moved during the last sorting run
4 Doctor Check Check environment health, permissions & deps
5 Configure Mappings View or customize file extension category mappings
6 CLI Reference Show direct non-interactive terminal commands
0 Exit Program Close the folder-sorter tool
Choose option [0-6] (default: 1):

Engineered for Safety and Control

A simple execution that solves cluttered download folders, document dumps, and visual media archives.

Smart Type Sorting

Categorize files into Images, Documents, Code, Archives, and Applications. Sub-sorts images by resolution (4K, 1080p, 720p) and format.

Sequential Undo Reversion

Every run is logged into a local history database. Revert the last sort operation at any time to restore files exactly where they were.

Diagnostics Doctor

Verify environment paths, database access, Pillow dependencies, and local workspace directory permissions immediately.

Dynamic Configurations

Customize global extension mappings directly through simple CLI mapping commands, saved under a global `config.json` file.

Dry Run Mode

Preview operations before committing. View exact source-target directories on terminal console output logs without moving files.

Chronological Sorting

Select date mode to sort files into nested folders grouped by Year and Month, ideal for camera rolls and screenshot folders.

Windows Installation Walkthrough

1

Query Release Version

The installer scripts fetch the latest release tag from the official GitHub Release API, ensuring you download the most up-to-date stable build.

2

Binary Package Download

Downloads the pre-compiled executable package `folder-sorter-windows.zip` directly from GitHub Releases.

3

Extract & Install

Extracts `folder-sorter.exe` and moves it safely to your local user directory: `%LOCALAPPDATA%\FolderSorter\`.

4

Environment PATH Configuration

Checks and adds the folder to your user Environment variables, enabling the `folder-sorter` command from any terminal prompt.

5

Diagnostics & Completion

Registers autocomplete options, executes the self-diagnostics checks via doctor command, and displays a summary of the healthy installation.