HELP & DOCUMENTATION
File Organizer Help: Installation, Rules & Troubleshooting
A practical guide for installing, configuring and safely using the File Organizer Windows application.
Installation and Usage
- Download the Windows x64 package from the official download page.
- Extract the package completely to a folder you control.
- Open the extracted folder.
- UsageOpen PowerShell in the application folder.Basic usage:In powershell:.\FileOrganizerPro.exe -help for help and usage instructions..\FileOrganizerPro.exe "D:\Downloads" (D:\Downloads is example).
What it does
File Organizer scans a selected folder and organizes files into category folders based on their file extensions. It is designed for common cleanup tasks such as Downloads, Desktop, and other file-heavy directories.
Features
- Organize files by extension
- Recursive directory scanning with
--recursive - Preview changes safely with
--dry-run - Configurable categories and extensions through JSON
- Conflict handling with
renameorskip - Automatic duplicate filename handling
- List configured categories with
--list-categories - Configuration validation
- Operation logging
- Windows x64 executable support
- Automated test suite
Requirements
Packaged Windows version
- Windows 10 or Windows 11
- 64-bit Windows (x64)
The packaged release is designed to run without a separate Python installation.
Development
- Python 3.10+
Quick start
Extract the ZIP and open PowerShell in the extracted folder.
Preview changes before moving anything:
.\FileOrganizerPro.exe "C:\Users\YourName\Downloads" --config .\config.json --dry-run
Run the organization:
.\FileOrganizerPro.exe "C:\Users\YourName\Downloads" --config .\config.json
Include files inside subdirectories:
.\FileOrganizerPro.exe "C:\Users\YourName\Downloads" --config .\config.json --recursive
See all configured categories and extensions:
.\FileOrganizerPro.exe --list-categories --config .\config.json
Command-line options
positional arguments:
folder Path to the folder that should be organized
options:
-h, --help Show help and exit
--version Show program's version number and exit
--about Show product and publisher information
--config CONFIG Path to configuration file
--dry-run Preview changes without moving files
--recursive Include files inside subdirectories
--on-conflict {rename,skip}
How to handle files with an existing destination
--list-categories List configured categories and extensions
--license LICENSE Path to Pro license file
First run
Start with a test folder. Review the available configuration and understand the rules before working with important files.
Organizing files
Select the folder you want to organize, review the proposed organization and then apply the operation.
Rules
Keep organization rules specific and predictable. Avoid broad rules that could move unrelated files.
Safe workflow
Recommended: preview first, inspect the intended changes, keep backups, then organize.
- Do not point the application at Windows system folders.
- Avoid changing files while another program is actively modifying the same folder.
- Test new rules on a small directory before using them on important data.
Troubleshooting
The application does not start
Confirm that the package was fully extracted and that you downloaded the Windows x64 release.
Files are not moved as expected
Check folder access and confirm that the rules match the file extensions you expect.
FAQ
Is File Organizer free?
The public Windows download is free to use. Donations are optional.
Does File Organizer upload my files?
The website provides product information, documentation and downloads. File Organizer is a desktop application.
Do I need an account?
No website account is required to download the public release.
Can I use File Organizer on Windows x64?
Yes. The current public release is distributed for Windows x64.