Your tool for handling audiobook requests on a Plex/Audiobookshelf/Jellyfin instance.

If you've heard of Overseer, Ombi, or Jellyseer; this is in the similar vein, but for audiobooks.

Table of Contents

• Motivation
  • Features
  • Out of Scope Features
• Getting Started
  • Quick Start
  • Basic Usage
    • Auto download
    • Audiobookshelf Integration
    • OpenID Connect
      • Getting locked out
    • Environment Variables
• Contributing
  • Conventional Commits
  • Local Development
• Tools

Motivation

AudioBookRequest aims to be a simple and lightweight tool for managing audiobook requests for your media server. It should be easy to set up and use, while integrating nicely with other common tools in the *arr stack. AudioBookRequest serves as as the frontend for you and your friends to easily make audiobook wishlists or create requests in an organized fashion.

It is not intended as a full replacement for Readarr/Chaptarr, but instead intended to be used alongside them.

Features

• Employs the Audible API to make it easy to search for and request audiobooks.
• Add manual audiobook requests for any books not available on Audible.
• Easy user management. Only three assignable groups, made to get out of your way.
• Automatic downloading of requests. Integrate Prowlarr to use all your existing indexer settings and download clients.
• Send notifications to your favorite notification service (apprise, gotify, discord, ntfy, etc.).
• Single image deployment. You can deploy and create your first requests in under 5 minutes.
• SQLite and Postgres support!
• Lightweight website. No bulky javascript files, allowing you to use the website even on low bandwidth.
• Mobile friendly. Search for books for accept requests on the go!

Out of Scope Features

• AudioBookRequest does not handle moving, renaming, nor editing metadata after downloads. Instead, ABR supports multiple REST API endpoints that allow for easy interoptability with scripts and other apps.
  • Combinations:
    • Know of or have an app or script that works with ABR? Open an issue and I'll add it here or to the docs.
  • Alternatives:
    • Listenarr: A more all-in-one approach with built-in file organization.
    • I'd love to add more alternatives for ABR here. If you know of any good ones, open an issue!

---

Getting Started

AudioBookRequest is intended to be deployed using Docker or Kubernetes. For "bare-metal" deployments, read up on local development in the wiki.

Quick Start

Run the image directly:

docker run -p 8000:8000 -v $(pwd)/config:/config markbeep/audiobookrequest:1

Then head to http://localhost:8000.

NOTE: AudioBookRequest uses the /config directory inside the container for storing configs and data. Mount that directory locally somewhere to ensure persistent data across restarts.

Basic Usage

1. Logging in the first time the login-type and root admin user has to be configured.
2. Head to Settings>Users to create accounts for your friends.
3. Any user can search for books and request them by clicking the + button.
4. The admin can head to the wishlist to see all the books that have been requested.

Auto download

Auto-downloading enables requests by Trusted and Admin users to directly start downloading once requested.

1. Ensure your Prowlarr instance is correctly set up with any indexers and download clients you want. More info.
2. On Prowlarr, head to Settings>General and copy the API Key.
3. On AudioBookRequest, head to Settings>Prowlarr and enter the API key as well as the base URL of your Prowlarr instance, i.e. https://prowlarr.example.com.
4. Head to Settings>Download to configure the automatic download settings:
   1. Enable Auto Download at the top.
   2. The remaining heuristics determine the ranking of any sources retrieved from Prowlarr.
   3. Indexer flags allow you to add priorities to certain sources like freeleeches.

Audiobookshelf Integration

Audiobookshelf (ABS) integration lets ABR:

• Check if a book already exists in your ABS library and mark it as downloaded in search results to avoid duplicate requests.
• Trigger a library scan in ABS when a request is marked as downloaded in ABR (manual or automatic), so the new item appears quickly.

Setup steps:

1. In ABS, create an API token for an account with access to your audiobook library (Admin recommended).
2. In ABR, go to Settings > Audiobookshelf and enter:

• Base URL of your ABS server (e.g. https://abs.example.com or http://localhost:13378)
• API Token from step 1
• Select the target Library
• Enable “Use ABS to mark existing books as downloaded” if you want ABR to flag existing titles during search.

Notes:

• ABR searches ABS by ASIN and by “title + first author” to detect existing books; this is a best-effort match and may not catch every case depending on your metadata.
• ABS is automatically asked to scan after successful downloads are marked in ABR. ABS typically auto-detects updates, but this helps pick up changes sooner.

OpenID Connect

Head to the OpenID Connect page in the wiki to learn how to set up OIDC authentication with your favorite auth provider.

Environment Variables

Head to the environment variables page in the wiki.

---

Contributing

Please read the contribution guidelines before contributing.

Conventional Commits

This project uses Conventional Commits to allow for a more organized commit history and support automated changelog generation. Pull requests will be squashed in most cases (with some exceptions).

Local Development

Head to the local development page in the wiki.

Tools

AudioBookRequest builds on top of a some other great open-source tools. A big thanks goes out to these developers.

• Prowlarr - Does a lot of the heavy lifting concerning searching through indexers and forwarding download requests to download clients. Saves me the ordeal of having to reimplement everything again.
• External Audible API - Audible exposes key API endpoints which are used to, for example, search for books.