Add and manage libraries
A library is a folder on the server that AudioSilo reads for audiobooks or podcasts. You add and manage libraries in Library > Libraries in the admin console. You can have several, for example one for fiction and one for kids, and use shares to choose who sees which.
Adding a library
- Open Library > Libraries and click Add library.
- Choose the Kind: Books or Podcasts. You can't change it later.
- Type a Name, for example
Fiction. Each library needs a name of its own. - Type the Folder on the server, for example
/srv/audiobooks, or click Browse to pick it. - Click Add library and scan.
The library appears straight away and its first scan starts. Listeners don't have to wait: books appear as the scan finds them.
A Books library usually has a folder of its own. When the folder is another books library's, sits inside one or holds one, the console asks first. Each book would then be listed twice, once in each library. Add anyway goes ahead. Changing a library's folder asks the same, with Save anyway.

The form also has a scan schedule, files to skip and where book details come from. You can leave them as they are and set them later. See Scanning on a schedule, Skipping files and folders and Where book details come from.
There is no layout to choose for a Books library. AudioSilo works out which folders are books by itself (see Folder detection).
The folder must be one the server itself can read. If your audiobooks are on a NAS or network share, mount the share on the server machine first and use the mount point. If the server runs in Docker, mount the folder into the container and use the path inside the container (see Quickstart with Docker).
Podcast libraries
Podcasts need a Bridge and the Podcasts module. A podcast library needs its own folder. It can't share, contain or sit inside another library's folder. Mount the same folder read-write in the Bridge. See Set up a podcast library.
Folder detection, book details and exports apply only to Books libraries.
Editing a library

Each library is a card with its name, status, folder and book count. Its ⋯ menu holds everything else you can do to it.
To rename a library, point it at another folder or change how it's scanned:
- Click ⋯ > Edit library....
- Change what you need.
- Click Save changes.

Changing the folder or the skipped files rescans the library. When you change the folder, listening progress follows the books found at the same place inside the new folder.
If you're reorganising, move files within the library's folder where you can. Progress follows them (see Organize your audiobook files).
A library set in the server's config.yaml has a From your config badge.
Its name and folder can only be changed in config.yaml, followed by a
restart. Its other settings can be changed here.
Rescanning
Click Rescan on a library after you add, remove, rename or re-tag files. You can keep working while it runs, and a message says when it has finished. The command palette can also rescan one library or all of them.
Scans run one at a time. A library waiting its turn says Waiting. Health > Jobs shows what is running and waiting, and keeps a history of every scan.
Scans also run on their own when the server starts, when a library's settings change, and on its schedule.
A rescan never touches your files. Listening progress and bookmarks survive rescans, and follow a book when you move or rename its folder.
With ffmpeg 7.1 or 8.1, which the official Docker images have, the server
reads most files itself, so a first scan finishes much sooner (see
ffmpeg and ffprobe).
On a slow disk or busy network share you can make scans do fewer things at
once with scan.concurrency in config.yaml, then restart (see the
configuration reference).
Scanning on a schedule
If you add books to a library regularly, let it rescan itself. Open ⋯ > Edit library... and pick Scan automatically:
- Off: the default. Scan only when you ask, and when the server starts.
- Every hour up to Every 24 hours: counted from when the last scan started, so a rescan by hand pushes the next one back.
- Daily at a set time: pick the Time, in the server's time zone. If the server was off then, the scan runs as soon as it is back.
For a podcast library, the schedule only re-indexes the files the Bridge has saved. It doesn't set how often feeds are checked.
Skipping files and folders
Some folders hold audio that isn't an audiobook, such as sample clips or an
Extras folder. List what to leave out in Skip these files and folders
(in ⋯ > Edit library...), one pattern per line:
| Pattern | Skips |
|---|---|
*.sample.mp3 | every file ending in .sample.mp3, in any folder |
Extras/ | every folder named Extras, wherever it is (the trailing / means folders only) |
Podcasts/* | everything inside the Podcasts folder at the top of the library |
/Extras | only the Extras folder at the top of the library |
metadata.json | the metadata.json files Audiobookshelf leaves in book folders (see Audiobookshelf's metadata.json files) |
# publisher samples | nothing: a line starting with # is a comment |
* stands for any run of characters and ? for one character. Upper and lower
case don't matter.
Saving rescans the library. The scan removes skipped books from the library, but your files stay where they are.
Where book details come from
Book details come from (in ⋯ > Edit library...) decides where books take their title, author, series and series number from:
- The files' tags first: the default. Folder names fill in whatever the tags leave empty (see Where titles, authors and series come from).
- Folder names first: for a library whose folders are named well but whose
tags aren't. Names like
Author; Series; Book 04; Titleare read by their parts.
Whichever comes second fills in what the first leaves empty. An Audiobookshelf
metadata.json in a book's folder wins over both.
Changing this updates the books without a rescan. A large library finishes in the background, so for a while some books can still show the old details. Your own edits stay on top. On a book's page, values taken from folders are marked Path (see Editing details).
Library order
Drag a library by its handle to reorder the list. Players list libraries in this order.
When the same book is in two libraries, AudioSilo shows it once and uses the better copy. When both are equally good, the higher library wins.
Folder detection
AudioSilo works out what is a book with one rule: a folder that directly contains audio files is one book, and those files are its parts. Loose audio files at the top of the library are each a book of their own.
One layout can't be guessed: a folder of many unrelated single-file books, such
as a Short Stories folder of thirty standalone .mp3 files. By the rule, it
reads as one thirty-part book.
To fix that, click ⋯ > Folder detection..., open the folder and choose:
- Automatic: the default. AudioSilo decides.
- Always one book: all its audio files are one book. On a folder of disc folders, this joins the discs (see Books split into disc folders).
- Separate books: each audio file in the folder is its own book.

Your choice is saved at once and the library rescans. It survives rescans and even a full index rebuild.
The Folders page
Library > Folders makes the same choice with more room. Pick a library and a folder in the tree. The page shows the three choices with what each would mean for that folder ("Here: 12 books."), then the folder's audio files.

If the folder is a book, Open book opens its book page. A book's page has a Change detection button that opens its folder here.
A folder with more than 500 items lists the first 500. Show more lists the next ones. You can choose Always one book for a folder before the library's first scan has read it.
Books split into disc folders
A book ripped from CDs often has one folder per disc, with no audio in the book's own folder:
Audiobooks/
└── Terry Pratchett/
└── Mort/
├── CD1/
├── CD2/
└── CD3/
By the folder rule each disc reads as its own book. To join them:
- Open the book's folder (
Mort) in Library > Folders. - Choose Always one book.
The discs then play as one book, in disc order. Everyone's progress, bookmarks
and notes move onto the joined book. Disc folders are named CD, Disc or
Disk and a number. To undo it, set the folder back to Automatic.
The Health page lists folders like this, with a button that joins them.
Exporting a library
⋯ > Export book list downloads the library's book list as a .json file.
It is meant for AudioSilo Meta. Import it on the
site's Watching page to see which books of a series you are missing and
what is coming next.
It holds each book's details, but no file paths, folder names or tags, so it is safe to share.
Exporting with file paths and tags
⋯ > Export with file paths and tags... makes a fuller list for your own scripts, with each copy's path, tags and description. Keep this file to yourself. Don't post it publicly or upload it to AudioSilo Meta.
Both exports cover the whole library, not just the parts shared with one person.
Deleting a library
Click ⋯ > Delete library... and type the library's name to confirm.
Deleting a library removes everyone's listening progress, bookmarks, notes and listening history for its books, its folder detection settings and its folders in shares. Your audio files are never touched. To refresh a library, use Rescan instead.
A library set in config.yaml can't be deleted here. Remove it from
config.yaml and restart.
When a library folder goes missing
If a library's folder can't be read, often because a network share unmounted, AudioSilo stops the scan and removes nothing. It does the same if the folder is suddenly empty while books are still indexed, since that almost always means a dropped mount.
The library's card then says Folder unavailable, and the overview and Health show a notice. Listeners still see its books, but they won't play until the folder is back. Mount the share again (or fix the permissions), then click Retry.