RADAR LIVE: 142 USEFUL DISCOVERIES • ⚡ SHORT DEMO WALKTHROUGHS PUBLISHED DAILY • ✳ APPS, AI TOOLS & OPEN-SOURCE FINDS • 🔄 SANE ALTERNATIVES TO EXPENSIVE SUBSCRIPTIONS • FOLLOW @THESTACKRADAR ON YOUTUBE & INSTAGRAM • RADAR LIVE: 142 USEFUL DISCOVERIES • ⚡ SHORT DEMO WALKTHROUGHS PUBLISHED DAILY • ✳ APPS, AI TOOLS & OPEN-SOURCE FINDS • 🔄 SANE ALTERNATIVES TO EXPENSIVE SUBSCRIPTIONS • FOLLOW @THESTACKRADAR ON YOUTUBE & INSTAGRAM

snapetech-org/seerrng

seerrng

Seerr fork adding Music, eBooks, Audiobooks, Comics, Magazines, Roms, Games, & Software to existing Music & TV Requests and approval management.

RECORDED STARS107
RECORDED FORKS14

THE USEFUL PART

What seerrng does.

Seerr fork adding Music, eBooks, Audiobooks, Comics, Magazines, Roms, Games, & Software to existing Music & TV Requests and approval management.

audiobooksbookscomicsdockerebooksemulationgamesjellyfinlidarrmoviemusicoverseerrplexradarrreadarrromsseerrrsonarrtv
Language
TypeScript
Source license
MIT
Project website
Open website
Repository updated
2026-11-19
Content checked
2026-11-19

THE STACKRADAR WALKTHROUGH

Three useful things to know.

A short introduction from our reel. See the project README for the current details.

01

One repo, many media types

This repo lets you add music, eBooks, audiobooks, comics, magazines, ROMs, games, and software to the same request list you already use for movies and TV.

02

Family‑safe approval workflow

New reason: parental controls integrated with major media servers.

03

Mobile companion for on‑the‑go requests

A companion Android app connects to your self‐hosted server, so you can browse, request, and see watch‐state aware library views right from your phone.

GITHUB SNAPSHOT

The project in numbers.

Recorded counts, not a growth rate or a quality score.

OBSERVED STAR HISTORY

Follow the signal over time.

2026-11-182026-11-19

2 real daily observations. 104 → 107 stars.

Repository screenshot / seerrngOpen source page
seerrng repository screenshot

FROM THE PROJECT

README & features

Source excerpts from the project's README. Not an independent review, verification or security audit.

Support SeerrNG development on Ko-fi .

SeerrNG

SeerrNG is a self-hosted request and discovery app for personal media libraries. It extends the Seerr/Jellyseerr/Overseerr lineage beyond movies and TV into music, books, comics, magazines, emulation ROMs, and PC games while keeping the familiar request approval workflow for Plex, Jellyfin, Emby, and automation-service users.

SeerrNG is maintained by snapetech as a separate fork so we can move quickly on cross-media workflows and test ambitious features while keeping Seerr as the base for inherited video, user, server, and deployment behavior. The fork gives us room to develop and validate ideas before proposing them upstream; it does not presume that upstream should adopt every feature or the entire product direction. See why SeerrNG is a fork for the rationale, integration changes, and conditions that could let upstream equivalents replace the fork, and NOTICE.md for attribution rules.

For local MCP access, see the SnapeTech MCP integration guide.

Contents

What SeerrNG Does

Project Status

Documentation and feature guides

SeerrNG Android app

Move between Seerr and SeerrNG

Choose available media categories

Manage the family age gate and per-user maturity limits

Track individual TV episode availability

Software requests: ROMs and PC games

Request Status and Download copy

Books, authors, and series

ChaptarrNG Bookshelf integration

Read-only Audiobookshelf availability

Move Bookshelf media paths

Configure comics

Configure magazines

Movie and series Discover filters

Per-user movie and TV availability

Global Search

Private movie watch sessions

Choose request destinations

Add your requester tag to available media

Require previous-season watch progress

Hide subject tags

Filter and sort local watchlists

Follow another user's request

Companion services and SeerrNG NG forks

Share to Request: links, ISBNs, lists, and photos

Continue, compare, and follow

Cross-media feature requirements

Following

SeerrNG Companion browser extension

Troubleshoot cross-media features

Add and import users

Why SeerrNG is a fork and what could retire it

Cross-platform setup assistant

Indexer searches by media category

Configure services

Manage users and request preferences

Configure sign-in methods, including Jellyfin Quick Connect-only sign-in

Slack notifications

Telegram notifications

Configure notifications and follow request availability

Kubernetes installation and Helm chart

Screenshots

Install

Docker

Docker Compose

Unraid

Linux packages

Kubernetes

Android APK

Required Setup

Bookshelf and Hardcover

Environment Variables

Caching and Performance

Development

Testing Real Integrations

Legal Use

Support

Security

Contributing

Attribution

Seerr vs SeerrNG

The comprehensive feature comparison compares shared capabilities, SeerrNG extensions and unfinished work against pinned upstream sources. Every row links to an in-repository guide with source attribution.

What SeerrNG Does

Requests and approvals for movies, shows, music, ebooks, audiobooks, comics, magazines, emulation ROMs, and PC games.

A companion Android APK client for connecting to one or more self-hosted SeerrNG servers.

Movie and series Discover filters with 0.1-point TMDB rating thresholds, region-aware streaming-service filters, and media-specific title sorting. Provider filters support bulk select and clear, custom sliders accept public TMDB lists, filter state is URL-backed, and home sliders restore their position.

Media-server integration with Plex, Jellyfin, and Emby, including watch-state-aware My Library views scoped to each linked account. Failed Plex library syncs preserve the saved library list, report connection failures clearly, and retry startup migration on the next restart.

Jellyfin library synchronization preserves each library's enabled selection and stored scan timestamp across display-name changes when the server keeps its stable library ID. Adapted from Seerr PR #3323.

Optional administrator network restrictions for SeerrNG browser sign-ins, using IPv4 or IPv6 address and CIDR allowlists without blocking remote access for regular users.

Administrators can require Jellyfin Quick Connect for Jellyfin sign-in; this disables Jellyfin password and plugin bridge sign-in while leaving Emby, Plex, local, and OpenID Connect sign-in independent. Adapted from Seerr PR #3315.

Plex playback links: use the hosted Plex Web App by default, or configure the full self-hosted web app URL (including a path such as /web/index.html) for Play on Plex links. See the Plex settings guide. This documentation clarifies Seerr issue #3220.

Viewer-scoped movie and TV availability checks for linked Plex, Jellyfin, and Emby accounts, including visible seasons and exact request destinations. This SeerrNG adaptation is informed by Seerr issue #180 and PR #3296; it does not change media-server permissions.

Unified global Search across enabled media catalogs, including TMDB movie collections that open in SeerrNG's collection detail and request flows.

Person pages with movie or TV credit filters and sorting by popularity, release date, rating, vote count, or title.

Optional Jellyfin and Emby profile sync during user imports, refreshing linked provider names and avatars while preserving SeerrNG email addresses, local passwords, and permissions.

Labeled movie and TV request destinations across multiple Radarr and Sonarr instances, with per-user access and availability tracked for each destination.

Optional per-instance Radarr/Sonarr tag exclusions for library scans, with existing request history preserved and non-excluded service copies still counted.

Advanced movie and TV requests resolve service, anime, account, and rule defaults without treating every displayed value as a deliberate override; editable requests can return to the configured Servarr defaults. See request defaults and overrides.

Temporary Radarr and Sonarr connection or server failures retry automatically with durable, bounded backoff; non-transient failures remain visible for review and manual retry.

Managers can approve a one-time movie or TV request exception when a user's quota is full; optional Slack actions use a mapped account and the same request permissions as the web app. Manager API clients need both user-management and request-management permission to attribute requests to a selected user; request admission and quota checks use that requester.

Movie and TV title cards show standard and 4K availability separately across search, Discover, collections, people, and list views, so a 4K-only copy is visible as 4K.

Sign-in returns users to a validated in-app destination across local, media-server, and OIDC login, and sign-out clears the previous return destination. OIDC account provisioning requires a verified email and applies the configured account-admission and role rules.

Long-running TV details and request pages stay responsive when a series has many stored and requested seasons.

Users can request their own requester tag on an already available movie or fully available series. The tag action follows normal request permissions, quotas, and approval without starting another acquisition; SeerrNG adapts the idea discussed in Seerr PR #3423.

Administrators can automatically blocklist movies and series by TMDB keyword or type-specific genre. Source filters distinguish automatic rules from manual entries, and removing a rule preserves manual blocks and restores saved media status. See the automatic blocklist settings guide. This SeerrNG adaptation is attributed to closed Seerr PR #3318.

Automation service integration with Radarr, Sonarr, Lidarr, and Bookshelf/Readarr-compatible APIs.

SeerrNG PR #446 proposes bounded, paginated Servarr queue tracking with refresh-completion checks and a per-service Download Queue Size control. It covers 10–10,000 items per service, defaults to 1,000, and keeps recovery on strict complete snapshots. Source context: closed, unmerged Seerr PR #3473 and open Seerr PR #3535.

Notifications for email, Discord, Slack, Telegram, Gotify, ntfy, Pushover, Pushbullet, Apprise, Web Push, and custom webhooks, with provider-specific poster, priority, sound, and email transport options documented in the notification guides.

Sonarr v5 support alongside v3/v4, including metadata-language and season-order options with explicit season mapping for recovery. Scans account for both TVDB and resolved TMDB identity, distinguish confirmed absence from incomplete or failed checks, and reconcile abandoned processing seasons and request selections only after relevant configured servers finish.

Optional per-episode file availability from Sonarr, Plex, Jellyfin, and Emby on TV season pages. Badges preserve source and standard/4K distinctions; media-server library episode order must match the selected TV or anime metadata provider. File presence remains separate from per-user playback access. See individual episode availability.

An optional TV request gate that checks whether the previous regular season was watched through a linked Plex, Jellyfin, or Emby account.

Administrator-managed family controls: separate movie and TV rating limits for each account, plus an optional family age gate with a configurable default that filters Adult, explicit, and mature-tagged titles across supported media categories.

Admin-configured Prowlarr connection, per-indexer diagnostics, category coverage, and format-aware manual search across movies, TV, music, books, comics, magazines, ROMs, and PC games, with title-prefilled search links from media details; approved requests still go through their configured acquisition providers.

Music discovery and metadata through MusicBrainz, ListenBrainz, Cover Art Archive, TheAudioDB, and archive-backed artwork sources.

Administrators can test MusicBrainz and Cover Art Archive connectivity and set bounded Cover Art Archive request limits.

Book discovery and identity matching through Open Library, ISBN-10/ISBN-13 normalization, foreign book IDs, and edition IDs.

Audiobook discovery from connected audiobook catalogs, with author and narrator filtering and no ebook-only search results.

Comic discovery through ComicVine and magazine discovery through Google Books or LazyLibrarian. For new comic automation setups, SeerrNG recommends Issuarr, the actively developed successor to Mylar3; existing Mylar3 connections remain supported through the same service type. Kapowarr and BackIssue are also supported comic backends, and LazyLibrarian handles magazines.

Separate ebook and audiobook service routing so both formats can be requested, approved, scanned, retried, and removed independently.

Existing BookshelfNG installations can manage both formats on the same book

record. When both formats are enabled, their separate SeerrNG service entries can point to the same BookshelfNG URL and API key; new deployments should use the standard ChaptarrNG service.

ChaptarrNG requests preserve the selected book format, show author-preparation

progress and retry timing, and resume after imports complete. Pending imports are cancelled only when no other active request still needs them; ChaptarrNG 0.9.941+ also supports a restricted SeerrNG service key.

The BookshelfNG-to-ChaptarrNG handoff is implemented in ChaptarrNG's one

standard product, but BookshelfNG distribution retirement remains blocked. Public releases remain BookshelfNG 0.4.21.76 and ChaptarrNG v0.9.977; ChaptarrNG main is fa55ffab (full SHA fa55ffabe632c7ee003791635ebe53fb1895d3df), with latest application source snapshot bd589312. ChaptarrNG PR #183 merged at 96c953b2, with follow-up main commits preserving legacy Docker handoff ports. The merged code does not add a compatibility image. Build run 41168525352 is waiting on its merge-head validation at 96c953b2; it does not validate the current application source. The main dispatch and platform/archive runs remain queued at older source; no exact-head pass for application source bd589312 or current main fa55ffab is recorded here. No BookshelfNG package, image, installer, updater, or chart identity has been redirected. Keep BookshelfNG serving its existing data until feature parity, populated-data conversion, rollback, and each old installation channel are individually accepted. Each BookshelfNG capability, data/configuration path, and channel remains a blocker. The separate ChaptarrNG-to-upstream gate includes carried BookshelfNG behavior plus all ChaptarrNG features that are maintained, active, or unreleased. The current source-path audit compares BookshelfNG 1bd7f2dc with ChaptarrNG main fa55ffab (application source bd589312), with 587 open dispositions; that is a path review count, not a missing-feature count. See the BookshelfNG consolidation report and ChaptarrNG's itemized retirement matrix.

Optional read-only Audiobookshelf library scanning marks ISBN-matched items

as available audiobooks without sending acquisition requests or changing Audiobookshelf data.

Share to Request: paste a link, ISBN, list of titles, or a photo (or use the Android Share menu) and request the matches you confirm, switching ebook and audiobook at the point of discovery. Photos are read by local OCR or an opt-in vision provider, including local Ollama-style servers.

Continue the story: from an anime, find the manga or light novel that continues it, see where the finished season ends when documented, and request the right volume or follow future translated volumes. A franchise page groups sources, sequels, and side stories with confidence and evidence.

Editions and narrations: compare narrators, full-cast and solo, abridged and unabridged, and keep a second performance alongside the first (ChaptarrNG); compare a series by narrator; request a specific standard, deluxe, or remastered album release.

Games and patches: compare game editions and request only the expansions you choose (QuestarrNG), find games by theme, mode, perspective, and language with saved searches, and request exact translation or ROM-hack versions with the original kept alongside (ROMarrNG).

Discovery you steer: Hardcover book recommendations with standalone, first-in-series, and less-popular filters; Collector Picks from slskdN with the reason each appeared.

Following: follow cast and crew, production companies, TV networks, movie or series genres, narrators, authors, series, game content, artists, and patch projects. The personal feed explains each recent or upcoming update; automatic requests remain limited to supported book follows. See the Following guide for date bounds, baseline behavior, maturity limits, and notification scope.

A standalone SeerrNG Companion browser extension for requesting from IMDb, Letterboxd, Steam, Goodreads, AniList, and more.

Catalog browsing and requests for Retro and Modern emulation systems and PC games for Windows, Linux, and macOS, with QuestarrNG and ROMarrNG handling acquisition.

Administrator-controlled availability switches for each supported category, including separate ebook, audiobook, Retro, Modern, and PC Games controls.

Book backend diagnostics that classify Hardcover, softcover/Goodreads, and unknown metadata providers.

ChaptarrNG is the recommended Hardcover-first book service for new deployments; BookshelfNG migration tooling remains available for existing Readarr or softcover libraries.

A preview-first BookshelfNG-to-ChaptarrNG database migration helper for single-database installations. Migration apply remains frozen until feature, migration, rollback, and installation-channel acceptance is complete. BookshelfNG issue #144 is closed, but that did not close the remaining gates: do not run --apply or start ChaptarrNG against BookshelfNG appdata; keep BookshelfNG in service.

Admin-only Bookshelf path moves with a conflict and disk-space preview, confirmation, API access, and a dry-run-first CLI. The mover works inside one BookshelfNG database; consolidate an old split deployment before using it.

Resumable, layered Readarr/softcover-to-Hardcover migration with strict matching, softcover metadata recovery, validation, cutover checks, and an opt-in deterministic local-record fallback for books Hardcover cannot import.

Per-user cross-media watchlists; local-only lists support title search, media-type filters, and stable sorting, while combined Plex lists preserve Plex ordering. The request workflow also includes blocklists, quotas, override rules, permissions, notifications, issue reporting, and request management. Users with issue-reporting permission can report processing movie and series requests before the media is available.

Private movie watch sessions, adapted from the use case in Seerr issue #3310: invite household members, review a bounded shared movie deck with private ballots, optionally contribute watchlist candidates without attribution, and see only unanimous matches. Each session applies the strictest participating member's maturity policy; a match goes through the regular request flow and never creates a request automatically. See the watch sessions guide.

Users can choose whether movie and TV copies requested by someone else appear as shared or stay hidden; this changes the availability display, not media-server access.

Discover shelves can be reordered and customized with public TMDB lists. Movie and series filters include fractional ratings, streaming-service inclusion or exclusion, category exclusions, media-specific title sorting, and URL-backed state. Catalog pagination follows TMDB's reported page total. SeerrNG's scoped handling for a failed later page—retry once, skip only an isolated repeat failure, and surface first-page or consecutive failures—is implemented in PR #456, following Seerr issue #3654 and PR #3656. Discover detail navigation keeps the selected result context, each shelf restores its own horizontal position on return, and rating details work on touch screens. Hide Requested Media also hides Pending or Processing standard/4K states when the active request row is absent. The preference applies to movie and TV result grids while explicit title searches remain visible.

Movie and Series Subject Tags can be hidden with a browser-saved preference shared across both detail pages.

Authenticated Download copy links in Request Status for verified movie, TV, book, comic, magazine, ROM, and PC game files.

Movie and TV request history can be sorted by title, release date, TMDB rating, and popularity across the full filtered history; other media keep date-based sorting.

Request lifecycle tracking and availability notifications link users back to the matching Request Status item, where available files can be selected and saved. Media-request titles and follower availability notices follow each notification delivery's language; Discord can use the recipient's profile language. See the notification guide.

Generic webhook notifications support bounded JSON templates, custom headers, and allowlisted lowercase, URL-encoding, and slugification filters. See the webhook guide.

Signed-in household members can follow another user's active movie or series request for a one-time availability notice through their own configured notification channels.

Administrators can opt into a separate Pending Request Updated notification when an edit changes a pending request's owner, selected seasons or episodes, or acquisition options. The webhook event is MEDIA_PENDING_UPDATED; see the notification guide.

Browser, service-worker, API, DNS, avatar, and image-proxy caching tuned for faster refreshes and tab restores.

Removing an item from an acquisition service such as Radarr or Sonarr preserves its SeerrNG media record and request history; Clear Data is a separate, explicitly destructive action.

Server-side Axios requests use a versioned User-Agent; provider-specific values are preserved. See Network settings.

Project Status

SeerrNG is active fork work. Movie and TV behavior is inherited and generally stable. Music and book support is usable but should still be treated as evolving, especially around provider matching and real-world Bookshelf/Readarr edge cases.

Recent repository updates include:

Discover: editable shared shelves; more precise rating and streaming

filters; media-specific title sorting; category exclusions; detail navigation through the current result list; and restored carousel position when returning from a title.

Requests: per-user access to labeled Radarr/Sonarr destinations, quota

exception approvals, optional Slack approval actions, an optional previous-season watch gate, requester-tag actions for already available movies and complete series, and Sonarr monitoring for future seasons when the latest regular season was requested. Failed TV requests retain their context and support verified season mapping; missing movie or TV service destinations fail promptly with a retry path, and bounded failure explanations and request history are localized. Request rows use their paginated list data on mount, focus, and reconnect rather than making duplicate detail reads; active-download details continue to refresh. Pending requests complete without a duplicate dispatch when library activity confirms the requested media (Seerr issue #3657, PR #3659).

Search matching: unmatched TMDB queries retry with normalized punctuation, spacing, apostrophes, and diacritics; successful literal-query results retain their order.

rules can also match a movie or series by its TMDB production countries, with Sonarr language-profile selection on service versions that expose those profiles. This adapts the use case in Seerr issue #3439. Administrators can also apply an optional per-user streaming-availability policy to movie and series requests, with reject, pending, automatic-approval, and per-request override choices.

User workflows: local watchlist filters, a browser-saved Subject Tags

visibility preference, private one-time availability notices for followed requests, per-user shared-availability display choices, and opt-in Jellyfin/Emby profile refresh during imports. Administrators can also set per-user movie and TV rating limits and control the broader family age gate. Jellyfin administrators can require Quick Connect instead of password or plugin bridge sign-in. Linked-account movie and TV availability is verified against visible libraries and seasons.

Plex Watchlists: metadata lookups are bounded to five at a time. An

unreachable or timed-out item no longer prevents the rest of a page from loading; authentication and other provider failures remain visible. This adaptation addresses Seerr issue #3235 and PR #3251.

Sonarr: v5 API support alongside v3/v4, metadata-language and season-order

choices, request recovery scoped to the selected service, quality, and season order, plus orphaned-season reconciliation using both TVDB and resolved TMDB identity. Anime routing honors the configured anime root folder while preserving folder overrides.

Availability and sign-in: separate standard and 4K status on title cards,

and safe return to the requested in-app page after authentication.

Downloads: complete, bounded Servarr queue reads wait for monitored-download

refreshes and preserve the last verified state when a full snapshot is unavailable.

TMDB details: Movie and series detail pages remain usable when optional

appended sections such as credits, keywords, content ratings, or provider results are missing from a response.

Episode availability: optional per-episode file indicators from Sonarr

and media-server libraries, with independent source reconciliation and standard/4K state. Sonarr uses TVDB order; Plex, Jellyfin, and Emby libraries require an explicit numbering-order choice that matches the active TV or anime metadata provider. These indicators describe scanned file presence, not a user's access or ability to play the file. See the setup and behavior guide.

Integrations: MusicBrainz and Cover Art Archive connectivity checks with

bounded artwork traffic controls; outbound proxy routing for Cover Art Archive and Steam library clients; and a preview-first BookshelfNG to ChaptarrNG database migration helper for single-database setups.

Localization: the catalog roadmap

records current coverage and review requirements. Indonesian messages use English fallback where translations are missing; upstream Seerr PR #3667 is not a direct catalog import because its message IDs do not match SeerrNG's expanded UI.

Kubernetes: the Helm chart can stop its single application pod with

replicaCount: 0 for maintenance and resume it with replicaCount: 1; values that would start multiple SeerrNG instances are rejected.

API integrations: the OpenAPI watchlist contract describes the

type-specific IDs required for each supported media type, the fields returned by the create endpoint, and the public requester shape. Seerr issue #3298 reported the request mismatch, PR #3425 corrected the movie and TV request schema, and PR #3635 aligned the response schema upstream.

These changes are in the repository; use the release notes to confirm which ones are included in a published build. SeerrNG continues to adapt selected upstream work in attributed, reviewable changes. The fork-retirement matrix describes the behavior and upgrade evidence a supported replacement would need before the core fork could be retired. Because the OpenAPI specification also validates runtime requests, maintainers keep it aligned with route inputs and permission-aware responses; see the API contract guide.

Release notes are maintained in CHANGELOG.md. User-facing pull requests add a concise release-note fragment under release-notes/; the release workflow publishes those notes to GitHub Releases and the Discord release announcement. Fragments capture the affected audience, product area, required action, and breaking-change status, and CI shows the exact release-note preview during review. The historical tag coverage and audit method are documented in docs/maintainers/release-history-audit.md. The in-app version check compares against published stable tags from the SeerrNG fork, not the upstream Seerr repository.

Documentation

SeerrNG documentation is maintained in the docs folder. The links below open the corresponding guides directly:

Install SeerrNG

Install on Unraid

Move between Seerr and SeerrNG — preview and carry compatible settings, users, and database records in either direction.

Find books, authors, and series

Configure OIDC sign-in, account linking, and provider recovery

Cross-project OIDC implementation contract · provider catalog and official setup links

Create custom Discover sliders

Filter movie and series Discover results

Browse and sort movie and TV credits on person pages

Configure Sonarr v5 and season orders

Restrict administrator sign-in by client network

Track individual TV episode availability

Require previous-season watch progress

Choose movie and TV request destinations

Add your requester tag to available media

Filter and sort local watchlists

Follow another user's request

Hide Subject Tags

Why SeerrNG maintains companion forks

Why SeerrNG is a fork and what could retire it

Maintain the OpenAPI API contract — keep request validation and API documentation aligned with SeerrNG routes and response filtering.

ChaptarrNG fork changes and capabilities

Discover and request comics

Discover and request magazines

Track requests and status history

Browse and request emulation games and PC games

Share to Request

Continue, compare, and follow

What each cross-media feature needs

Following

Browser extension

Troubleshoot cross-media features

Download verified files from Request Status

Use media detail and playback controls

Configure media-server libraries, including Plex Music and Audiobooks

Enable built-in HTTPS

Configure notifications

Slack notification settings

Telegram notification settings

Configure automatic blocklist rules and global media visibility

Choose which media categories are available

Configure Bookshelf

Move ebook or audiobook files between Bookshelf root folders

Bookshelf metadata sources

Configure override rules

Manage users and request preferences

Manage the family age gate and per-user maturity limits

REST API reference

Docker

The main container image is published from this repository:

docker run -d \
  --name seerrng \
  -e LOG_LEVEL=info \
  -e PORT=5055 \
  -p 5055:5055 \
  -v /path/to/seerrng/config:/app/config \
  --security-opt=no-new-privileges \
  --cap-drop=ALL \
  --restart unless-stopped \
  ghcr.io/snapetech-org/seerrng:latest

Open http://localhost:5055 and complete setup.

Docker Compose

services:
  seerrng:
    image: ghcr.io/snapetech-org/seerrng:latest
    container_name: seerrng
    environment:
      LOG_LEVEL: info
      PORT: 5055
      # Optional overrides; SeerrNG includes a default TMDB application key.
      TMDB_API_KEY: ${TMDB_API_KEY}
      TMDB_READ_ACCESS_TOKEN: ${TMDB_READ_ACCESS_TOKEN}
    ports:
      - 5055:5055
    volumes:
      - /path/to/seerrng/config:/app/config
    security_opt:
      - no-new-privileges:true
    cap_drop:
      - ALL
    restart: unless-stopped

To create a guided starter stack for SeerrNG and common media apps on Windows, macOS, or Linux, use the cross-platform setup assistant.

Unraid

Install SeerrNG from Community Applications with the Unraid template. It uses the stable latest image, maps HTTP port 5055 and optional HTTPS port 5056, and persists /app/config. The image runs as UID/GID 1000:1000, so make the selected appdata directory writable by that user before the first start. Optional BookshelfNG, ChaptarrNG, ROMarrNG, and QuestarrNG templates live in each fork's own repository; the Unraid guide links to their templates and to the existing Community Apps listings for LazyLibrarian, Mylar3, and Kapowarr, plus Issuarr's own Unraid guide. BackIssue has its own Docker image and Unraid template; see its getting-started guide.

Linux Packages

This repo includes release workflows and packaging metadata for tarball, Debian, RPM, AppImage, Flatpak, Snap, AUR, PPA, and COPR style distribution. These packages install SeerrNG as a standalone service; Lidarr, Bookshelf, and other automation/media servers are optional external services configured inside SeerrNG. Use the GitHub releases for generated artifacts when available.

Android APK

The Android app is a client for servers you already run. Add one or more server URLs in the app; see the Android app guide for setup and connection details. The Play build uses a 20-session free preview and a one-time lifetime unlock at a recommended US price of $2.99. It contains no advertising SDKs. See the pricing and monetization decision.

The current tested mobile packages are attached to the SeerrNG mobile prerelease:

PackageDownloadSHA-256
Android APK for direct install (stable project signing key)APKchecksum
Android App Bundle signed with the upload keyAABchecksum
iOS Simulator build (not an iPhone/iPad installable IPA)Simulator ZIPchecksum

The GitHub Android packages have Play Billing disabled, so they remain unlimited evaluation builds; the 20-session cap and lifetime purchase UI are only enabled in a configured Play build. These are prerelease test builds, not store-approved releases. See the mobile release readiness guide for signing details, test results, store status, and remaining release work.

Kubernetes

The signed SeerrNG Helm chart can render administrator-supplied Kubernetes resource objects with the same release. The extraResources value is empty by default; see the Kubernetes guide and chart values.

Required Setup

SeerrNG needs the same base setup as Seerr for video libraries, plus optional services for music and books.

Core:

A Plex, Jellyfin, or Emby server.

Radarr for movie automation.

Sonarr for TV automation.

SQLite or PostgreSQL for the application database.

An empty SeerrNG database can be provisioned with a Jellyfin or Emby connection already stored in settings.json. The first administrator sign-in preserves that connection and any existing media-server API key; SeerrNG creates an API key only when none is configured. Keep settings.json private and out of source control.

Music:

Lidarr server configured in Settings > Services.

Root folder, quality profile, metadata profile, and tags configured from the Lidarr service settings.

A default Lidarr server if users should be able to request music without choosing a service each time.

Jellyfin and Plex music libraries can also be enabled in Settings > Media

Server; albums need MusicBrainz metadata for SeerrNG to match existing media. Plex artist libraries can be reclassified as Audiobooks for audiobook availability. Lidarr remains the music automation and fallback source.

Books:

ChaptarrNG is the recommended book service for new deployments; existing BookshelfNG and other Readarr-compatible services remain supported for current installations.

One ChaptarrNG instance can manage both ebooks and audiobooks. Add two SeerrNG service entries with the same connection details and choose the matching format for each. Existing BookshelfNG installations can keep using one instance for both formats while the migration gates remain open.

Audiobookshelf can be connected separately under Settings > Services > Audiobookshelf Availability to detect existing audiobooks. It is read-only and matches books by ISBN.

Separate defaults for ebook and audiobook so Both format requests can route to each format.

Existing Readarr or softcover/Goodreads libraries should be migrated before switching to Hardcover metadata. The service settings modal links directly to the Bookshelf Hardcover migration runbook.

Software requests:

QuestarrNG provides the IGDB catalog and acquisition for PC game requests.

ROMarrNG is also required for emulation requests. In Settings > Services > Software Acquisition, connect each provider and assign supported ROMarrNG systems to Retro or Modern before users can request them.

Software requests support global and per-user quotas. Requesters can withdraw pending requests and cancel active QuestarrNG work that is linked to their request. ROMarrNG requests can be cancelled before download-client handoff; active transfers must be stopped in ROMarrNG or the download client.

Provider hostnames and ports must be reachable from the SeerrNG server or container. Use each provider's SeerrNG integration API key; keys stay server-side.

See the software requests guide for provider setup, request targets, status, retries, notifications, and downloads. See Request Status for the shared Download copy workflow.

Companion services

Media servers and acquisition tools run as separate optional services; they are not bundled into the SeerrNG container. Use only the providers for the categories you enable. For book and software workflows that depend on SeerrNG-specific API behavior, the recommended Snapetech NG forks are BookshelfNG, ChaptarrNG, QuestarrNG, and ROMarrNG. ChaptarrNG is the recommended book service for new installations; BookshelfNG remains available for existing installations while migration acceptance is open. One ChaptarrNG instance can serve both Book and Audiobook requests. ChaptarrNG also has an optional BookLore BookDrop destination for imported files; BookLore is an external app, not a SeerrNG or ChaptarrNG dependency. See the BookLore integration guide. QuestarrNG handles PC game acquisition, while ROMarrNG handles emulation systems and ROM acquisition.

As of 2026-10-31, BookshelfNG 0.4.21.76 and ChaptarrNG v0.9.977 remain the latest public releases. ChaptarrNG v0.9.977 includes single-database SQLite migration preview and conversion tooling, but apply remains frozen while migration, rollback, feature-parity, and installation-channel acceptance are open. ChaptarrNG PR #183 merged at 96c953b2; its handoff uses the ordinary ChaptarrNG product and does not add a compatibility image. Follow-up main commits preserve the legacy Docker port contracts. The exact merge-head Build 41168525352 is waiting and does not validate current application source bd589312; the main and standalone platform/archive jobs remain queued at older source. No exact-head pass for application source bd589312 or current main fa55ffab is recorded here. No legacy identity bridge has been published or enabled, so existing BookshelfNG installations should keep their current data and backup path. ChaptarrNG remains the maintained destination. Its later retirement into upstream Chaptarr must preserve both ChaptarrNG's maintained and actively added features, including unpublished work, and the BookshelfNG features carried over. That complete union blocks ChaptarrNG retirement as a whole. Each feature, sub-feature, data path, and distribution channel remains an individual blocker; active ChaptarrNG branches and open feature PRs count before release. See the combined feature snapshot and the fork transition criteria.

Radarr, Sonarr, Lidarr, LazyLibrarian, Mylar3, Issuarr, Kapowarr, and BackIssue are separate upstream or third-party integrations. They are not NG forks. The companion services guide compares providers, explains what each maintained NG fork provides, and links to the upstream transition criteria.

Bookshelf and Hardcover

SeerrNG recommends ChaptarrNG as the book backend for new deployments. Existing BookshelfNG instances remain supported while migration acceptance is open. Both services can manage ebooks and audiobooks from one instance; configure separate SeerrNG service entries for the formats you enable.

ghcr.io/snapetech/bookshelfng:hardcover

The stable hardcover and softcover tags are published only from BookshelfNG's main release workflow, so SeerrNG follows the newest released BookshelfNG build. Set BOOKSHELF_IMAGE to a digest-pinned reference when a reproducible or rollbackable deployment is required.

BookshelfNG and rreading-glasses

These components solve different problems. Fresh Hardcover installs use the rreading-glasses compatibility boundary by default; native Hardcover remains an explicit opt-in:

If Docker is not an option, see the BookshelfNG source-build guide for a direct Linux build, systemd service, metadata configuration, and SeerrNG connection.

BookshelfNG is the maintained Readarr-style application. It manages the

library, download clients, imports, file organization, and the Readarr-compatible API that SeerrNG uses.

rreading-glasses is a compatibility/proxy layer. In compatibility mode,

it exposes the metadata API BookshelfNG expects, translates requests to Hardcover or Goodreads, caches results in PostgreSQL, and coalesces or rate-limits upstream work.

Hardcover metadata modes are:

ModePathLocal proxyBest for
compatibility (default for fresh Hardcover installs)BookshelfNG → rreading-glasses → upstreamOn, with PostgreSQLA durable shared cache, centralized throttling, or a compatibility boundary
native (explicit opt-in)BookshelfNG → Hardcover GraphQLOffThe simplest direct Hardcover deployment
hostedBookshelfNG → METADATA_URLOffA hosted compatibility endpoint without local state

Compatibility mode is the installer default because it keeps BookshelfNG decoupled from Hardcover's GraphQL API and centralizes authentication, caching, request coalescing, and upstream throttling. One proxy and PostgreSQL cache can serve one or more BookshelfNG instances; one instance is enough for ebooks and audiobooks. Existing installs that already use the local proxy are preserved as compatibility mode on installer reruns.

Native mode remains useful when the shortest direct request path is more valuable than the shared proxy boundary. Select it explicitly with BOOKSHELF_METADATA_MODE=native.

There is no automatic runtime failover between modes. Compatibility mode is not an unlimited offline mirror: cache misses, expired entries, searches, and new metadata still need Hardcover. Its proxy and database are additional local failure points, but the PostgreSQL cache survives proxy restarts.

For compatibility mode, provide HARDCOVER_AUTH with the Bearer prefix; the token is consumed by rreading-glasses rather than BookshelfNG. Native mode passes the same token to BookshelfNG. Hosted mode does not require a local token for metadata, although Bookshelf's own Hardcover list-import settings still need an API key when that feature is used.

Hardcover API token requirement

Self-hosted compatibility and native modes require a Hardcover API token from an account you control. Create one in Hardcover account API settings. For compatibility mode, set HARDCOVER_AUTH; for managed native mode, set BOOKSHELF_HARDCOVER_AUTH or save the token in BookshelfNG Settings > Metadata when no environment value overrides it. Hosted mode uses its configured metadata endpoint and does not require a local Hardcover token for searches or lookups.

Any token configured on a self-hosted BookshelfNG or rreading-glasses service is used server-side by all SeerrNG users connected to it. A shared hosted endpoint such as hardcover.bookinfo.pro manages its own upstream access; changing the local BookshelfNG token does not replace the hosted service's credential. To use a personal token, configure a self-hosted native or compatibility service with the token for that mode. The Hardcover list-import feature also requires its configured API key.

Compatibility-mode outage behavior

In compatibility mode, a metadata request follows this path:

BookshelfNG calls the local rreading-glasses endpoint; it does not call

Hardcover directly.

rreading-glasses checks its in-memory cache and then its PostgreSQL-backed

cache.

A cached, still-valid author, work, edition, or series response can be

returned without contacting Hardcover.

A cache miss, expired entry, or free-text search needs an upstream request;

successful responses are written back to the shared cache.

This gives connected Bookshelf instances a shared cache, coalesces concurrent work, and centralizes rate limiting. A short Hardcover outage can therefore leave already-cached direct lookups usable, and a proxy restart does not discard the cache when the PostgreSQL volume is healthy. It does not make the system an unlimited offline mirror: searches, recommendations, new metadata, and expired entries still depend on Hardcover, and the current proxy does not promise stale-if-error responses.

The proxy and PostgreSQL database are shared local dependencies. If either is down, connected Bookshelf instances lose this metadata path. There is no automatic runtime failover to Goodreads or OpenLibrary. Keep the proxy data volume while troubleshooting; use --validate-api, an actual lookup, and proxy logs after recovery. Native mode has a smaller local failure surface but only per-process caching, so a fresh search or uncached refresh still needs Hardcover.

Legacy softcover/Goodreads deployments remain supported for existing users:

ghcr.io/snapetech/bookshelfng:softcover

Do not convert an existing Readarr or softcover database to Hardcover by only changing the image tag or METADATA_URL. Goodreads/softcover author, book, and edition IDs are not portable to Hardcover. Use the migration flow below.

Bookshelf Installer

Fresh deployments run one combined BookshelfNG process and one database for ebooks and audiobooks. SeerrNG still needs two service entries because it routes Book and Audiobook requests separately; point both entries to the same BookshelfNG URL and API key. The installer remembers this choice.

Existing audiobook databases keep the split two-process layout on reruns. The installer does not merge databases. Select --single-instance only after migrating any separate audiobook database; the helper refuses to ignore one. Use --split-instances when separate BookshelfNG settings or databases are desired:

deploy/install-bookshelf-backend.sh

Useful modes:

deploy/install-bookshelf-backend.sh --dry-run
deploy/install-bookshelf-backend.sh --validate-only
deploy/install-bookshelf-backend.sh --validate-api
deploy/install-bookshelf-backend.sh --split-instances
deploy/install-bookshelf-backend.sh --migrate-to-hardcover
deploy/install-bookshelf-backend.sh --restore-backup

Use --single-instance to explicitly choose the combined deployment. Fresh installs already choose it by default.

Set BOOKSHELF_BACKEND=auto|hardcover|softcover to choose the backend policy. auto creates a Hardcover-backed BookshelfNG deployment for fresh installs and invokes the migration flow when an existing Readarr/softcover config is detected without a saved backend choice.

Hardcover Migration

The migration toolchain is first-class for existing book libraries:

deploy/install-bookshelf-backend.sh --migrate-to-hardcover
node deploy/bookshelf-hardcover-migration.mjs --summary /path/to/hardcover-migration
node deploy/bookshelf-hardcover-migration.mjs --validate /path/to/hardcover-migration
node deploy/bookshelf-hardcover-migration.mjs --cutover-check /path/to/hardcover-migration
node deploy/bookshelf-hardcover-migration.mjs --reconcile-local /path/to/hardcover-migration

The migration is layered:

inventory source Readarr/Bookshelf SQLite databases;

strictly match native Hardcover records by ISBN/ASIN/title/author;

preserve root folders, quality profiles, metadata profiles, tags, monitored state, and search policy;

resume from checkpoints and skip previously applied records;

retry transient target errors and de-duplicate bad target metadata cache rows;

pre-create missing authors where Hardcover can resolve them;

optionally query a softcover Bookshelf endpoint to recover title/author/edition metadata, then remap that profile back through Hardcover;

query OpenLibrary for alternate title/author/ISBN profiles, then remap those candidates back through Hardcover;

query Google Books and the Library of Congress for additional migration recovery profiles, then remap only strict matches through Hardcover;

optionally call a configured Apify Actor to search Goodreads-compatible catalogs when the open APIs do not return useful metadata;

optionally create deterministic local Bookshelf records for the books Hardcover still cannot import.

These catalogs support normal BookshelfNG search and metadata lookups, as well as migration recovery. SeerrNG merges BookshelfNG results with its Open Library results and carries each Bookshelf result's source identity through details and book requests. The default deployment uses one BookshelfNG instance and one catalog selection for both formats. The optional split deployment can configure catalogs separately per process; it enables Library of Congress on the audiobook process by default to coordinate request pacing. Google Books and Europeana are added when their API keys are configured. Apify remains operator-enabled. A provider result does not need a numeric Goodreads ID. See the metadata source support matrix for setup, coverage, limits, and identity details.

Migration record states:

native: Books

This is an excerpt of a longer README. Open the source for the complete document.

Read the original README

KEEP EXPLORING

Also worth a look.

Keep good tools on your radar.

Short demos. New discoveries. Less noise in your feed.

Follow The StackRadar
THE STACKRADAR WALKTHROUGH

Tool demo

Tool details Open tool

Watch here, then explore the project's source for current details.