Media Management

Settings > Media Management controls where books live and how files move in. Settings marked advanced appear with Show Advanced.

Root Folders

A root folder is a directory ABM manages books in. Add one with Add Root Folder, which opens a folder browser with a typeable path. ABM can also list unmapped folders under a root and import them. A root’s free space and hardlink support are checked when it is added. Removing a root asks what to do: Remove from ABM only (the default) forgets the books under it and leaves the files, and Delete the books and their files permanently deletes everything under the path without using the recycling bin. A root with books in it makes you type to confirm.

The default root folder is the one new books go to and the one that decides whether hardlink is offered for Library Import.

Folders

Setting	Default	Effect
Create Empty Book Folders	off	Creates missing book folders on add, on root folder change and during a disk scan. Ignored while Delete empty folders is on, so a folder is not made only to be removed.
Delete empty folders	off	Deletes empty book folders during a disk scan and when book files are deleted

Importing

Setting	Default	Effect
Skip Free Space Check	off	For when ABM cannot detect free space on a root
Minimum Free Space	100 (MB)	An import that would leave less than this is refused
Use Hardlinks instead of Copy	on	For completed downloads: hardlink instead of copy, so seeding does not double the space. Needs the same volume.
Library Import	Copy	The default for Library Import: copy, hardlink or move. Hardlink is greyed out until the default root has been checked and supports it.
Import Extra Files	on	Master switch for bringing non-audio files along. Applies to Library Import, Manual Import and completed downloads
Extra File Extensions (advanced)	empty	More file types to bring along, kept under their own names, for example srt, lrc. With or without the dot, separated by commas or spaces. Blocked types, such as executables and partial downloads, can’t be saved. Disabled while Import Extra Files is off
Preferred Cover (advanced)	Matched	Matched edition’s cover, or the folder’s best image, when both exist

Import Extra Files brings a book’s other files along with its audio. Five switches pick which kinds come along, and a file matching Extra File Extensions comes along even when its kind is switched off:

Switch	Default	Covers
Cover art	on	Cover plus back-cover and booklet scans
Book info files	on	metadata.json, .opf, .nfo, desc.txt, reader.txt
PDFs and companion docs	off	PDFs shipped with a book
Chapters, transcripts and playlists	on	.cue, chapter lists, subtitles, lyrics, playlists. File names inside them are rewritten to the renamed audio.
Audible originals and ebooks	off	.aax/.aaxc, vouchers, epub and similar

Partial downloads and executables are never imported. ABM’s own metadata.json is always handled by ABM.

Hardlink is not the same as Use Hardlinks instead of Copy. That one is for downloads. The Library Import default is only what the Add to Library dialog preselects.

File Management

Setting	Default	Effect
Unmonitor Deleted Books	off	A book deleted from disk is unmonitored
Change File Date	None	Changes file dates on import and rescan
Enable Recycling Bin	on	Deleted book files move to a bin instead of being deleted
Recycling Bin	empty	Where the bin is. Empty uses ABM’s default (/config/recycle/media)
Recycling Bin Cleanup	7 (days)	0 disables automatic cleanup
Library Scan Interval	24 (hours)	Hours between automatic scans
Watch for Changes	on	Scan when files are added, removed or changed
Cover Cache Workers	4	How many covers are downloaded at once when caching artwork, from 1 to 16

Quality Upgrades

Setting	Default	Effect
Automatic Upgrade Search	on	Periodically searches for better releases of downloaded books still below their cutoff. A copy replaces yours only when it is a real upgrade.
Upgrade Search Interval	24 (hours)	How often it runs

Permissions (advanced)

Setting	Default	Effect
Set Permissions	off	Run chmod on import and rename
chmod Folder	755	Octal mode for folders and files, without execute bits for files
chown Group	empty	Group name or gid. Use a gid on remote file systems

Gotchas

• If the recycle bin is enabled but its folder is unavailable, deletes that need it fail instead of deleting permanently.
• Hardlinks only work inside one filesystem. Files that cannot be linked are copied, never moved, and counted in the import result.

If you know Sonarr: this is Sonarr’s Media Management without naming formats. Folder names are chosen by ABM. Bulk rename lives on Library, Series and Authors as Rename Files.