My Audiobook Collection
Self-hosted · one Docker container · Unraid-ready

Stop scrolling folders. Start listening.

You already own the books. This turns the folder on your server into a library you will actually enjoy: covers on the shelf, the right tags in every file, and every listener picking up exactly where they left off.

Get it running in 5 minutes See it in action

No account. No cloud. No subscription. Your files never leave your server.

Time through the book38%
The My Audiobook Collection interface with genres, authors and books in three columns
One container
amd64 and arm64
SQLite inside
Daily backup beside it
ffmpeg included
Nothing to install
No cloud
Your files stay yours

Sound familiar?

“Unknown artist. Untitled. No cover.”
Every book gets its tags written into the files, so every player, phone and car stereo shows them properly.
“That one is an .m4b, so it can never be tagged.”
Now it can: one click turns it into MP3, a chapter to a track, and keeps the original.
“Where did I stop? Whose place is this?”
Everyone gets their own place in every book, on every device, and it follows them from page to page.
What it does

Everything you wish your player did.

Writes tags into your MP3s

Not into a database only its own interface can read, but into the files, where every other player and car stereo will find it. Tags the files really carry show in green.

Converts .m4b and .ogg

One .m4b of thirty chapters becomes thirty named, numbered MP3 tracks. The originals move to a Converted folder until you say otherwise.

Plays them, remembers you

Streams in the browser and keeps the position per listener. A book keeps playing while you move between pages, and the player measures time through the book, not tracks.

Metadata

See what is missing, fix it on the spot.

A Needs tags list shows every book whose files miss a required tag. Fill the gaps from the Google Books API or by hand, then write them back. Merging leaves frames it does not set untouched.

Read about metadata →
The Needs tags list
Shelves of covers: what you were listening to and what was added last
Browse

Opens on shelves of covers.

Pick up where you left off, see what arrived last, or search by title, author, series, narrator or a few words from the description. It even says which volume of a series you are missing.

Read about browsing →
Listen

A player that follows you around.

The cover is a play button. Download a whole book in one archive. On a phone it shows one column at a time, with the player across the bottom.

See the player →
The player with a yellow line showing time through the book The app on a phone
At home

Fits the rest of your house.

Home Assistant reads the collection and carries a book on to any media player, with a sensor per listener. Music Assistant can treat it as an Audiobookshelf server, and the place syncs both ways.

Home Assistant → Music Assistant →
The collection shown in a Home Assistant dashboard
Your folders

It reads the folders you already have.

Genre → Author → Book, with an optional series, and even parts of a series. Disc folders are joined into one book. No renaming required.

How folders are read →
/audiobooks
├── Fantasy
│   ├── Brandon Sanderson
│   │   └── Mistborn              ← series
│   │       ├── The Final Empire
│   │       └── The Well of Ascension
│   └── Patrick Rothfuss
│       └── The Name of the Wind
└── Thriller
    └── Stephen King
        └── The Shining

Careful with the thing you care about.

It touches your collection, so it is built not to surprise you.

Originals kept
Converted books move to a Converted folder until you delete them yourself.
30-day trash
Deleted a book by mistake? It waits in a trash for 30 days.
Tags merge, never wipe
Frames it does not set are left alone, and empty values are never written.
Daily backup
A copy of its database sits beside it, so everyone's places survive.
Install

Running in five minutes.

The image is starf0x/my-audiobook-collection. On Unraid the template fills the whole Add Container form for you. On Proxmox, one command does it all.

  1. 1
    Copy the template in once
    From the Unraid terminal, before the container exists:
    cd /boot/config/plugins/dockerMan/templates-user/
    wget https://raw.githubusercontent.com/Starf0x/my-audiobook-collection/main/my-My-Audiobook-Collection.xml
  2. 2
    Add the container
    Docker → Add Container → pick My-Audiobook-Collection under User templates.
  3. 3
    Check the paths, then Apply
    Point Audiobooks at your share and keep Appdata on fast storage.
  4. 4
    Create the administrator
    Open http://TOWER-IP:8523, choose a name and password, add /audiobooks as a library folder and scan.
Defaults in the template
WebUI port8523
Appdata/mnt/user/appdata/… → /data
Audiobooks/mnt/user/Audiobooks → /audiobooks
User / group99 / 100 (nobody:users)
Google Books keyoptional, for metadata lookup
Proxmox LXC

Prefer Proxmox? One command.

No Docker and no image to pull. It makes a Debian container with node, ffmpeg and the app, and a service that starts at boot. Defaults: 2 cores, 1024 MB RAM, 8 GB disk.

Full Proxmox guide →
1. On the Proxmox host shell
bash -c "$(curl -fsSL https://raw.githubusercontent.com/Starf0x/my-audiobook-collection/main/ct/my-audiobook-collection.sh)"
2. Mount your audiobooks, then reboot
pct set <id> -mp0 /host/path/Audiobooks,mp=/audiobooks
pct set <id> -mp1 /host/path/Import,mp=/import
pct reboot <id>
3. Open the app
Go to http://<container-ip>:8523 and create the administrator.

Your books are already there. Give them a home.

Five minutes from now, you could be pressing play.

Install it now