kikootwo/ReadMeABook

What is it?

Key features

• 01Searches Prowlarr indexers and ranks torrent and Usenet releases by title, author, format and seeders.
• 02Sends downloads to qBittorrent, Transmission, Deluge, SABnzbd or NZBGet.
• 03Imports finished books into Plex or Audiobookshelf folders with title, author and narrator tags.
• 04Watches series and authors and requests new releases automatically.
• 05Supports Plex, OIDC and local accounts, with approval and permission controls.

Use cases

• Running a household or small group audiobook library that friends can request from.
• Automating audiobook acquisition for an existing Plex or Audiobookshelf server.
• Syncing audiobook requests from Goodreads or Hardcover reading lists.

Quick start

1. 1

   Create a project folder

   mkdir readmeabook && cd readmeabook
2. 2

   Download the docker-compose.yml file

   curl -fsSL https://raw.githubusercontent.com/kikootwo/ReadMeABook/main/docker-compose.yml -o docker-compose.yml
3. 3

   Set your volume paths and PUID/PGID in docker-compose.yml, then start the container

   docker compose up -d
4. 4

   Open http://<your-server>:3030 and follow the setup wizard

Things to know

• !Requires Docker, Prowlarr, and a Plex or Audiobookshelf server, so setup has several moving parts.
• !Needs correct volume paths so the download client and RMAB see the same container paths.
• !Some features need optional paid AI API keys (BookDate) or external services.

In collections

Topics

FAQ

What is ReadMeABook?

Self-hosted audiobook request manager that searches indexers, downloads releases and imports them into Plex or Audiobookshelf. ReadMeABook (RMAB) is a self-hosted request manager and downloader for audiobooks. Users browse an Audible-backed catalog and request titles. RMAB searches your Prowlarr indexers, sends the best torrent or Usenet release to your download client, and copies finished files into a Plex or Audiobookshelf library with organized folders and tags. It then marks the request available.

Is ReadMeABook free to use? What license does it have?

ReadMeABook is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.

Is ReadMeABook still maintained?

Actively maintained. The last commit to ReadMeABook was on Nov 3, 2026.

What can I use ReadMeABook for?

Running a household or small group audiobook library that friends can request from. Automating audiobook acquisition for an existing Plex or Audiobookshelf server. Syncing audiobook requests from Goodreads or Hardcover reading lists.

How do I install ReadMeABook?

Create a project folder: mkdir readmeabook && cd readmeabook Download the docker-compose.yml file: curl -fsSL https://raw.githubusercontent.com/kikootwo/ReadMeABook/main/docker-compose.yml -o docker-compose.yml Set your volume paths and PUID/PGID in docker-compose.yml, then start the container: docker compose up -d Open http://<your-server>:3030 and follow the setup wizard

Where can I get ReadMeABook?

The source code and installation instructions are on GitHub: https://github.com/kikootwo/ReadMeABook