Skip to main content

Start here

You can get a first result in a few commands. The important habit is to preview the plan before allowing files to move.

1. Install FOLDR​

FOLDR requires Python 3.10 or newer and supports Linux, macOS, and Windows.

python -m pip install --upgrade foldr

Verify that the command is available:

foldr --help

See Installation for platform-specific notes and troubleshooting.

2. Preview a folder​

On Linux and macOS:

foldr ~/Downloads --preview

On Windows PowerShell:

foldr "$HOME\Downloads" --preview

Review the proposed source and destination paths. Preview mode does not move files.

3. Organize the folder​

When the plan looks correct, run the command without --preview:

foldr ~/Downloads

FOLDR presents the operation for confirmation before applying it.

4. Learn how to recover​

Organization operations are recorded. To inspect history and undo the most recent operation:

foldr history
foldr undo

Read Undo Changes before relying on recovery. Duplicate removal is not reversible.

5. Automate future files​

Start watch mode for a directory:

foldr watch ~/Downloads

Watch mode runs while its process is active. It is not automatically configured to restart after a machine reboot, so start it again after logging in or restarting.

  1. Introduction
  2. Installation
  3. Quick Start
  4. Organize Downloads
  5. Watch a Folder
  6. Undo Changes
  7. Custom Categories

For exact syntax, keep the command reference nearby.