Fix book details
The Library section of the admin console is where you see every book on your server and fix what players show about it: titles, authors, series, covers and chapters. The quickest fix is usually to match the book with community metadata. You can also edit any field by hand.
Every edit is stored in AudioSilo's own database and kept through rescans. Nothing is written to your audio files or folders, and you can revert any edit.
Browsing books
Library > Books shows every book as a cover grid. Two shelves sit above it: Recently added, and Continue curating, which lists books missing a cover or a community match.

Above the list, type in Filter books to search, pick a Sort, or switch the View to a Table. Filters narrows the list by library, format, cover, community match, chapters, genre, tag, length and more.

Each view has its own address, so you can bookmark a filtered list.
Matching with community metadata
When community metadata is on, you can match a book to its entry in the free community database at AudioSilo Meta. Matching fills in missing details, such as the description, series, publisher and cover. It also gives listeners chapter recaps and the book's community chapters.
- On the book's page, click Match with community metadata. The dialog searches straight away, using the book's tags, its folder names, its length and any ASIN or ISBN.
- If the right book isn't listed, type in Search the community database, or paste an ASIN or ISBN, and click Search.
- Under Possible matches, pick the right one and click Compare fields. Each match shows how closely it fits and how its length compares with your files: within 2% it matches, within 5% it is close.
- If the book was recorded more than once, pick the right Edition. Check its narrators and length against your files.
- Tick the fields to Take. Fields you edited yourself start unticked, and so does the cover when the book already has one.
- Click Accept.

Accepted values are marked Community and are kept like your own edits. You can revert them the same way. Save or discard any unsaved edits on the page before you match.
To match many books at once, use Match automatically on the Health page (see Matching every book at once).
If the dialog says "meta.audiosilo.app isn't answering", try again in a minute.
If the book isn't in the community database at all, it stays unmatched and plays as normal. The database has gaps. When nothing matches, or none of the matches is close, the dialog offers Add it, which opens the Add a book page on meta.audiosilo.app with the book's ASIN, or your search, already filled in.
The community database holds books, their recordings, authors, narrators and series. Its users add and correct them, and many entries came from a public Audible catalogue. When a recording sells in several Audible stores, the Audible marketplace setting picks which store's edition a match takes (see Which ASIN a match takes). Every unmatched book is listed under Not matched to community metadata in Library health.
What matching sends
The server sends search terms to AudioSilo Meta only when you open Match with community metadata or run Match automatically:
- the book's tagged title, author, series, narrators and language, and its length;
- its ASIN or ISBN, else one from its tags or an Audiobookshelf import, and what you type;
- up to three names from its path (the author, series and book folders), never the full path.
It sends nothing about your server or who listens. With a local copy, lookups use the copy when it can answer, but can still fall back to asking online.
Books matched to a store listing
The community database holds some books as a store listing with no ASIN or ISBN. A match to one of them still counts. The book shows as Matched, and Match automatically skips it. Its Community metadata card says "No ASIN or ISBN: matched to its store listing". A book added from LibriVox says it is matched to its LibriVox recording instead.
A hand match also connects the book to its series in the player and to Upcoming releases. Community chapter checks and the console’s missing-books view still need an ASIN or ISBN. Downloading the book keeps its recaps and characters for offline listening.
Unlinking a community match
The book's Community metadata card shows what it is matched to. It offers Unlink whenever the book has a match, even with community metadata off. To remove the match:
- Click Unlink, beside Compare fields.
- Read the warning and click Unlink again. There is no undo.

Unlink removes everything the match wrote, including its cover. Your own edits and uploaded covers stay. An ASIN or ISBN from the book's files, or one you typed, also stays, so the book still shows as matched.
You can't unlink while a match run is applying matches to that library.
Recordings of the same book
Your server may hold one book in more than one recording: two narrators, an abridged and an unabridged one, a dramatisation. The players keep them together, with one spine on a series page and an Other recordings in your library card on each book's page (see More than one recording of a book).
The server knows two recordings are the same book when both lead to the same book in the community database:
- A match you made in the console counts first, with Match with community metadata or Match automatically. Use it for a recording with no ASIN or ISBN, or one whose identifier leads to the wrong book.
- Otherwise, the book's ASIN or ISBN. The server looks up new and changed books once a day, and shortly after a scan finds some.
This needs community metadata switched on. It works with Check for upcoming releases switched off too: the server still looks up which book each recording is, and nothing else. Two books with the same ASIN (or, when one has no ASIN, the same ISBN) are copies of one recording, so a recording is listed once, never once per copy. Within one library, Health lists them as Likely duplicates.
A listener only sees the recordings they can open. Someone whose share holds one recording sees no sign of the other.
A book's page
Click any book to open its page.

Besides Match with community metadata and Change cover, the top of the page has Listen in player, which opens the book in the web player already signed in. The ⋯ menu has Read the files again, which re-reads the book's files at once. Use it after you fix its tags.
Further down are the book's files, its ebook and Read-along card if it has one, and its path on disk.
Editing details
The Details card lists the title, subtitle, author, narrator, series, published date, genres, tags, description, ASIN, ISBN and more. To change one:
- Click the value and type the new one. Press Enter to keep it, or Escape to cancel. (In Description, press Ctrl+Enter or ⌘+Enter.)
- Click Review and save in the bar at the bottom of the screen.
- Check the changes and confirm. The value now shows the Edited marker.
Genres and Tags are lists. Press Enter or a comma after each label. Use tags however you like, for example "Owned" or "Book club".
A book in more than one series has a main Series and Series number, and
the rest in Other series, written like Discworld: City Watch #1; Omnibus.
To make another series the main one, type its name into Series and the two
swap places.
Each value has a marker saying where it came from: File tag, Path (the folder names), Audiobookshelf, Edited or Community. An edited or community value has a Revert button that puts back what the files say.
Numbering an omnibus or box set
A book that holds several books of a series takes a range as its Series
number, such as 1-3. In Other series, write it as Box Sets #2-4. The
Series page then counts the omnibus as books 1 to 3, and in an
up-to-date app the next book after it is book 4. A range in a file or folder
name isn't read, so type it in here.
Covers
Click Change cover > Upload an image... to set a custom cover: a JPEG, PNG or WebP image up to 5 MB. It is stored in AudioSilo's database, never in the book folder. Remove the custom cover goes back to the book's own art.
You can also take a cover from community metadata when you match the book.
Chapters
The Chapters card shows the book's chapters as a timeline and a list. Click a chapter's title to rename it. A revert button puts the file's title back.
Edit chapter times and titles
Edit chapters on the Chapters card lets you move, add, delete and rename chapters. Your list is saved on the server. The audio files are not changed.

Each row is a chapter's start time and title. Times count from the start of the
book, like 1:02:03 or 12:34.5. A row with a lock starts one of the book's
files. You can rename it, but its time is fixed and it can't be deleted, so no
chapter runs from one file into the next.
When the editor's player is waiting for the server to convert the audio, it keeps trying. Stop trying again ends the retries.
To edit the chapters:
- Open the book's page and click Edit chapters on the Chapters card.
- Change the rows:
- type a new time or title;
- click + on a row to add a chapter after it, or the bin to delete it;
- enter seconds in Shift all by (negative for earlier) and click Shift to move every unlocked chapter. Nothing moves if a chapter would leave its file.
- Click Save chapters.
Players use the new chapters, and downloaded copies update theirs. The card says Chapters edited on this server., with who saved them and when. While your list is in use, rename its chapters in the editor.
Find the moment by ear. Click a row's number to load its file in the editor's player. Step back or forward by a second or a tenth, or click Play 5 s to hear the chapter's start. Set to playhead moves the chapter there, and Add at playhead adds one.
Paste a list. Click Paste timestamps and paste one chapter a line, the time and title either way round:
0:00 Opening credits
12:34 Chapter 1
Chapter 2 1:02:03.5
The preview lists the chapters and the lines it left out. Replace chapters uses it. A pasted chapter within a second of a file's start gives its title to that file's locked row.
What a save needs. Chapters start at least a second apart, inside the book. Each title is one line of at most 200 bytes, and a book has at most 2,000 chapters. The editor marks a row that breaks a rule and saves once it's fixed. If the book's files change while you edit, nothing is saved. Cancel and edit again.
Revert edit deletes your list. The book goes back to the community's chapters, the ones found in the narration, or the files' own.
Your list belongs to the book's files as they were. If a file is replaced, re-encoded, renamed, added or removed, the card says Your edited chapters are set aside and listeners get the book's other chapters. Put the files back to use your list again, or revert it. Moving the book's folder keeps your edit. So does renaming the file of a book that is one audio file, in its own folder or loose in the library.
Community chapters
The community database on AudioSilo Meta has chapter lists for most of the recordings it knows. When community metadata is on, AudioSilo checks each matched book against the chapter list of its recording. The Community chapters panel on the Chapters card says what it found.
A book with no chapters of its own uses the community chapters automatically. Otherwise the panel offers a button to use them when they are more detailed or better titled, or says why they can't be used (another edition, say). Use the file's chapters always goes back to the book's own.
AudioSilo fits each community chapter onto the pause in the audio where it starts. This needs ffmpeg. Without it, starts may be a few seconds off. Checks run in the background; Check now runs one straight away. An ASIN in the tags alone isn't enough. The book must be matched first.
Chapters found in the narration
A book that is one audio file with no chapters can get chapters from your Bridge, which finds them in the narration (see Detect chapters). The Chapters card then says Found in the narration on this server. Click Use the file's chapters to turn them off, and Use automatic to bring them back.

Characters and recaps
When community metadata is on, the Characters and recaps card shows the book's characters and chapter recaps, the same ones the players show. They come from the community database or from your Bridge.

Recaps give the story away, so each stays closed until you click it. The card has no spoiler protection beyond that.

With a Bridge paired, the Community metadata card can also Generate characters and recaps for the book (see Generating characters and recaps). With the Contributions module on, it can suggest corrections to the community database or share what the Bridge wrote.

Listeners and who can see the book
- Listeners lists everyone who has started the book, with their progress. Each has a menu to mark the book finished, edit their dates or see their sessions (see Editing someone's progress).
- Who can see this lists each share that includes the book. Add to a share adds it to one. A book in no share is only for admins and the people in an admin's household.
Changing many books at once
- In Library > Books, press Select, or tick a cover's checkbox.
- Click books to select them. Shift-click selects a run, and Select all selects every book shown.
- In the bar at the bottom, choose an action:
- Edit fields sets Author, Narrator or Series on every selected book, and adds or removes tags and genres. Only the fields you fill in change.
- Add to share adds the books to a share.
A bulk action takes up to 1,000 books at a time.
Authors and narrators
Library > Authors and Library > Narrators list everyone in your libraries, with how many books they have. Click a name to see their books. A book credited to two people counts for each of them.

Merging two spellings
When two names look alike, a suggestion appears above the list, for example "“Sanderson, Brandon” looks like Brandon Sanderson". Click Merge authors (or Merge narrators) to set one spelling on every book, as an edit. The confirmation has an Undo button.
Series
Library > Series has a card for each series, with its books as spines in series order. Click a spine to open that book. Type in Find a series or author to narrow the list.

Spellings that differ only in capitals, accents, punctuation or spaces count as one series. Other differences ("The Expanse" and "Expanse") make two series. Fix those with a bulk edit, or use Series spelled several ways in Health.
With community metadata on, a series with a matched book also shows the books you don't have, as dashed gaps: "You have 1, 2, 4 of 5; missing 3, 5". A gap shows its release date when known, marked Preorder or New. A release stays new for the New release window, 90 days by default. Only whole numbers make gaps, so a novella at 2.5 you don't have is left out.
With a Bridge that can write characters and recaps, Generate for the series queues them for each book in the series that has none yet.
The Series page only arranges what it shows. To change a book's series number for listeners too, edit its Series number on the book's page.
Good to know
- An ASIN or ISBN you leave unticked, or revert, stays off. Fill in matched books doesn't write it back.
- The community database has no genres or tags yet, so matching never changes them.
- A value made only of invisible characters counts as empty. A title or chapter title like that is refused.
- A book using your edited chapters gets no chapter detection. See Books that get no detection.
- The chapter editor's player plays every file when the server has ffmpeg.
A file your browser can't play as stored, such as Opus, FLAC or MP3 in an
.mka, plays through the server's conversion, and you can still seek. A file that still doesn't load can't be played, but you can type the times. - The editor is light on the server. When the server is busy it says The server is busy. Trying again in a moment. and tries again. Paused or left open, it frees the server's conversion. Listeners in the players are not affected.