Help → Audiobooks → Upload audiobooks

Upload audiobooks

Upload M4B or MP3 audiobook files and Terrarium organizes them for Audiobookshelf automatically.

Audiobookshelf expects audiobooks organized into Author/Title/ folders. You don't need to do this yourself — Terrarium handles it.

How to upload

  1. Go to your Terrarium dashboard and click the Files tab
  2. Under My Audiobooks, drag your audiobook files onto the drop zone
  3. Wait for the upload to finish
  4. You'll see "Organizing files..." while the organizer runs

The organizer reads each file's metadata (author, title) using ffprobe and moves it into the right folder structure. If the file doesn't have metadata tags, it falls back to parsing the filename.

Once organized, open Audiobookshelf and your books will appear. You may need to trigger a library scan from Audiobookshelf's settings if it doesn't pick them up immediately.

Supported formats

Audiobookshelf plays M4B (the standard audiobook format), MP3, M4A, and most other audio formats. M4B files are ideal because they contain chapter markers.

File size

Audiobooks are large — a single book is typically 200 MB to 1 GB. Your Audiobookshelf instance has 10 GB of disk space. Keep an eye on usage in the Files tab.

Listening on your phone

Audiobookshelf has official mobile apps:

In the app, add your server: https://{your-username}-audiobookshelf.getterrarium.app. Use the credentials you created when you first opened Audiobookshelf.

Your listening progress, bookmarks, and playback speed sync across all devices.