rreading-glasses

rreading-glasses

Docker app from pureelectricity's Repository

Overview

rreading-glasses is a drop-in replacement for the official metadata provider that delivers lightning-fast, high-coverage book and author data to your Arr-based library clients (e.g. Readarr, Calibre).

  • Speeds up searches and imports by caching metadata in memory and Postgres
  • Supports very large authors and upcoming releases not found in the official service
  • Provides full Goodreads compatibility or can proxy the open-source Hardcover API

Requirements

Postgres
Either:
– A valid Goodreads session cookie (to avoid 1 RPS throttling on Goodreads queries)
– OR a Hardcover API Bearer token (for Hardcover upstream)

Runtime arguments

Network
bridge
Shell
sh
Privileged
false
Extra Params
--entrypoint /main

Template configuration

PortPorttcp
Target
8788
Default
8788
Value
8788
PostgreSQL HostVariable

The hostname or IP address of your Postgres server.

Target
POSTGRES_HOST
PostgreSQL UserVariable

The username to connect to Postgres.

Target
POSTGRES_USER
PostgreSQL PasswordVariable

The password for the Postgres user.

Target
POSTGRES_PASSWORD
PostgreSQL DatabaseVariable

The database name to use.

Target
POSTGRES_DATABASE
Default
rreading-glasses
PostgreSQL PortVariable

Postgres port.

Target
POSTGRES_PORT
Default
5432
Value
5432
CookieVariable

Cookie used for upstream HTTP requests.

Target
COOKIE
UpstreamVariable

The upstream host (e.g. www.example.com).

Target
UPSTREAM
Default
www.goodreads.com
Value
www.goodreads.com
HardcoverAuthVariable

Hardcover Authorization header, e.g. 'Bearer ...'

Target
HARDCOVER_AUTH
PortVariable
Target
PORT
Default
8788
Value
8788
RPMVariable

Maximum upstream requests per minute.

Default
60
Value
60
ProxyVariable

HTTP proxy URL for upstream requests. (Leave empty if not used)

Target
PROXY

Download Statistics

290,881
Total Downloads
30,475
This Month
37,193
Avg / Month

Total Downloads Over Time

Loading chart...

Details

Repository
blampe/rreading-glasses:latest
Last Updated2026-04-25
First Seen2025-05-05

Run rreading-glasses on Unraid.

rreading-glasses is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.