Skip to main content

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​

  1. Open Library > Libraries and click Add library.
  2. Choose the Kind: Books or Podcasts. You can't change it later.
  3. Type a Name, for example Fiction. Each library needs a name of its own.
  4. Type the Folder on the server, for example /srv/audiobooks, or click Browse to pick it.
  5. 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.

Adding a library with the folder picker open

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).

Library folders must be on the server

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​

The Libraries page

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:

  1. Click ⋯ > Edit library....
  2. Change what you need.
  3. Click Save changes.

Editing a library: the folder, the scan settings and where book details come from

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.

Faster scans

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:

PatternSkips
*.sample.mp3every 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
/Extrasonly the Extras folder at the top of the library
metadata.jsonthe metadata.json files Audiobookshelf leaves in book folders (see Audiobookshelf's metadata.json files)
# publisher samplesnothing: 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:

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.

The folder detection dialog

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.

Library > Folders

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:

  1. Open the book's folder (Mort) in Library > Folders.
  2. 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.

Everyone's progress in the library goes too

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.