App Guides

Audiobookshelf on a Seedbox: Self-Hosted Audiobooks & Podcasts

Audiobookshelf is the self-hosted audiobook and podcast server people pick when they're done with Audible. Here's how it runs on a Bytesized seedbox and what to know going in.

What Audiobookshelf Is

Audiobookshelf is a self-hosted server for audiobooks and podcasts. It scans a folder of audio files, organises them by author and series, tracks your progress per device, and ships native mobile apps for iOS and Android. There's a web player too if you'd rather listen at your desk.

It's the answer most people land on after deciding they're done renting from Audible.

Why Run It on a Seedbox?

Audiobookshelf needs three things to be useful: a stable always-on server, decent upload bandwidth so the apps don't stutter, and enough storage to hold a real library. A home machine works for one or two of those, rarely all three.

A Bytesized seedbox handles all of it:

Installing Audiobookshelf

Open the Bytesized Panel, find Audiobookshelf in the app catalog, click install. The panel handles the binary, picks a port, sets up the reverse proxy, and gives you a clean HTTPS URL.

Click "Open" next to it once installed. You're taken to the first-run setup.

First-Run Setup

  1. Create the admin account. Username and password.
  2. Add a library. Audiobookshelf supports two library types: Books and Podcasts. Standard layout on a Bytesized slice is ~/files/audiobooks and ~/files/podcasts.
  3. Set the library scan schedule. Default is on file change, which is what you want.

Audiobookshelf scans and pulls metadata from Audible (covers, descriptions, narrator names) and Google Books. The first scan on a big library takes a while; the app stays usable while it runs.

Folder Layout That Works

Audiobookshelf is fussy about folder structure. The simplest layout it likes:

audiobooks/
  Author Name/
    Series Name/
      01 - First Book/
        chapter01.mp3
        chapter02.mp3
        cover.jpg

For standalone books (no series), you can drop the series folder. Single-file audiobooks work too; just put the .mp3 or .m4b directly under the book folder.

If you're importing from a messy library, run a rename pass with FileBot or similar before you point Audiobookshelf at it. Saves a lot of metadata-fixing later.

Mobile Apps

The official iOS and Android apps are the main reason to use Audiobookshelf. Sign in with the URL the panel gave you, pick a book, and it streams or downloads for offline listening. Sleep timer, variable speed, chapter skipping, all there.

The mobile apps are free and open source. No premium tier, no ads.

Podcast Downloader

Audiobookshelf has a built-in podcast downloader. Add a feed URL, set how many episodes to keep, and it pulls new ones automatically. The episodes show up in the same library, sync across devices, and play through the same apps as your audiobooks.

If you've been using Pocket Casts or Overcast and miss the cross-device sync, this is a clean replacement.

Common Gotchas

Library scan finds nothing. Almost always folder structure. Audiobookshelf won't pick up a flat folder of .mp3 files; you need at least one author folder layer.

Metadata wrong. Audiobookshelf pulls from Audible by default. If a book is missing or the wrong cover is showing, hit "Match" on the book and pick the right entry from the search results.

Mobile app can't connect. Almost always the URL. Use the full HTTPS URL from your panel, not a local IP. The panel's URL is reachable from anywhere.

Audible-bought files won't play. They're DRM'd. You'll need to convert them with a tool that strips the DRM before Audiobookshelf can read them; this is unrelated to the seedbox itself.

FAQ

Is Audiobookshelf free? Yes. Server, web player, iOS app, Android app. All free, all open source.

Does it support podcasts as well as audiobooks? Yes, both. Separate library types so they don't get mixed up.

Can multiple people use the same instance? Yes. Create a user per person; everyone's progress tracks independently.

Will it convert my Audible books? No. Audible files are DRM'd. You strip the DRM separately, then point Audiobookshelf at the resulting files.

Does it work with Plex or Jellyfin? It's a separate stack. Both Plex and Jellyfin handle audiobooks badly enough that Audiobookshelf is the right answer for most people.

Ready to Set It Up?

Browse Appbox plans, pick one with enough storage for your library, and install Audiobookshelf in the panel.

15+ years of seedbox hosting 5.0/5 Trustpilot (248 reviews) 61+ one-click apps

Ready to Get Started?

Set up your own media server in under two minutes.