ReadMeABook
AGPL-3.0
- Platform
- Web Docker Self-hosted
- Licence
- AGPL-3.0 Open source
ReadMeABook (RMAB) is a self-hosted request manager and download pipeline for audiobooks – the audiobook answer to the Radarr/Sonarr plus Overseerr pairing. Your users browse an Audible-backed catalogue and request what they want, and the server does the rest: it searches your Prowlarr indexers, sends the best release to your torrent or Usenet client, copies the finished files into your Plex or Audiobookshelf library with clean folders and tags, and flips the request to available once the library actually holds the book. It ships as a single Docker image with its own PostgreSQL and Redis.
Finding and requesting
- A real home page – Popular, New Releases and Audible category rows, each user adding, removing and reordering their own sections, plus search by title or author and dedicated author and series pages.
- One-click requests – books you already own show “In Your Library”, so nothing gets requested twice.
- Watches – follow a series or an author and new releases are requested for you, checked daily.
- Reading lists – link a Goodreads shelf (RSS feed) or a Hardcover list and its books are requested automatically, synced every six hours; mark any title as ignored to keep lists and watches from grabbing it.
- BookDate – a swipe-through of personal picks built from your library and rating history, connected to OpenAI, Claude, Gemini or any OpenAI-compatible endpoint.
- Issue reports – users can flag a book in the library, and an admin can dismiss it or replace the files with another release.
Downloads and library hygiene
- Ranked searching – every Prowlarr indexer you enable, torrent and Usenet, scored on title and author match, format and seeders, with per-indexer priority and flag rules, plus an interactive search mode for picking a release yourself.
- Patience built in – failed searches retry daily, indexer RSS feeds are checked every 15 minutes, and unreleased books wait for their release date.
- Release blocklist – a release that fails to download, or still fails to import after retries, is blocked for that request instead of retried forever, with a review page at
/admin/blocklist.
- Clean imports – a folder template (default
{author}/{title} {asin}), title, author and narrator tags written into the files, .mp4 and single-file .m4a renamed to .m4b so Plex picks them up, and optional chapter merging of multi-file books into one chaptered .m4b that is checked against the source audio first. Existing library files are never overwritten, and downloads are only cleaned up after the library copy is verified.
- Ebooks too – an ebook can follow the audiobook from Anna’s Archive (optionally through FlareSolverr) or from your indexers’ ebook categories, in EPUB, PDF, MOBI or AZW3, with an optional Kindle fix.
- Seeding rules per indexer – finished torrents are removed from the client once your seeding time and ratio are met.
Users, approvals and automation
- Plex mode – users sign in with their own Plex account (only accounts with access to your server), and Plex Home profiles count as separate users.
- Audiobookshelf mode – OIDC sign-in (Authentik, Keycloak and friends) open to everyone, limited to a group or an allow list, or gated on admin approval, with admin rights taken from a group claim, plus local accounts that can self-register.
- Approval flow – a global auto-approve switch with per-user overrides, and separate permissions for interactive search and direct file download.
- Admin dashboard – request and download counts, live download progress, requests awaiting approval and a searchable list of every request; scheduled jobs can be run now, rescheduled or switched off, and the system log is filterable.
- Notifications – Apprise, Discord, ntfy and Pushover for requests pending approval, approved, grabbed, available, failed and reported issues.
- API tokens – personal
rmab_ tokens let scripts search, create and check requests, with interactive documentation at /api-docs.
What you need to run it
Docker on amd64 or arm64, a Plex Media Server or an Audiobookshelf instance with an audiobook library, a Prowlarr install, and a download client such as qBittorrent, Transmission, Deluge, SABnzbd or NZBGet. Your download client and RMAB must see finished downloads at the same container path. Audible regions cover the US, Canada, the UK, Australia, India, Germany, Spain, France and Italy, and search and matching work best in the English-language stores.
Licence
Free and open source – AGPL-3.0. Written in TypeScript on Next.js by kikootwo; the source lives at github.com/kikootwo/ReadMeABook.
Alternatives
- AudioBookRequest – a lighter wishlist and approval front end for Plex, Audiobookshelf or Jellyfin that hands approved requests to Prowlarr rather than running the whole download pipeline.
- Ombi – a general media request portal for movies, TV and music that treats books as a secondary case.
Views: 3