DoplarrChaptarr (Legacy Clojure Version)

Important

This repository contains the legacy Clojure implementation. The maintained Rust successor is DoplarrChaptarr-Rust. Existing Clojure source, releases, and images remain here for historical and rollback use. New development, issues, and security reports should use the Rust repository.

A fork of Doplarr that adds Chaptarr support. Chaptarr is a Readarr fork that manages both ebooks and audiobooks from one backend. This fork registers two new Discord slash subcommands:

• /request book (ebook)
• /request audiobook

Everything upstream Doplarr does (/request movie, /request series, Sonarr / Radarr / Overseerr backends) continues to work unchanged.

A personal fork I run on my own server. Chaptarr is still pre-1.0 and ships changes regularly, so something here may break when Chaptarr or upstream Doplarr updates. File an issue if it does. See CHANGELOG.md for what's in each tag.

What this fork adds

• Chaptarr backend on the Readarr-v1-compatible API.
• Per-format config keys for root folders, quality profiles, and metadata profiles, so requests usually skip the dropdowns.
• Cross-format requests (asking for an audiobook when you already have the ebook, or vice versa) flip the correct monitor flag and fire a fresh indexer search instead of 409-ing on duplicate IDs.
• Adding an author only monitors the specific book that was just requested. Chaptarr won't pull in the rest of the back catalogue.
• Cover images on confirmation embeds attempt public CDN sources (Hardcover, Amazon, Goodreads) with OpenLibrary-by-ISBN and Amazon-by-ASIN fallbacks, so you don't need to expose your Chaptarr instance publicly. Currently inconsistent; see Known issues.

If you're deploying this image, read docs/CHAPTARR_INTEGRATION.md for Chaptarr-side setup, environment variables, and the data-model quirks that shaped the fork. For fork-maintenance concerns (merging upstream, insertion points, invariants) see FORK_NOTES.md.

Quick start

1. Pull the image

Public multi-arch images (linux/amd64, linux/arm64) are published on every push to main:

ghcr.io/elbrielle/doplarrchaptarr:latest   # follows main
ghcr.io/elbrielle/doplarrchaptarr:v0.2.0   # pinned release

2. Configure

Like upstream Doplarr, you can use either environment variables or a config.edn file — both forms work the same way. At minimum:

DISCORD__TOKEN=<your discord bot token>
CHAPTARR__URL=http://localhost:8789
CHAPTARR__API=<your chaptarr api key from Settings → General>

…or the equivalent :discord/token, :chaptarr/url, :chaptarr/api entries in config.edn.

CHAPTARR__URL only needs to be reachable from Doplarr's container; it can stay on an internal Docker network. Cover images on Discord embeds are pulled from public CDNs rather than from Chaptarr, so you don't need to expose Chaptarr publicly. (Cover attachment itself is currently inconsistent; see Known issues.)

Chaptarr config keys

Set these to skip the root-folder and quality-profile dropdowns at request time.

Environment Variable	Config File Keyword	Type	Default	Description
CHAPTARR__EBOOK_ROOTFOLDER	:chaptarr/ebook-rootfolder	String	N/A	Default root folder for /request book. Example: /cw-book-ingest
CHAPTARR__AUDIOBOOK_ROOTFOLDER	:chaptarr/audiobook-rootfolder	String	N/A	Default root folder for /request audiobook. Example: /audiobooks/audiobooks
CHAPTARR__EBOOK_QUALITY_PROFILE	:chaptarr/ebook-quality-profile	String	N/A	Default quality profile name for ebooks
CHAPTARR__AUDIOBOOK_QUALITY_PROFILE	:chaptarr/audiobook-quality-profile	String	N/A	Default quality profile name for audiobooks
CHAPTARR__EBOOK_METADATA_PROFILE	:chaptarr/ebook-metadata-profile	String	N/A	Default metadata profile name for ebooks (Chaptarr stores ebook/audiobook metadata profiles separately, profileType 2 vs 1)
CHAPTARR__AUDIOBOOK_METADATA_PROFILE	:chaptarr/audiobook-metadata-profile	String	N/A	Default metadata profile name for audiobooks
CHAPTARR__ENABLE_BOOK	:chaptarr/enable-book	Boolean	true	Set to false to suppress /request book when only audiobook requests should route here
CHAPTARR__ENABLE_AUDIOBOOK	:chaptarr/enable-audiobook	Boolean	true	Set to false to suppress /request audiobook when only ebook requests should route here

For Discord, Sonarr, Radarr, Overseerr, and all non-Chaptarr settings, see upstream Doplarr's configuration page. All three backend families (books, movies/TV, and Overseerr) can coexist — just configure whichever you want.

3. Deploy

Docker Compose snippet:

doplarr:
  image: ghcr.io/elbrielle/doplarrchaptarr:latest
  container_name: doplarr
  env_file:
    - /srv/appdata/doplarr/.env
  restart: unless-stopped
  networks:
    - mediaserver

The container needs outbound access to Discord and HTTP access to Chaptarr. No volume mounts are required; Doplarr doesn't touch local disk.

4. Register the Discord bot

Follow upstream Doplarr's Discord setup and Permissions sections: create an application, enable bot and applications.commands scopes, and authorize it to your server. You can reuse an existing Doplarr bot; nothing about the bot registration changes in this fork.

Verify

After the container starts, check the logs for:

Configuration is valid
Discord connection successful
Connected to guild

Then in Discord:

/request book query:Dune
/request audiobook query:Dune

A result dropdown should appear. Select a result and the bot walks you through any un-defaulted options, then confirms the request. It should land in Chaptarr's queue and flow through your configured download client.

Known issues

• Cover images on confirmation embeds are unreliable. Even for popular books with clean ISBN/ASIN data, the embed sometimes shows up without a cover. The CDN-sourcing path is on the fix list; see CHANGELOG.md for what's been tried so far.

Merging upstream Doplarr releases

This fork tracks kiranshila/Doplarr as upstream:

git fetch upstream
git merge upstream/main

All modifications in this fork are purely additive insertions into a small set of upstream files, so conflicts during merge should be mechanical. FORK_NOTES.md documents each modification block and where to re-apply it if the upstream surface shifts.

Credits

• kiranshila/Doplarr provides all of Doplarr's architecture, Discord wiring, and backend patterns. This fork only adds the Chaptarr backend.
• robertlordhood/chaptarr is the book manager being integrated.

License

MIT — same as upstream. See LICENSE.