Help needed writing documentation! This website is on github. Join the discussion, report an issue or contact me directly at advplyr@protonmail.com.
Audiobookshelf relies on you already having an organized directory structure. This is because information is taken from your folder names. This includes the author name, series name, book title, publish year, volume number, and subtitle.
Here is an example supported directory structure (Note: Author names can also be Last, First)
Terry Goodkind
<-- Author
Sword of Truth
<-- Series
Vol 1 - 1994 - Wizards First Rule
<-- TitleAudio Track 1.mp3
Audio Track 2.mp3
Cover.jpg
Vol 2 - 1995 - Stone of Tears
<-- TitleAudiobook.m4b
Heart of Black Ice - Sister of Darkness
<-- TitleAudio File.m4a
Steven Levy
<-- Author
Hackers - Heroes of the Computer Revolution
<-- TitleAudio File.m4a
1945 - Animal Farm
<-- TitleAudiobook.mp3
Files must always be in a directory with the book title. Files in the root directory are ignored.
The title directory can be in the root directory, an author directory, or a series directory.
In addition to the book title, the title folder can include the publish year, volume number, and the subtitle.
Here are a bunch of ways the same book could be named:
Wizards First Rule
1994 - Wizards First Rule
Wizards First Rule - A Really Good Subtitle
1994 - Book 1 - Wizards First Rule
Vol 1 - 1994 - Wizards First Rule
1994 - Wizards First Rule - Volume 1
Vol. 1 - 1994 - Wizards First Rule - A Really Good Subtitle
(1994) - Wizards First Rule - A Really Good Subtitle
- Parsing out subtitles into a separate field is optional and must be enabled in settings.
- Different parts of a name should be separated by " - ", with the exception of the volume number (spaces aren't needed).
- The publish year must be the first part of the name OR directly after a volume number, and separated by " - " on both sides.
Audiobookshelf uses the ID3 metadata tags in audio files to populate data.
Metadata is only mapped to audiobookshelf if the field is empty. Data parsed from the folder structure and filenames takes priority over ID3 tags.
Metadata on audio files will be mapped as follows:
| File Metadata | Audiobookshelf Data |
|---|---|
| Artist | Author |
| Subtitle | Subtitle |
| Publisher | Publisher |
| Year | Publish Year |
| Composer | Narrator |
| Description | Description |
| Genre | Genres * |
| Series | Series |
| Series-Part | Volume Number |
* Genre meta tag can include multiple genres separated by "/", "//", or ";". e.g. "Science Fiction/Fiction/Fantasy"
Embedded cover art will be extracted and used.
If you have a file named desc.txt in the audiobook folder it will be used as the description.
If you have a file named reader.txt in the audiobook folder it will be used as the narrator.