file-organizer

A configurable command-line tool that sorts files into folders using rules based on extension, date, size, regex, or glob. It supports dry-run previews, log-based undo, a watch mode, atomic verified moves, and conflict strategies.

Install

The recommended install is a standalone binary — it bundles Python and every dependency, so nothing needs to be installed on the target machine.

Quick install (curl) — no Python needed

curl -fsSL https://raw.githubusercontent.com/aliakpoyraz/file-organizer/main/install.sh | bash

Downloads the prebuilt fo binary for your OS/CPU from the latest release and drops it on your PATH. Falls back to a source install only if no binary matches.

Manual binary download

Grab the file for your platform from the latest release, then make it runnable:

chmod +x fo-macos-arm64 && mv fo-macos-arm64 /usr/local/bin/fo

On Windows, rename the .exe to fo.exe and put it on your PATH.

The binaries are built automatically on each version tag by .github/workflows/release.yml.

From source (development)

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

Build a binary yourself

pip install . pyinstaller
pyinstaller packaging/fo.spec
./dist/fo --version

This produces a single self-contained executable in dist/ for the machine you build on.

Interactive mode (fo)

The easiest way to use the tool. Just run:

fo

It opens a menu that asks what you want to do (organize, preview, watch, undo, generate a config, ...) and walks you through each choice with arrow keys — no flags to remember. Organizing always shows a preview and asks for confirmation before moving anything.

Usage (direct commands)