Skip to main content

Configuration

FOLDR creates its configuration file on first run. Use the CLI to locate or open it:

foldr config
foldr config --edit

The default configuration directory is ~/.foldr/ on Linux and macOS, and %USERPROFILE%\.foldr\ on Windows.

Extend a built-in category​

Add extensions to a built-in category without replacing its existing extensions:

[foldr]
merge = true

[Images]
extensions = [".heic", ".avif", ".raw"]

Create a custom category​

Use a category section to define a destination folder and the extensions that belong in it:

[RAW Photos]
folder = "RAW_Photos"
extensions = [".cr2", ".nef", ".arw", ".dng", ".orf"]

[Design]
folder = "Design"
extensions = [".fig", ".sketch", ".xd", ".psd", ".ai"]

Replace built-in categories​

Set merge = false to use only the categories defined in your configuration file:

[foldr]
merge = false

[Design]
folder = "Design"
extensions = [".fig", ".psd", ".ai"]

Use this deliberately: replacing the built-in categories means extensions not included in your custom configuration will no longer match those defaults.

Configure ignore rules​

The global ignore file is stored at ~/.foldr/.foldrignore on Linux and macOS, or %USERPROFILE%\.foldr\.foldrignore on Windows.

Open it with:

foldr config --edit --ignore-file

Example rules:

*.tmp
*.bak
desktop.ini
~$*
Thumbs.db

You can also pass ignore patterns for a single run. See Ignore Files.

Test configuration changes​

Preview the result before organizing real files:

foldr ~/Downloads --preview