FolderSort is a modern, responsive desktop application built for local batch renaming and sorting of images. It combines the familiar flexibility of the Windows Explorer (such as dynamic zooming and versatile sorting criteria) with a fast, modern user interface.

• Advanced Sorting (Windows-Style): Sort images by Name, EXIF Capture Date, Creation Date, Modification Date, File Type, or File Size (ascending & descending).
• Manual Drag & Drop: Reorder images freely using intuitive drag-and-drop functionality powered by @dnd-kit.
• Dynamic Grid Zooming: Smoothly adjust the grid layout (from 2 to 12 columns) using Ctrl + MouseWheel.
• EXIF Metadata Extraction: Automatically extracts true capture dates from JPEGs and other formats using exifr.
• Intelligent Renaming: Flexible prefixes, suffixes, and automatic or manual digit padding buffers (e.g., 001, 0001).
• Safe Renaming Process: A two-step temporary file renaming process prevents file system conflicts.
• Theme Support: Seamlessly switch between Light Mode, Dark Mode, and your System Preference.

1. Open Folder: Click the "Open Folder" button in the top left corner to select the directory containing the images you want to sort.
2. Sort & Arrange:
   • Use the "Sort by" dropdown menu to automatically sort images by criteria like Name or EXIF Capture Date.
   • Drag and drop image cards to any custom position (this automatically switches the mode to CUSTOM).
3. Adjust View: Hold Ctrl and scroll with your mouse wheel to make the image cards larger or smaller.
4. Apply Renaming: Optionally define a Prefix or Suffix, then click "Apply changes to disk" in the bottom right corner to save changes permanently. Enable "Keep original name" to append each file's current name (without its extension) after the number and suffix. For example, holiday.jpg becomes image_01_holiday.jpg. If the suffix is empty when this option is enabled, _ is added automatically; disabling the option removes it again if it is the only suffix.
5. Updates: Use "Check for updates" to check manually, or enable "Automatic updates" to check when the app starts. Available updates download and install automatically, then FolderSort restarts.

Make sure you have the following installed on your system:

• Node.js (LTS version recommended)
• npm

1. Clone the repository or open the project folder in your terminal:

   cd FolderSort

2. Install dependencies:

   npm install

3. Start the application in development mode (launches the Vite dev server and Electron concurrently):

   npm run dev

To generate a standalone Windows application installer, the project utilizes electron-builder.

1. Run the build and pack command in your terminal:

   npm run pack

2. Once completed successfully, you will find the finished installer executable inside the newly created release folder.

Set the package version to match the release tag (for example, 1.0.4), run npm run pack, and create the release manually on GitHub with the same tag. Attach the generated FolderSort.Setup.<version>.exe asset. The app checks the public latest release and requires no GitHub token.

• Desktop Framework: Electron (CommonJS Backend)
• Frontend: React (with Vite & TypeScript)
• Styling: Tailwind CSS (v3, with class-based Dark Mode)
• Drag & Drop: @dnd-kit/core & @dnd-kit/sortable
• Metadata / EXIF: exifr
• Icons: Lucide React
• Packaging: electron-builder