OperaLibre
A private, self-hosted audiobook server with web, iPhone, iPad, Android, and macOS apps. Point it at a folder of audiobooks and stream them with per-reader progress, chapter navigation, readalong, and optional Audible and Libro.fm imports.
OperaLibre can also run as a headless audiobook server. The included React/Vite app is the reference frontend, while the Rust server exposes an HTTP API for custom web, mobile, desktop, or native clients.
Install in one command
On macOS and Linux, this downloads the newest release for your computer, verifies its release signature and SHA-256 digest, asks a few setup questions, and starts the server:
curl -fsSL https://raw.githubusercontent.com/DonovanMontoya/OperaLibre/main/script/install.sh | sh
Windows and manual installs are covered in Install a Release.
Web, Android, iPhone, and iPad apps
Features at a glance
- Streams almost anything —
.mp3,.m4b,.m4a,.mp4,.aac,.flac,.ogg,.opus,.wav,.aiff - Real seeking — HTTP range requests, so scrubbing works on huge
.m4bfiles - Rich metadata — title/subtitle, author, narrator, publisher, dates, genres, custom ordered tags, language, description, and covers administrators can replace without changing audio
- Chapters — M4A/M4B/MP4 chapter tracks, MP3 ID3
CHAPframes, and multi-file track boundaries - Readalong — full-window reader for
.epub,.pdf,.txt,.html,.htmcompanion files, with contents and playback controls - Readalong sync — read the EPUB beside the audio, with sentence seeking and highlighting when the book has an aligned map and the follow-along experiment is enabled; the optional generator installs separately from Administration
- Multi-reader — accounts, per-reader progress, Argon2-hashed passwords
- Player controls — playback speed, 15s rewind, 30s skip, sleep timer, OS Media Session
- Web and native mobile apps — installable PWA plus Capacitor projects for Android and iPhone
- Offline listening — download books in the native apps, or import audio and a matching EPUB into an on-device library without a server
- CarPlay — browse and play your library from the car screen; downloaded books play without a network
- Desk view — stand a folded iPhone Duo on its edges like a tent with the cover screen sideways, and the playing book fills the screen in a CarPlay-style Now Playing view with large playback controls
- Third-party clients — a subset of the Audiobookshelf API for compatible clients, plus an OPDS catalog; see Client compatibility
- Optional Audible import — drive a local Libation install from the web UI
- Optional Libro.fm import — import your purchases into the server, or download them directly in the native apps
- Try the demo — bundled Alice audio, EPUB, and sentence timings work without a server, account, or network
Documentation
- Install a Release — easiest setup for Windows, macOS, and Linux
- Getting Started — choose a setup or build from source
- Configuration — every key in
server.configexplained - Library Layout — how to structure your audiobook folder
- Users & Accounts — first-run admin setup, adding readers, sessions
- Using OperaLibre — phones, reader accounts, uploads, readalong, and optional imports
- Libation / Audible Import — optional acquisition pipeline
- API Reference — HTTP endpoints exposed by the server
- Deployment — running on a home server or LAN
- Troubleshooting — common problems and fixes
- iOS Release Changelog — iPhone and iPad versions and build notes
- Update Manifest — how installations find and verify updates
- Libro.fm Import — server imports, watched folders, and device downloads
- Client compatibility — third-party client coverage and limitations
Support and feedback
Use GitHub Issues for public bug reports and feature discussions. For private support questions or beta feedback, email operalibre@agentmail.to. Security vulnerabilities should go through the private GitHub security advisory process.
Architecture
┌─────────────────────┐ ┌──────────────────────────┐
│ apps/web (Vite) │ HTTP │ apps/server (Rust/axum) │
│ React + TypeScript │ ─────▶ │ Library scan, streaming │
│ PWA, Media Session │ │ Auth, progress, covers │
└─────────────────────┘ └────────────┬─────────────┘
│
▼
┌──────────────────────────┐
│ library_root/ │
│ data/ (SQLite database) │
│ Libation CLI (optional) │
└──────────────────────────┘
The backend is a single Rust binary (apps/server). The frontend is a static React build (apps/web) that can be served by anything — Vite in dev, the Rust server in production, or any static host pointed at the API.
The server owns library scanning, authentication, metadata extraction, cover art, readalong files, progress sync, downloads, and byte-range audio streaming. A custom frontend can build its own browsing and playback experience on top of the API described in API Reference.
License
See the PolyForm Noncommercial License in the repository.