Check your library's health
The Health destination in the admin console lists problems with your books, follows your scans and checks what the server depends on. It has three pages:
- Issues lists books with a problem, such as files that couldn't be read or missing covers, with a fix for each.
- Jobs shows the scans running, waiting and finished, with their logs.
- System shows everything the server depends on, with a status for each.
Nothing here changes your audio files. Fixes are saved in AudioSilo, and an
issue you ignore is only hidden. The one exception is Detect chapters. The
Bridge
saves the chapters it finds
in a .audiosilo folder beside the book.
Library health
Open Health in the top bar, or click Triage on the overview's Needs attention card. Each kind of issue has a card with how many books are in it. Click a card to open its list.

Check again rescans every library, and the issues update as each finishes.
The kinds of issue
| Card | What it means | How to fix it |
|---|---|---|
| Files that couldn't be read | A file couldn't be read, is empty, or isn't audio. The row gives the reason in one line; for a file that isn't audio, Details shows the full message. | Fix the file or its permissions. Read again checks it straight away; otherwise the next scan does. |
| Folder may hold several books | A folder reads as one book but looks like it holds several. | Choose detection opens the folder in Library > Folders. Then choose Separate books or Always one book. |
| One book split into disc folders | A book ripped from CDs reads as one book per disc. | Join into one book. See Books split into disc folders. |
| Likely duplicates | Copies of one book in the same library. | Compare them side by side. See Duplicates. |
| Missing covers | No cover in the book's folder or files. | Upload a cover opens the book's page (see Covers). |
| Not matched to community metadata | The book has no community match, so players can't show its community details. Only shown while community metadata is on. | Review match opens the match dialog. To match the whole list, use Match automatically. |
| ASIN not in the community database | The book has an ASIN the community database doesn't know yet. It counts as matched but gets no community details. Only shown while Help complete the community database is on, since that is what finds them. A book leaves the list once the community database knows its ASIN. | Find matches by title looks up the whole list (see Books with an ASIN the community doesn't know). Review match finds one book by its title. Add it opens the Add a book page with its ASIN filled in. |
| Series spelled several ways | Books of one series spell its name differently. | Use this spelling. See Series spelled several ways. |
| Long books without chapters | Books over two hours with no chapters, so listeners can't skip between them. | Detect chapters with your Bridge (see Detect chapters), or match the book to use its community chapters. A book using chapters you edited offers no Detect chapters until you revert the edit. |
| More detailed chapters available | The community database has finer chapters that fit this copy. | Use detailed chapters. |
| Converted to play in browsers | The format doesn't play in web browsers, so the server converts it for the web player. The apps play it as it is. | Nothing needed: it works. |
A slow disk or network share can time out a scan. Its books show reading it timed out and keep their length and chapters. A single file that took too long is listed under Files that couldn't be read with took too long to read as audio, which is not a damaged file. The next scan tries both again. A drive or share that stops answering holds up only the libraries on it. The other libraries scan as usual.
Working through a list
Under Long books without chapters, each book shows its chapter detection job while it is queued, running or waiting for attention. Open the book’s Chapters card for the job details.
- Ignore hides a book from this list, even through rescans. Show ignored lists them, each with Show again.
- Tick several rows (or Select all) to act on them together from the bar at the bottom. Shift-click selects a run.
Duplicates
Likely duplicates shows each group of copies side by side, with the copy worth keeping first. That is the better format (M4B/AAC over MP3), then a single file over several, then the higher bitrate, then the copy more people listen to.

- AudioSilo never deletes a copy for you. To remove one, delete its files from the library folder and rescan.
- If they are really different books (two narrations, say), click They're different books.
- Include other libraries also compares copies across libraries.
Copies that share an ASIN or ISBN but have different lengths may not be copies at all. One may be matched to the wrong recording. Check before you delete either.
Series spelled several ways
AudioSilo already shows spellings that differ only in capitals, accents or punctuation as one series. But the books still say it differently in the players' details. This list fixes that.
- Use this spelling sets one spelling on every book of the series, as an edit. Pick another spelling from the list beside it if you prefer. The message has an Undo button.
- Ignore stops suggesting that series.
When a library is offline
If a library's folder can't be read, a notice says "name is offline. Nothing was deleted." Once the folder is back, Retry scans it. See When a library folder goes missing.
Matching every book at once
Not matched to community metadata has a Match automatically card above its list. It looks up every book in the list in one pass. Nothing changes until you review and apply what it found. While there are unmatched books, the overview, Library > Books and an applied import's Past imports show how many, with a Match automatically button that opens this list.
- Pick a library and click Find matches. You can leave the page while it runs. If the community service asks for a pause, the card says so and the run carries on by itself.
- When it's done, click Review and apply.
- Choose What to write:
- ASIN and ISBN only marks each book matched and changes nothing else.
- Fill in what's missing (the default) also fills empty fields, adds a cover where there is none, and tidies cluttered titles.
- Use community values also replaces fields that differ. Fields you edited yourself are never replaced.
- Check each match and what it would write. Confident matches are ticked; untick any that are wrong. To review lists matches you need to check. Tick the right ones, or click Match by hand.
- Click Apply to N books. The server applies them in the background.

A match is confident when it scores 90% or more and leads the next candidate by at least 10 points. Its length must also be within 10% of the book's (20% when the book's narrator reads it). Weaker matches, and matches to a dramatization your book doesn't seem to be, go to To review.
Whatever a run writes is a Community value that you can revert on the book's page. A book you match by hand after the run found its match keeps your match. The run skips it and says Matched since this run. To undo every community match at once, use Clear community matches. If community metadata lookups stop answering, the run stops early but keeps what it found. While the community service is only busy, the run waits and carries on.
Books with an ASIN the community doesn't know
ASIN not in the community database has a Find matches by title card above its list. It works like Match automatically, but looks each book up by its title and records the match, so players get the community details. Nothing changes until you review and apply. An ASIN you set yourself is never replaced. A book whose ASIN the community database learns before you apply is left as it is.
The list appears once the server has its first result for the report. A book with an ISBN can still be listed if its ASIN is unknown. Turning the report off hides the list.
Weak matches
When the best candidate scores under 60%, the community database most likely doesn't have the book. It is listed under Not found. You can still match it by hand. Once a run has nothing left to review, See the books it didn't find lists them with their best scores. The match dialog lists the closest candidates, however low they scored.
The community database has gaps, so some books stay unmatched. They still play and keep the details from their tags and folders. Each Not found row has Add it, which opens the Add a book page on meta.audiosilo.app with the book's title and author filled in.
ASIN and ISBN tags are hints
An ASIN or ISBN in a book's tags is only a hint for a match, because tags are often wrong about it. It never becomes the book's own, so the book shows under Not matched until a match applies. A hint the community database knows makes a confident match when the length and title fit.
A tag naming a similar book, or another recording, can still look confident. If you don't trust where your tags came from, check Confident before you apply. Correct the tag, or match the book by hand, to stop it coming back.
Audiobookshelf's ASINs and ISBNs
Audiobookshelf's identifiers reach AudioSilo in two ways, and they count differently:
- From an Audiobookshelf import. They are match hints, like tags. A match looks them up before the book's tags, and the book stays Not matched until a match applies. A wrong one can look confident too, and correcting the tag doesn't stop it: match the book by hand.
- From a
metadata.jsonfile beside the book. The ASIN or ISBN counts as the book's own straight away, so the book is matched (see Audiobookshelf's metadata.json files).
Store listings with no ASIN or ISBN
The community database holds some books as a store listing with no ASIN or ISBN (see Books matched to a store listing). A run applies such a match on its own only when it scores 90% or more, names the book's author in full, sits at the book's place in its series, and fits its length within 2%. Otherwise it goes to To review.
Tidied titles
Fill in what's missing replaces a title only when it is the community database's title plus clutter, such as the series name, a book number or "Unabridged". "Emergence: The Mystic Knight, Book 1 (Unabridged)" becomes "Emergence". A title you edited yourself is never tidied.
Which ASIN a match takes
A recording sold in several Audible stores has an ASIN in each. A match takes the one from your Audible marketplace (in Server settings), then the US store's. Once a marketplace is set, Use country ASINs switches books matched earlier to your store's ASIN.
Filling in books that are already matched
Fill in matched books offers the community database's latest details for books that are already matched. Use it for books that got an ASIN without their details, or to clean up series an earlier match added. It never brings back an ASIN or ISBN you left unticked or removed. For a book matched before version 2.7.0, accept its match again with a field ticked, or unlink and match it again.
Jobs
Health > Jobs is where scans are. Scans run one at a time, so they never compete for the disk.

- Running now shows the current scan and its progress. Stop ends it without removing anything from the library.
- Waiting lists the scans queued behind it. Cancel drops one.
- Run a job starts a scan of one library, or every library.
- Schedules lists every library that is scanned automatically. You set schedules when you edit a library.
History
History lists every scan, newest first: the library, who or what started it, how long it took and what it found. Click Log to see a scan's details: books found, moved and removed, and every file it couldn't read and why. AudioSilo keeps the last 100 scans of each library.
What a removed book leaves behind
When a book's files are gone, a scan removes it from the library and notes it in the log. AudioSilo remembers its progress, bookmarks, edits and cover by the book's path, so if the files come back to the same place, they come back too.
A scan that couldn't read part of the library removes nothing. See A scan says part of the folder couldn't be read.
System
Health > System lists everything the server depends on, one row each, with a status such as Healthy, Needs attention, Missing or Off.

| Row | What it tells you |
|---|---|
| ffmpeg | Converts formats browsers can't play, and places community chapters exactly. |
| ffprobe | Reads lengths, chapters and codecs for the few files AudioSilo can't read itself. Without it, those files have no length or chapters. |
| Community metadata | Whether community metadata lookups are answering. |
| HTTPS certificate | Days left. Needs attention within two weeks of expiry. |
| Database | Its version. Accounts and progress live here, so the server makes backups. |
| Backups | When the last backup was made and when the next one runs. |
| Each library | Free disk space. Needs attention below a tenth free, or when the folder isn't reachable. |
| Web player | Whether people can listen in a browser. |
| AudioSilo version | Whether a newer release is out. See About and updates. |
To change any of this, see Server settings.
The local copy of community metadata
When the server keeps a local copy of the community database, the Community metadata row shows that copy's status, version and size.

The server checks for a newer copy once a day, or click Check now. A failed update keeps the current copy in use.