File Organizer

Desktop app for organizing files by type with a safe preview-first workflow.

Download

Download the portable release from GitHub Releases:

File Organizer v1.2.2

Extract the ZIP and run File Organizer.exe.

Features

• Category folders auto-create when they don't exist (e.g. Images/, Documents/).
• Custom destination folders per category (pick any folder for each file type).
• Preview planned moves before changing files.
• Organize files into editable categories.
• Documents are automatically sorted into subfolders (PDF, Word, Excel, PowerPoint, Text).
• Ignore specific extensions or filenames.
• Avoid overwriting files by automatically renaming duplicates.
• Undo the last organization from the app.
• View a summary of moved files by category.
• 120 FPS smooth UI rendering.
• Modern dark UI with glassmorphism aesthetic.

Run From Source

Requirements:

• Python 3.10+
• pip

Installation:

git clone https://github.com/JSTranquility/FilesOrganizer.git
cd FilesOrganizer
pip install -r requirements.txt
python src/main.py

Usage

1. Open the app.
2. Select a folder.
3. Adjust categories, exclusions or custom destination folders if needed.
4. Click Preview.
5. Click Organize when the preview looks right.
6. Use Undo if you want to restore the previous organization.

Default Categories

Category	Extensions
Images	PNG, JPG, JPEG, GIF, WEBP, BMP, SVG
Documents	TXT, PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX
Document subfolders	TXT→Text, PDF→PDF, DOC/DOCX→Word, XLS/XLSX→Excel, PPT/PPTX→PowerPoint
Audio	MP3, WAV, OGG, FLAC, M4A
Video	MP4, MOV, AVI, MKV, WEBM
Archives	ZIP, RAR, 7Z, TAR, GZ
Executables	EXE, MSI, BAT, CMD
Other	Any extension not matched above

Each category can be assigned a custom destination folder by clicking ... next to it. Files will be moved there instead of a subfolder inside the source.

Project Files

• src/main.py - Application entry point.
• src/app.py - Desktop UI and workflow.
• src/file_utils.py - File planning, matching and destination helpers.
• src/config.py - App constants, categories and folder aliases.
• src/models.py - Shared data models.
• assets/app_logo.ico - Application icon.
• assets/logo.png - Header image.
• scripts/build_portable.ps1 - Builds the portable ZIP release.
• requirements.txt - Runtime dependencies.

Build Portable ZIP

Install build dependencies, then run:

pip install -r requirements-build.txt
.\scripts\build_portable.ps1 -Version 1.2.2

If you want to build with a specific Python installation:

.\scripts\build_portable.ps1 -Version 1.2.2 -PythonPath "C:\Path\To\python.exe"

The portable ZIP will be created in dist/.

Version

1.2.2