
Audiobookshelf
Self-hosted audiobook and podcast server with progress tracking and mobile sync.
Why consider Audiobookshelf?
Audiobookshelf is an open-source media server for managing audiobooks and podcasts. It features chapter support, multi-device playback synchronization, and native mobile apps.
Learn Audiobookshelf by building
Practical setup notes, real use cases, and copy-ready examples in one focused guide.
In this guide10 sections
What is Audiobookshelf?
Audiobookshelf is an open-source, self-hosted audiobook and podcast streaming server built with Node.js and Svelte. It serves as a dedicated alternative to commercial audio platforms like Audible, Apple Books, and Pocket Casts.
Audiobookshelf automatically organizes audio files into structured author and series collections, parses embedded chapter markers (M4B, MP3), fetches rich metadata from OpenLibrary and Google Books, and synchronizes listening progress in real time across mobile and desktop clients.
Who Is It For?
- Avid Audiobook Listeners: Managing large libraries of DRM-free audiobooks with chapter navigation, sleep timers, and custom playback speeds.
- Podcast Enthusiasts: Subscribing to public RSS podcasts with automatic episode downloading and listening progress tracking.
- Families & Multi-User Households: Creating distinct user accounts with private listening histories, bookmarks, and custom permissions.
Key Features
- Real-time listening progress synchronization across web browser and native iOS and Android client applications.
- Full chapter support with visual timeline scrubbing, bookmarking, and custom note taking.
- Automated metadata and cover art scraping from Audible, OpenLibrary, iTunes, and Google Books.
- Integrated RSS podcast manager with automatic new-episode downloading and custom feed generation.
- Built-in multi-file audio player with custom playback speeds (0.5x to 3.0x) and automatic sleep timer.
Deploying Audiobookshelf with Docker Compose
version: '3.7'services: audiobookshelf: image: ghcr.io/advplyr/audiobookshelf:latest container_name: audiobookshelf restart: unless-stopped environment: - AUDIOBOOKSHELF_UID=1000 - AUDIOBOOKSHELF_GID=1000 - TZ=UTC ports: - 13378:80 volumes: - /media/audiobooks:/audiobooks - /media/podcasts:/podcasts - ./config:/config - ./metadata:/metadataStart the container:
docker compose up -dNavigate to http://localhost:13378 in your browser to configure your initial administrator account and add your audiobook and podcast directories.
Practical Use Cases
1. Seamless Multi-Device Listening
A listener starts an audiobook in the car on the Android app, pauses upon arriving home, and resumes playback from the exact same second on the living room desktop web browser.
2. Auto-Downloading Podcast Feeds
A user subscribes to technical podcasts inside Audiobookshelf; the server downloads new episodes overnight, making them instantly streamable to mobile devices without consuming mobile data.
3. DRM-Free M4B Library Management
A collector organizes multi-part audio files into single structured M4B container files with embedded cover art and chapter titles fetched automatically by Audiobookshelf scanners.
Troubleshooting and Limitations
- Folder Structure Requirement: Audiobookshelf organizes libraries best when following the
Audiobooks/Author/Book Title/...folder hierarchy. - Transcoding Multi-File Audiobooks: When playing multi-file MP3 audiobooks on mobile, Audiobookshelf can stream files consecutively or transcode into a virtual track; ensure the server has basic CPU capacity for audio transcoding.
Official Resources
- Official Website: https://www.audiobookshelf.org
- GitHub Repository: https://github.com/advplyr/audiobookshelf
- Documentation: https://www.audiobookshelf.org/docs
Related tools
More options with a similar category or technology profile.
MyPaint
Nimble, distraction-free, and easy graphic application for digital painters.
Pencil2D
Easy, intuitive traditional hand-drawn 2D animation software across raster and vector.
Hydrogen
Advanced open-source drum machine and pattern-based step sequencer for audio production.
Pure Data
Open source visual programming language for multimedia, audio, and physical computing.