AudioBookRequest

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.

Workflow

Admin creates user accounts for their friends. Each account's group is one of: Admin, Trusted, and Untrusted. All groups can request/remove book requests.
When a Trusted and above requests a book, it'll automatically start downloading. This requires the download client to be set up correctly in Prowlarr and the "Auto Download" option to be on in the settings.
If configured, a notification will be sent to Apprise.
The requests/wishlist page shows a list of all books that have been requested. An admin can directly view the torrent sources gotten from Prowlarr and start downloading requests or reject them.

Docker

Using Docker, this website can be run with minimal setup:

services:
  web:
    image: markbeep/audiobookrequest
    ports:
      - "8000:8765"
    environment:
      - SERVER_PORT: 8765 # default: 8000
    volumes:
      - ./data:/app/data

Inward port is :8000 and the database (used for config and caching) is located at /app/data.

Local Development

Pull requests are always welcome. Do note though, that because this project is in its very early stages a lot might change.

AudioBookRequest depends on Prowlarr. Prowlarr handles the part of managing all indexers and download clients. AudioBookRequest is solely responsible for creating wishlists/request pages and starting downloads automatically if possible.

Installation

python -m venv .venv
.venv/activate
pip install -r requirements.txt

Initialize DB

alembic upgrade heads

Running

Running the application is best done in multiple terminals:

Start FastAPI dev mode:

fastapi dev

Install daisyUI and start Tailwindcss watcher:

npm i
tailwindcss -i styles/globals.css -o static/globals.css --watch --m

Start browser-sync. This hot reloads the website when the html template files are modified:

browser-sync http://localhost:8000 --files templates/** --files app/**

NOTE: Website has to be visited at http://localhost:3000 instead.

2.3 KiB Raw Blame History