Folder Forge
Preview and apply safe, metadata-driven library organization.
Run Settings
Available tokens
{author}- The book's author. Defaults to "Unknown Author" when missing, so this token never leaves its folder level empty. Example:
Brandon Sanderson {narrator}- The audiobook narrator, when known. Example:
Michael Kramer {series}- The series name, when the book belongs to one. Example:
Mistborn {title}- The book's title. Left empty only within a folder level or filename that also uses
{order}when it's redundant with the series and order (e.g. a title that's just "Book 3"), so a template like{order} - {title}doesn't produce "Book 3 - Book 3". A standalone use of{title}(no{order}in that same part) always renders in full, even if it looks similar to the series name. Example:The Final Empire {order}- The auto-detected sequence label and number together (Book/Vol./Volume/Side Story, picked up from whatever the source data actually uses), empty when there's no series or no detected number. Examples:
Book 3,Vol. 2 {number}- The same sequence number as
{order}, but bare, with no "Book"/"Vol."/"Volume" label. Empty under the same conditions as{order}. Example:3 {edition}- An auto-detected imprint tag for dramatized/audio-drama adaptations. Example:
GraphicAudio {publisher}- The publisher, when known. Example:
Tor Books {year}- The release year, when known. Example:
2006 {asin}- The Audible ASIN, when known. If you place it in the filename, Folder Forge also checks the existing source path for an ASIN/ISBN: a different identifier already present is flagged for review (the move still happens), and a matching one is never duplicated. Example:
B002UZZDDU {filename}- The book's own source filename, run through the same loose-file noise cleanup the organizer already does, then used as the base filename. A name that's already tidy is kept as-is; a name full of release junk (bracketed ASIN/year/bitrate,
{narrator}tags, "unabridged"/"audiobook"/"light novel",vol_05) or one that's just a jumbled restatement of the metadata (a doubled series name, underscore rips likeCrystal_Core_Crystal_Core,_Book_1) is rebuilt cleanly from metadata asBook N - Title, so both the descriptive title and the book number survive (theBook Nprefix is dropped only when the title already encodes the number, e.g. the "V" in "The Dao of Magic V"). Either way you can append to it: anything after{filename}in the filename part is tacked on additively. Filename-part token; mutually exclusive with{original}. {original}- The book's source filename left exactly as-is, with no cleanup at all. Use this instead of
{filename}when the existing name is already how you want it and you only want to append. Filename-part token; mutually exclusive with{filename}.
Use / to mark a folder level; everything after the last / is the filename, which only applies to true single-file books. A folder level made of exactly one core token (author, series, title, order, number) is dropped entirely when that token is empty. A level combining two or more core tokens is flagged for review only if all of them are empty; otherwise it renders with whatever is there. narrator, publisher, year, asin, edition, filename, and original are decoration, not core: they never count toward that 2-or-more check, so e.g. {series} [{edition}] with no edition behaves exactly like a bare {series} (collapses silently, brackets and all, rather than flagging or leaving a stray "[]").
Filename cleanup, worked example. Say a loose single-file book (title "The Great Book") has the messy source The Great Book - Some Author {Jane Narrator} [64].m4b and you want to stamp the ASIN onto it without retyping the name. A filename part of {filename} [{asin}] sees the release junk, falls back to the clean title, and appends the identifier, producing The Great Book [B002UZZDDU].m4b. (If the source name had been tidy to begin with, it would be kept verbatim instead of swapped for the title.) If the source path already contained B002UZZDDU, it is not duplicated; if it contained a different ASIN/ISBN, the book is flagged for review but still moved. Want zero cleanup? Swap in {original}: {original} [{asin}] leaves every character of the source name untouched and only appends the tag, giving The Great Book - Some Author {Jane Narrator} [64] [B002UZZDDU].m4b. You cannot use {filename} and {original} together, so pick one.
Example: {author}/{series} [{edition}]/{order} - {title}/{filename} (the custom default shown above) renames the file, since its last part is a filename token rather than an empty trailing /.
Example scenarios
Live preview against a small set of bundled example books (metadata only, no real audio) covering distinct scenarios, updating as you edit the template above.
| Scenario | Folder | Filename |
|---|
Start organizer run previews destinations unless Apply moves is enabled. Index-only refreshes the cache and stops before move planning; consolidation should always be reviewed as a full-root dry run first.
It teaches the organizer how your library is already arranged
The cache is a saved map of existing author and series locations under the destination library root. Normal imports consult it so a new volume joins the established series folder instead of creating a parallel structure. It caches folder structure, not Audible searches or editable book metadata.
Enable Index library and exit. The organizer scans the destination library, replaces the saved cache, and stops without planning or moving books.
Leave both cache options disabled. The organizer loads the saved cache and uses it while planning books from the scan root. If no cache exists yet, one is built automatically.
Use Refresh cache before this run when folders were manually renamed, moved, or added and you want a fresh scan followed immediately by a normal preview or apply run.
The organizer refreshes the cache automatically after successful moves, so a separate index run is normally unnecessary.
For consolidation, set both roots to `/audiobooks`, enable consolidation, and run without Apply first.
Idle
No run yet.
Summary
Failed Moves
Moves that could not complete during apply. Every other move in the batch still ran; these need a manual look before re-running.
Suspicion Report
Analyzes the organizer report for items that deserve a closer look before applying moves -- bitrate artifacts in titles, sequence conflicts, loose-root files, and more.
Planned Moves
Each card represents one move from the scan root into the destination library root.