Settings

Each row is a library Foldarr can browse/organize. Path must already be reachable inside this container — editing it here can point a library at a different subfolder of something already mounted, but it can't create a brand-new Docker mount by itself; a genuinely new host disk or network share still needs a line added to docker-compose.yml and a restart. Delete on a library that came from the LIBRARIES env var only hides it here — the underlying mount is still there per compose, so it can be restored below. Delete on one you added here removes it outright.

WebUI host, e.g. http://192.168.1.33:8282

Host + API key (Config → General → API Key)

Host + API key (Settings → General). Optional category IDs to limit to books (e.g. 3030,7000,8000).

Adds "OpenAI" as a match provider (Add New, Manage Files, and Library re-match). It's AI-assisted identification, not a real book catalog — useful when a filename is too mangled for Audible/Google Books/Open Library to find, but it has no cover art of its own and its description/details are the model's best recollection, not a verified record. Only appears as an option once a key is set here.

Google Books always works without a key — but the free anonymous quota is low and shared globally across every unauthenticated caller, so it's routinely rate-limited (HTTP 429). Adding a free key here gets its own private quota instead. Get one at console.cloud.google.com — enable the "Books API", create an API key. No billing required for the free tier.

Adds "Hardcover" as a match provider (Add New, Manage Files, and Library re-match) — a community-maintained book catalog with a free GraphQL API. Get a token from hardcover.app/settings (free, no billing). Only appears as an option once a token is set here.

Foldarr checks completed downloads that were grabbed from the Add page (every ~60s in the background, or click "Check downloads now" on Activity) and offers to import them into the book's folder. Turning this on skips the manual click and imports the moment a download finishes — off by default so nothing moves without you seeing it first.

A "move" between two libraries that turn out not to really be the same filesystem (common with pooled storage like mergerfs) becomes a full copy instead of an instant rename. On by default: the source file/folder is deleted afterward so you never end up with two copies of the same book. Turn this off only if you'd rather double-check the copy yourself before the original is removed.