ricetim/readarr-rresurrected repository overview

⁠readarr-rresurrected

readarr-rresurrected resurrects the Readarr⁠ ebook and audiobook manager after its retirement in early 2025. The original project was abandoned when its Goodreads metadata API became unusable, leaving thousands of users with a broken application and no official path forward.

This image bundles a self-hosted metadata service (bookinfo) directly inside the container alongside Readarr. Both run under supervisord in a single Alpine image (~251 MB). No second container, no external API dependency, no configuration — it just works.

GitHub: github.com/ricetim/readarr-rresurrected⁠ — bug reports and feature requests welcome.

Documentation: health checks, settings, supported integrations and troubleshooting⁠

⁠Quick Start

docker run -d \
  --name readarr \
  -p 8787:8787 \
  -v readarr-config:/config \
  --user 1000:1000 \
  ricetim/readarr-rresurrected:latest

Open http://localhost:8787⁠

⁠Docker Compose

services:
  readarr:
    image: ricetim/readarr-rresurrected:latest
    container_name: readarr
    user: "1000:1000"
    ports:
      - "8787:8787"
    volumes:
      - readarr-config:/config
    environment:
      - GOOGLE_BOOKS_API_KEY=        # optional — improves ebook edition data
    restart: unless-stopped

volumes:
  readarr-config:

⁠What's Inside

⁠Readarr

The full Readarr application: monitors RSS feeds for new books, grabs releases, integrates with download clients (qBittorrent, SABnzbd, NZBGet, Deluge, etc.) and Calibre. Quality profiles, author monitoring, automatic upgrades — everything the original offered.

⁠bookinfo (bundled metadata service)

A Python/FastAPI service that fetches author and book data directly from Goodreads' internal API, replacing the cloud endpoint that was shut down. It:

• Returns a fast partial response immediately so searches and adds are responsive
• Paginates remaining works in the background — books stream into the UI progressively with a live progress indicator
• Optionally supplements ebook edition data via Google Books (requires API key)
• Binds to 127.0.0.1:28202 inside the container only — not exposed externally

Readarr is pre-configured to use it at localhost:28202. No setup needed.

⁠Native private-tracker indexers

Two private trackers are supported directly, so neither needs Prowlarr:

• MyAnonamouse — several bugs in the upstream implementation are fixed, making it functional out of the box. Releases carry language, and any result in the interactive search dialog can be expanded to show narrator, file count, series, category, tags and the full description.
• Bibliotik — cookie-based authentication; paste your session cookie and it works.

Quality profiles also gained an Allowed Languages setting, so automatic grabbing can be restricted to the languages you actually read.

⁠Volumes

⁠Ports

⁠Environment Variables

⁠Migrating from an Existing Installation

Compatible with data volumes from ghcr.io/faustvii/readarr and hotio/readarr. One schema migration runs automatically on first start (adds a Kca column to AuthorMetadata).

1. Stop your existing container
2. Mount the same /config volume with this image
3. Start — migration runs automatically, all history and settings are preserved

⁠Tags

Images are built for both linux/amd64 and linux/arm64 (64-bit Raspberry Pi OS, other arm64 boards and servers, Apple Silicon), and Docker pulls the right one automatically. 32-bit ARM is not built.

⁠Credits

• The Servarr Team⁠ and all Readarr contributors⁠ — built the entire application
• @blampe / rreading-glasses⁠ — proved the Goodreads scraping approach was viable; the name rresurrected is a nod to the double-r naming convention
• @faustvii⁠ — maintained the most widely used community Docker image after upstream images stopped being updated

⁠Changelog

Release notes are kept in CHANGELOG.md⁠, and the same notes appear in the app under System → Updates.

⁠Issues & Contributing

github.com/ricetim/readarr-rresurrected/issues⁠

⁠Support the project

If readarr-rresurrected is useful to you, you can support its development on Ko-fi⁠. Entirely optional: everything works the same either way.

⁠License

GNU GPL v3⁠