Skip to main content

​
Reading Pipeline

Chaptarr + CWA replace the old Bookshelf + Boundless setup. Both run on Pentium.

​
Pipeline

Hardcover library (Want to Read, Currently Reading)
  → Chaptarr import list syncs every 15min
    → Prowlarr searches 8 indexers (1337x, BitSearch, Internet Archive, Knaben, LimeTorrents, Nyaa.si, The Pirate Bay, TorrentGalaxy)
      → qBittorrent downloads via Gluetun VPN
        → Ebooks: /media/books/{Author}/{Title}/
          → Cron job copies new ebooks to CWA ingest folder (every minute)
            → CWA auto-ingests into Calibre library
            → CWA auto-converts to epub
            → CWA enriches metadata from Hardcover
            → CWA serves OPDS catalog for KOReader
            → CWA syncs reading progress via KOSync
        → Audiobooks: /media/audiobooks/{Author}/{Title}/
          → Audiobookshelf picks them up

​
Components

ServiceReplacesPurpose
Chaptarr2x Bookshelf (Readarr)Unified ebook + audiobook acquisition
CWABoundlessCalibre library, OPDS, KOSync, metadata
Audiobookshelf(unchanged)Audiobook streaming

​
Chaptarr → CWA Ingest

Chaptarr’s built-in CustomScript notification doesn’t fire on import (bug). Instead, a host cron job (~/apps/downloads/cwa-ingest-cron.sh) runs every minute, finds new ebook files in /media/books, and copies them to CWA’s ingest folder. Logs to ~/apps/downloads/cwa-ingest-cron.log.

​
CWA Features Enabled

  • OPDS — calibre.augustin.ai/opds (authenticated)
  • KOReader sync — reading progress across devices
  • Kobo sync — KOReader Kobo protocol
  • Hardcover sync — metadata enrichment from Hardcover API
  • Hardcover auto-fetch — periodic metadata pulls
  • Auto-convert — target format: epub
  • Kindle EPUB fixer — fixes common epub issues
  • Duplicate auto-resolution — strategy: keep newest

​
Chaptarr Notes

  • Metadata server: api2.chaptarr.com (set in Settings → Development; api.chaptarr.com has SSL issues)
  • Runs inside gluetun network namespace (shares localhost with qBit/Prowlarr)
  • Hardcover JWT token shared with CWA for metadata

​
KOReader → Hardcover Progress Sync

The hardcoverapp.koplugin KOReader plugin syncs reading progress, status, ratings, and highlights to Hardcover. With a jailbroken Kindle running KOReader + this plugin, Hardcover becomes the single source of truth for both acquisition and reading progress.