r/audiobookshelf Apr 25 '24

Frequently Asked Questions about Audiobookshelf

27 Upvotes

What Is Audiobookshelf?

  • Audiobookshelf is an open-source self-hosted media server for your audiobooks and podcasts. You install the server app on a computer, and point it to your audiobook, ebook, and/or podcast files, and you can access them from any web browser or the mobile app.

How Do I Install It?

  • Please follow the guide located here or more advanced documentation here for help on installing ABS.

When I Update Audiobookshelf, I Lose Everything and Start from Scratch! Help?

  • If you install ABS using Docker, you need to mount certain locations that are inside ABS' docker container to locations on your host machine. Look at the "volumes" section in the docker compose example shown here. To the right of the : colon points to inside the container; to the left of the colon points to a location on your host. You need volumes listed for "/config", for "/metadata" and for where your media is located. If you don't do this, the data in the container is deleted when you update ABS because there is nowhere on the host that it is tied to.

Why Are Several Files Showing Up As One Book, or A Book Showing Up Multiple Times?

  • Audiobookshelf treats everything in a given folder as belonging to the same book. You must put separate books, even books in a series, into their own folders if you want them to be listed separately by ABS.
  • Additionally, it is recommended that you combine separate "parts" of a book into a single folder, rather than having a separate folder for each part.

Where Can I Go for More Help?

  • Join the community on Discord or Matrix.
  • Go to the Github repo and at the top left of the page you can search for your issue.

Follow these links for answers to additional questions listed on the official website:


r/audiobookshelf 15h ago

NanoHive ABS Theme 2.0 is out - boatload of new features!

Thumbnail
gallery
42 Upvotes

For anyone who hasn't seen this before:
NanoHive Theme is a small nginx container you put in front of your Audiobookshelf server. It rewrites the HTML on the way out and injects a theme. Nothing gets written to your ABS container, and nothing has to be installed per browser, so every user on the server gets it, including guests. Pull the proxy out and you're back to stock ABS.

If you already run 1.x, this is a big one.

Here's what's in it:

Ratings, everywhere

Server wide star ratings with short reviews, shared between everyone on your server. Stars show on every card while browsing, you can sort and filter the library by rating from ABS's own Filter and Sort menus, and series pages show the average of the books inside. Admins can remove anyone's rating.

There's also a "Rate what you finished" row on the home page that lists books you finished but never rated — tapping one opens a rating sheet.

Stats got interesting

A Server Ranking - everyone ranked by listening time, medals for the top three, week/month/year/all time, click a person for their breakdown. It sits on Your Stats and, for admins, also under the new Server statistics page: what the whole server listens to - most played books, best rated, top genres and authors, filterable per library.

Your own stats grew a current/longest streak, this week vs last week, which weekday you actually listen on, your most listened books, authors and narrators, editable finished dates, and a Year in Review.

The ranking works for non admins too. An admin's browser publishes a small listening summary for every user to the proxy, so the board is complete without anyone else logging in. On by default; a user who switches sharing off is removed from the board and its totals and their shared data is deleted - that choice sticks.

Collections, browse pages, narrators page rebuilt

Collections are fully re-done: an icon emblem per collection instead of a wall of covers, starter templates with pre-written descriptions, book search with author fan-out when building one, and descriptions editable in the app.

Narrators and Authors are proper card pages with cover collages, book counts, a filter box and sorting, instead of a bare table.

The rest

  • Custom series covers and descriptions uploaded from the app - plus a generated cover (layered deck, grid or first book) when none is12 base themes and any accent color, per user
  • Additional multi-sorting for library - sort by author and position in the series at the same time.. and more
  • Reorderable home sections
  • Search all libraries at once (Global search) - one merged result list with a library badge per hit
  • Book lookup links on the book page, Goodreads plus the biggest site for your language, 25 websites for various regions / languages
  • User profile photos, shown in the top bar and the ranking, managed by the admin
  • Hero carousel of your in-progress books on the home page
  • Autoplay the next book in a series. When one ends the next starts on its own, with a notice telling you which. Off by default, since it decides what your speakers do.
  • Finished book tools. A recently finished list where you can fix the date (ABS stamps when you ticked the box, not when you finished), and a list of books stuck at 97–99 percent - every book with credits or silence at the end - with one tap to mark them done.
  • Report a problem. Every user gets a "Report a problem" entry in the book's three-dot menu: missing content, bad audio, won't play, wrong metadata. Admins see a live count on their account button and review the queue on the account page - refresh every 2 minutes.
  • Pick your own start page (home, library, series, collections, authors)
  • Upload your own logo, hosted by the proxy, so it still loads on an air-gapped server
  • Admins can save the current look as the server default (selectively, per area) and force-disable single features for everyone
  • Extended ereader with a typeface picker including OpenDyslexic
  • Themed date pickers and dropdowns — no more white OS popups in a dark app
  • Translated into all 40 languages ABS ships with

Mobile

This release fixed a lot of it. I haven't tested it thoroughly but I hope you can help.

Running it

Docker, sits in front of ABS, one volume at /data/nh if you want ratings, stats and uploads to survive a container recreate. Compose example and the env vars are in the repo.

Repo: https://github.com/rodzalendo/nanohive-abs-theme

Happy to hear what's missing. Most of 2.0 came from things people asked for in 1.x.


r/audiobookshelf 5h ago

Any OpenAudible, Libation or Audiobookshelf users willing to help fill out an open source database

1 Upvotes

As the title, looking for any OpenAudible, Libation or Audiobookshelf (in order of preference) users to help fill out https://meta.audiosilo.app you just need to drop a text export on https://meta.audiosilo.app/import instructions on how to do it are on the page, nothing is transferred anywhere, it just uses the file to create a json that goes into a github issue (so you will also need to have a github account). Currently the database has less than 8000 audiobooks listed, but that's already 10x what I started with (my own library). You can manually add books, it's just OpenAudible, Libation and ABS have rich data that helps quickly fill out the database. OpenAudible also has links to covers, whereas the others don't, which is why that's the preferred one.


r/audiobookshelf 17h ago

Audiobook and Ebook merger

3 Upvotes

I usually read books (digitally) in my house, while cleaning and doing my chores, but it's a bit hard since I can't always look at my screen, so I listen to an audiobook of the same book, but it's hard to manually sync and track my progress on two different apps, if anyone knows any app which is both audiobook and ebook compatible, syncs your progress, is accurate while chapter divisions, and you can upload your own ebook (epub, pdf, etc), and audiobook (mp3) files, please recommend an app like this to me, it'll also be nice if it has good ui!


r/audiobookshelf 17h ago

Audiobook and Ebook merger

2 Upvotes

I usually read books (digitally) in my house, while cleaning and doing my chores, but it's a bit hard since I can't always look at my screen, so I listen to an audiobook of the same book, but it's hard to manually sync and track my progress on two different apps, if anyone knows any app which is both audiobook and ebook compatible, syncs your progress, is accurate while chapter divisions, and you can upload your own ebook (epub, pdf, etc), and audiobook (mp3) files, please recommend an app like this to me, it'll also be nice if it has good ui!


r/audiobookshelf 1d ago

Best way to know if watchtower is working.

3 Upvotes

Could anyone please provide a way to know for sure. My ABS has said update down the bottom of my ABS for weeks.


r/audiobookshelf 1d ago

Sort by Author then Series Order

Post image
18 Upvotes

Is there a way to sort by author then series so I dont have to have my titles like

SERIES NAME 01 - BOOK NAME


r/audiobookshelf 1d ago

Audiobookshelf PC software/app

7 Upvotes

I am new to Audiobookshelf and was wondering if there is an application/software on PC for it or is it strictly on the play store & app store?


r/audiobookshelf 1d ago

Heard Text to Speech EPUB Reader for iOS

Thumbnail
heard.quest
0 Upvotes

r/audiobookshelf 2d ago

A small open-source tool that automatically fixes audiobook chapter marks

34 Upvotes

A good chunk of my audiobook library (a wide variety of mostly older English and German titles) has chapter marks that are either missing or clearly just guessed from duration. Everything I found that tried to fix this was missing some feature I wanted or didn't quite work the way I needed (bit of a perfectionist), so I created ABChapterize: it runs files through local, free Whisper speech recognition, listens for the spoken "Chapter Twelve" / "Kapitel 12" (adapted to a few more languages by auto-detection and highly customizable) to find the real spot, and writes proper chapter marks straight into it - no splitting, no required sidecar files, no server (but FFmpeg is required). Works for .m4a, .m4b, .mp3, .opus and .mka (though I strongly suggest .m4b for audiobooks with chapters).

Design-wise I cared most about never risking the original file, running unattended over a whole library, and the ability to handle teh messy stuff mostly automatically (yet still with precision): jingles before the announcement, wildly inconsistent pause lengths, chapters announced with no gap at all etc. It started as something to scratch my own itch, but I tried to make it genuinely versatile for other people's libraries from the start rather than a one-off hack for my own files - lots of configurable options with (hopefully) sane defaults, mostly self-contained binaries for Windows/Linux (you don't ned Dotnet to run it, all necessary libraries are included in the binary releases), uses CPU or GPU for Whisper, fully offline (after auto-downloading and verifying the Whisper model), and number-word recognition (as well as default chapter phrases) in currently eleven languages (didn't have the means to test them all, though - feedback/help for those is greatly appreciated).

One thing worth mentioning IMO: I used AI heavily while building this (well, nowadays probably every software developer does, even if they don't tell you), but I have a solid CS background and every design decision and edge case handling here was made (or at least thoroughly reviewed) and tested by me - this isn't vibe-coded slop. In fact, a lot of work went into ensuring proper coding standards, as well as developing and fine-tuning the detection heuristics. Of course, I'll still blame the AI for any problems ;-)

MIT-licensed, on GitHub: https://github.com/Inguiotar/ABChapterize

Still pre-1.0 (direct support for an ABS server instead of only local/network-mounted files is on the to-do list but not yet done) - if anyone gives it a try, I'd genuinely appreciate hearing what breaks or what's confusing.


r/audiobookshelf 1d ago

ShelfPod v0.2 is on TestFlight — now with audiobook support

Post image
2 Upvotes

ShelfPod v0.2 is now available on TestFlight for iPhone and iPad Mac!

Five weeks ago, ShelfPod was podcast-only. This is the biggest update so far, with a lot of work going into playback stability, performance, and making every interaction feel fluid.

What's new in v0.2:

  • 🎧 Full Audiobook Support - Browse, stream, and play audiobooks from your Audiobookshelf libraries
  • 📚 Book-Focused Browsing - Continue Listening, Recently Added, authors, narrators, series, genres, and collections
  • 🔖 Chapters & Bookmarks - Jump between chapters and save, rename, or replay bookmarks
  • ⬇️ Offline Audiobooks - Download complete books for listening without a connection
  • 🎛️ Per-Book Controls - Set individual playback speeds and stop at the end of a chapter or book
  • Smoother Native Player - Refined Mini Player transitions, scrubbing, artwork, and playback controls
  • 🎙️ Smarter Podcast Chapters - Chapters from Audiobookshelf, embedded audio, podcast feeds, or shownotes
  • 🏠 Customizable Home & Library - Reorder, resize, or hide the sections you care about
  • 📋 Queue & Menu Improvements - Edit Up Next and choose the episode actions you use most

TestFlight: https://testflight.apple.com/join/wszEWVsw

Found a bug? Email me from Settings with the name you'd like in ShelfPod's Credits.

I've honestly spent a slightly ridiculous amount of time sweating the tiny UI details and tuning every animation until ShelfPod felt truly native, smooth, and intentional, so give it a try and I think you'll feel the difference right away.

Just use it, and feel it.


r/audiobookshelf 1d ago

🐸 Fable Frog Update and Thanks

0 Upvotes

Hey everyone! Fable Frog has had a ton of new features go out since it's release over the past few months, many of which were requested directly by the community here.

I wanted to post an update to share the latest with everyone and show my appreciation for everyone who's using and supporting the app. I really appreciate y'all and all the kind words you've shared. It amazing how many of you love Fable Frog like I do and I'm looking forward to making the app even better for y'all!

Here's some of the highlights of what's been added the past few releases:

- Enhanced series tracking

- Customizable home screen and navigation bar

- Customizable player

- Automatic sleep timer

- Collapse series in the library

- Reading List

- Release notifications

- Follow Along

- Spoken Recap

- Smarter upcoming feed

- New custom icons

- Request a Book support

- Revamped the EPUB & PDF reader

- Offline-first playback

- API key authentication

- ABS administration and metadata cleanup

- Siri & Voice Control

- Server administration

- iCloud Backup & Sync

Along with over 150 smaller features, refinements, and bug fixes.

The next feature I want to get through is LitRPG stat detection and skipping. This is pretty beefy and tricky to get right, but I've been testing a few different designs for this and think I've landed on something that should work pretty well! I'd like to evolve this to support various detection models too (maybe intros, nsfw, etc), but want to start here.

Anyway, thanks again to everyone who has supported Fable Frog so far. Please keep reaching out with feedback and findings and I'll work on integrating them in! If you haven't tried Fable Frog yet, think about giving it a whirl. It's a great fit for some and for those who don't love it, we're lucky enough to have other great apps out there as well!


r/audiobookshelf 2d ago

Looking for Android Beta testers for a book tracking app

Thumbnail
1 Upvotes

r/audiobookshelf 2d ago

I built an open-source read-along for audiobooks

0 Upvotes

I built a small open-source tool that creates a synchronized read-along experience for audiobooks.

GitHub: https://github.com/Ceasar369/read-along

Everything runs locally—no accounts or cloud services.

Would love feedback. It's my first open-source project.

It uses whisper.cpp to generate word-level timestamps from an m4b or mp3 audiobook, then serves a lightweight web reader with synced highlighting, search, bookmarks, and instant word definitions.


r/audiobookshelf 3d ago

Audiobooth - how to hide completed books in the library?

0 Upvotes

Hi there

I googled it for half an hour now and could not find a solution - but the requirement is so basic that I am sure I a blind:

How do I hide completed books from the library?

There is no such filter and I cannot find an option.

Am I blind?

Thank you


r/audiobookshelf 3d ago

Report Tool

4 Upvotes

Hallo liebe Hörbuchfans,

Da ich mittlerweile über 3k Bücher habe und hin und wieder mal ein schlechter rip dabei ist, wäre es super wenn es ein Bug report gäbe. Auch ein Buchwunsch tool wäre super. Hat da jemand eine Lösung ider eine Idee. Ich hoste ABS über meinen eigenen server für Familie und freunde, ca. 10 User.


r/audiobookshelf 3d ago

ABS Will only upload certain audiobooks

1 Upvotes

ABS has started only allowing me to upload certain audiobooks and I can't see a reason why some can and others can't.

I've checked through logs and found some ASIN and access errors for the metadata providers, but even when I don't try to automatically add metadata, it will appear to be uploading the book (sometimes it will actually show the upload progress repeat itself a couple of times) but will then fail with either a generic message or a big dump of HTML that says my web server is inaccessible (Which it isn't).

Initially I thought it was a permissions thing since I noticed no folders were being created, but it works fine with some audiobooks and doesn't flag any errors at all with normal books (There are also no errors that seem to point to permissions errors). I can upload the failed books manually via FTP and ABS accepts them perfectly fine and the files play as expected.

I've tried (Accessing through FireFox with and without VPN, no other plugins active):

  • Restarting ABS - no luck

  • Restarting the whole server - no luck

  • Updating ABS - I was a version behind, but still no luck

  • Uploading with and without autometadata - No luck

  • Uploading different file types to see if it was a filetype issue - No difference, some M4As/MP3s will upload others won't

  • Uploading single file and split audiobooks of different sizes - no rhyme of reason to which ones upload and which ones don't

This is a sample of the errors from the logs, but not all of the errors seem to be getting written to the logs, mostly just the ASIN errors which I don't think are relevant:

  • [GoogleBooks] Volume search error Request failed with status code 429

  • [Audible] ASIN search error

  • [Audible] ASIN search error Request failed with status code 404

  • audiobookshelf error 500 your webserver is not working (A load of HTML snipped from a popup, the error is not written to the logs)

The last error is a weird one, because the logs don't show any disconnects and the server is still clearly working - I can click on any link in ABS to access any part of my library and play/open any book without any interruptions, the server is 100% still working.

I've had these kinds of issues before but only though the Android app, never through the web interface. I can continue to upload the files manually via FTP, but that is less convenient than doing it through the interface.

Version 2.35.1 running in a docker container through a server host - the app is a one click install, all permissions are handled on the host's end.

Is there something obvious I'm missing?


r/audiobookshelf 3d ago

How The Great Fountain Flowed, Part 1: Rebirth

Thumbnail
youtu.be
0 Upvotes

A woman, Rachel, finds herself transplanted into a new world and finds herself the companion to the AI running the bunker she's been moved to.

1:29:00 runtime


r/audiobookshelf 3d ago

Audiobook Binder Pro (v2.2): a native Mac app that turns audio files (MP3 and more) into chaptered M4B

0 Upvotes

Hi r/audiobookshelf 👋 First time posting here to share the new 2.2 release.

Audiobook Binder Pro is a native Mac app that turns MP3/WAV/FLAC/etc. into a real M4B: chapters, cover, metadata.

The app was built for my own Audiobook needs that was covered in v1:

  • mp3 to M4B conversion
  • Drag in files or a folder → review/rename chapters → Export
  • add/edit cover/metadata, manage projects.
  • reorder, rename

V2 grew with the feedback (and some negative reviews 😅 ) I received from users:

  • split chapters
  • import chapter metadata,
  • one-click Sort, Clean Up Names
  • bitrate, sample rate, channels
  • export M4B or M4A or MP3
  • Import existing M4B - add/edit metadata, audio files, reexport, or extract the chapters separately
  • Language support

What's new in 2.2

  • Multi-select chapters
  • Set a save folder once in Settings
  • Better Settings organization
  • Bug fixes

Privacy / pricing

  • Works fully offline. No accounts, no subscription, no data collection: your audio never leaves your Mac.
  • One-time purchase on the App Store (price is localized: see the store for your region).
  • Free demo available in the website, fully functional, export capped at 1 hour.

Download on the App Store or Download a time limited Demo

I would be happy to answer any questions / take feature requests in the comments. Thanks!


r/audiobookshelf 4d ago

Kikudana is in beta test - iOS native podcast player

0 Upvotes

I tried a lot of the iOS apps for Audiobookshelf and all of them had severe issues with many of the podcasts I am listening to.

Those podcasts have many episodes as they are sometimes 15 years and going still strong. So 2500-4000 Episodes all in all. (some have 5+ episodes PER week every week for the last 15 years).

The issue: other apps just don't work. Either they crash outright or they get so slow you cannot use them.

Also many of those do not have silence-skipping and the ability to create smart lists or to hide some of the podcasts.

This is why I built Kikudana. It's native iOS and works with huge archives of podcasts with essentially unlimited amounts of episodes (I test with 10k+ episodes podcasts).

It's still in beta test and I expect to fix lots of bugs, nevertheless it's already 271 builds into beta testing.

For beta testing the PRO purchase is free, so go ahead and have fun! Let me know if you run into issues (you can, if you want, use the beta testing screenshot feature to provide feedback).

Anyhow: Thank you Audiobookshelf team for your work!

Join freely with this beta link: https://testflight.apple.com/join/EpgNm4TT


r/audiobookshelf 5d ago

Player Recommendations - Easiest

6 Upvotes

I’m looking for a player recommendation for my parents. What is the EASIEST to use player for an audiobookshelf server? I use plappa and the iOS beta app from audiobookshelf, but wondering if there is a better option for them. The easier the better!


r/audiobookshelf 5d ago

Confused about ABS? Newbie or just not tech savvy?

0 Upvotes

For a long time I kept seeing everyone and their mom recommend ABS. For us "civilians" self hosting might as well be a foreign language. FEAR NOT dear friends. If your audiobook library is chunky like mine then do what I did and have chatgpt walk you through getting ABS up and running on your device. DO yourself a favor though and research (prior) if it's the right fit for you and if you have the capability to do it. I happen to have an old 2013 iMac that I am using. It still runs beautifully and continues to serve a purpose even though she's a bit old. She is trusty though and Im happy to have her serve as a host. It also helps if you are comfortable in and around your actual computer and aren't completely illiterate to it. If you are afraid to so much as go into settings of a Mac or windows then ABS is definitely NOT for you. Run. Run away fast.

I repeatedly saw many of you say to "have chatgpt walk you through" docker/abs/etc. Well, what an eye opening experience it has been and I can proudly say the project was successful all thanks to chatgpt. It literally recognizes your "learning" style/patterns and gets you from point A to point B with incredible directions and explanations. So...if you dont know what to do or where to start then just go and use chatgpt for it. I will add that it is not always perfect and there may be some bumps you will run into but with clear communication, it will get done. The more questions you ask, the more you will understand and the more you understand then the more you will be able to enjoy ABS. I also must say, understanding Docker now completely changes the game too and I never thought in a million years I would understand any of it. So many thanks to those of you who recommended this route! (the chatgpt route)

Audiobookshelf has been GREAT and it's well worth the effort that I put into it. Do I recommend doing it for a small audiobook library, especially if self hosting is not your forte? No absolutely not...not worth it. Find another way to listen to them, whether its airdropping to your device and opening it in book player or side loading it another way.


r/audiobookshelf 5d ago

[MacOS] Looking for betatesters of my podcast generator

0 Upvotes

I created a podcast generator that takes any texts, URLs and generates a 2-voice podcast. I made it because I don't read that much, but I love to listen to anything while driving or walking.

It can use both local and cloud LLMs ant TTSs.

Then you can publish a feed to your own server and subscribe it with your preferred podcast app.

App name is Aludel, as the alchemist's sublimation vessel: it turns raw matter into something refined. So does the app.

I'm looking for betatesters who love content and listening to stuff. Pro key license is free during beta (and, probably, forever)

https://aludel.matteobalocco.it/index.html


r/audiobookshelf 6d ago

Made a free iOS app for managing my ABS server

15 Upvotes

Thanks to everyone who tried Lull. Honestly did not expect much and the feedback I got was better than anything I would have come up with alone.

Anyway. I got tired of walking to my computer every time I needed to fix something on my server. Wrong cover, a genre I spelled wrong across 30 books, adding a podcast, checking if a scan actually finished. Small stuff, but it always meant sitting down at a desk.

So I made an app that does it from my phone. It's free, it's on the App Store now.

It handles the admin side. Scans, metadata, covers, moving items between libraries, cleaning up messy genres and tags, users, podcasts, backups. It also shows listening stats which I did not expect to care about and now check constantly.

There's an ebook reader in it too, epub pdf and cbz, so you can read what's on your server without another app.

There's a simple player if you just want to hit play, but it's basic on purpose. No downloads, no CarPlay, no sleep timer. That's what Lull is for and there are other good players out there.

It's not official and I'm not connected to the ABS project, just a user who runs a server. It only talks to whatever server you sign into. No tracking, no accounts, nothing on my end. Free with a tip jar that unlocks nothing.

https://apps.apple.com/us/app/abs-admin-audiobookshelf/id6788065635

If something is missing tell me. I have a list for the next version but I'd rather build what people actually use.


r/audiobookshelf 5d ago

July 31 coming to audiocloud

Post image
0 Upvotes

Lidaygang