Open-Source DevOps · advplyr

audiobookshelf

Audiobookshelf is a self-hosted server for managing and streaming audiobooks and podcasts with multi-user support, metadata fetching, and mobile apps. It runs on Node.js and supports bulk uploads, auto-detection of library updates, and synchronized progress tracking across devices.

Talk to DEV.co Discuss Implementation

Source: GitHub — github.com/advplyr/audiobookshelf

13.4k

GitHub stars

Forks

JavaScript

Primary language

GPL-3.0

License (OSI-approved)

Key facts

Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.

Field	Value
Repository	advplyr/audiobookshelf
Owner	advplyr
Primary language	JavaScript
License	GPL-3.0 — OSI-approved
Stars	13.4k
Forks	1k
Open issues	1.1k
Latest release	v2.35.1 (2026-05-28)
Last updated	2026-06-29
Source	https://github.com/advplyr/audiobookshelf

What audiobookshelf is

JavaScript/Node.js application providing a RESTful API with WebSocket support for real-time client synchronization, FFmpeg-based audio transcoding on-the-fly, and a Nuxt-based progressive web app frontend. Includes Android and iOS client applications and supports RSS feed generation for podcast/audiobook distribution.

Quickstart

Get the audiobookshelf source

Clone the repository and explore it locally.

terminalbash

1git clone https://github.com/advplyr/audiobookshelf.git2cd audiobookshelf3# follow the project's README for install & configuration

Need it deployed, integrated, or customized instead? DEV.co ships production installs.

Best use cases

Personal Audiobook & Podcast Library

Self-host your entire audiobook and podcast collection with synchronized playback progress across desktop, mobile, and web clients without relying on commercial streaming services.

Small Team or Family Media Server

Deploy as a multi-user server for household or small organizational sharing with granular permission controls, individual progress tracking, and support for concurrent user streams.

Content Distribution with Open Standards

Generate open RSS feeds for audiobooks and podcasts, enabling integration with standard RSS readers and podcast clients while maintaining full metadata control.

Implementation considerations

WebSocket support is mandatory; verify reverse proxy (nginx, Traefik, HAProxy) is correctly configured to pass WebSocket connections with proper upgrade headers and is not limited to `/` path (subfolder must be `/audiobookshelf`).
FFmpeg must be installed and accessible on the deployment host for on-the-fly audio format streaming; validate codec support matches your media library's formats.
Directory structure and folder naming conventions are strictly parsed by the library scanner; review official documentation for supported structures before bulk import to avoid indexing failures.
Multi-user permissions are configurable but granularity is limited by application design; evaluate built-in permission model against your access control requirements.
Automated daily backups are available; configure external backup storage strategy (S3, NFS, local redundant storage) to prevent data loss on host failure.

When to avoid it — and what to weigh

Requiring Commercial Streaming Guarantees — This is self-hosted open-source software; there are no SLA, uptime guarantees, or commercial support contracts available. Maintenance depends on community contributions.
Large-Scale Multi-Tenant SaaS Deployment — Architecture is designed for self-hosted private servers, not cloud-native multi-tenant scaling or high-availability distributed deployments without significant architectural modification.
Zero DevOps/System Administration Capacity — Requires Docker, Node.js, FFmpeg installation and management, reverse proxy configuration (with WebSocket support), and ongoing server administration; not a managed service.
DRM-Protected Media Handling — Designed for unprotected audio files; no native DRM support for commercially restricted audiobook formats (e.g., Audible, protected streams).

License & commercial use

GPL-3.0 (GNU General Public License v3.0). Copyleft license requiring all derivative works and modifications to remain open-source and redistributable under GPL-3.0.

GPL-3.0 is copyleft and imposes strict terms on commercial use. If you modify the code or distribute it, you must provide source code and license modifications under GPL-3.0. Using unmodified Audiobookshelf for internal non-commercial purposes (e.g., personal media server) carries no license obligations. Any commercial deployment, SaaS offering, or redistribution requires legal review to ensure compliance. Consult an IP attorney before commercial use.

DEV.co evaluation signals

Editorial assessment — not user reviews. Directional, with an explicit confidence level.

Signal	Assessment
Maintenance	Active
Documentation	Adequate
License clarity	Clear
Deployment complexity	Moderate
DEV.co fit	Good
Assessment confidence	High

Security considerations

Self-hosted software where operator is responsible for deployment security. No encryption-at-rest is documented; WebSocket and HTTP should be deployed over TLS to protect media streams and user sessions. Multi-user permission system is present but scope is unknown; review permission enforcement code for authorization bypass risks. No security audit reports or vulnerability disclosure process is documented. Self-hosted nature means you control attack surface, but patch management is your responsibility.

Alternatives to consider

Jellyfin

General-purpose media server (music, video, ebooks) with similar self-hosted, GPL-licensed model. Broader media format support but less specialized for audiobooks/podcasts.

Plex

Commercial managed media server with stronger support and SLA. Easier deployment but requires Plex account, proprietary, and less privacy-focused than self-hosted open-source.

Podman + Standard Podcast Apps

Lightweight container approach combined with standard podcast client infrastructure. Less integrated UX but maximal flexibility and lower resource footprint for podcast-only use cases.

Software development agency

Build on audiobookshelf with DEV.co software developers

Audiobookshelf provides a solid foundation for personal and small-team audiobook/podcast management. Evaluate deployment requirements, licensing obligations, and support model against your needs. Consult legal review for any commercial use.

Talk to DEV.co

Related open-source tools

Surfaced by semantic similarity across the DEV.co open-source index.

openbooks epub2tts grimmory

Related on DEV.co

Explore the category and the services that help you build with it.

Open-Source DevOps Web App Development API Development Cloud Deployment Talk to DEV.co

audiobookshelf FAQ

Can I use Audiobookshelf commercially or resell it?

Requires legal review. GPL-3.0 permits internal non-commercial use of unmodified software. Any modification, SaaS offering, or redistribution must provide source code under GPL-3.0. Consult an IP attorney.

What audio formats are supported?

Depends on FFmpeg codecs installed on your host. Common formats (MP3, M4B, FLAC, OGG, WAV) are typically supported via on-the-fly streaming. Verify FFmpeg codec support before large-scale import.

Is there a managed/cloud hosting option?

No official managed service. You must self-host. Third-party providers may offer hosting, but support/reliability is not guaranteed and is outside the project's scope.

How do I back up my library and metadata?

Automated daily backups are available. Configure external storage (S3, NFS, mounted volumes) to persist backups off-host. Consult deployment docs for backup configuration details.

Custom software development services

Need help beyond evaluating audiobookshelf? DEV.co is a software development agency offering software development services and web development for teams of every size. Our software developers and web developers build custom software, web applications, APIs, and open-source devops integrations — and maintain them long-term.

Ready to Self-Host Your Audiobook Library?

Talk to DEV.co Schedule a Consultation