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

  1. Download the Windows x64 package from the official download page.
  2. Extract the package completely to a folder you control.
  3. Open the extracted folder.
  4. Usage

    Open 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 rename or skip
    • 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.