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.
snapetech-org/seerrng
Seerr fork adding Music, eBooks, Audiobooks, Comics, Magazines, Roms, Games, & Software to existing Music & TV Requests and approval management.
THE USEFUL PART
Seerr fork adding Music, eBooks, Audiobooks, Comics, Magazines, Roms, Games, & Software to existing Music & TV Requests and approval management.
THE STACKRADAR WALKTHROUGH
A short introduction from our reel. See the project README for the current details.
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.
New reason: parental controls integrated with major media servers.
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
Recorded counts, not a growth rate or a quality score.
OBSERVED STAR HISTORY
2 real daily observations. 104 → 107 stars.

FROM THE PROJECT
Source excerpts from the project's README. Not an independent review, verification or security audit.
Support SeerrNG development on Ko-fi .
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.
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
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.
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.
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.
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
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.
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.
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.
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.
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:
| Package | Download | SHA-256 |
|---|---|---|
| Android APK for direct install (stable project signing key) | APK | checksum |
| Android App Bundle signed with the upload key | AAB | checksum |
| iOS Simulator build (not an iPhone/iPad installable IPA) | Simulator ZIP | checksum |
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.
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.
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.
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.
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.
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:
| Mode | Path | Local proxy | Best for |
|---|---|---|---|
| compatibility (default for fresh Hardcover installs) | BookshelfNG → rreading-glasses → upstream | On, with PostgreSQL | A durable shared cache, centralized throttling, or a compatibility boundary |
| native (explicit opt-in) | BookshelfNG → Hardcover GraphQL | Off | The simplest direct Hardcover deployment |
| hosted | BookshelfNG → METADATA_URL | Off | A 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.
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.
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.
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.
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 READMEKEEP EXPLORING
Repository preview
strelov1/freehire
Open-source search engine aggregating 3.3M+ tech jobs directly from 294k+ company career pages. Zero recruiters, no reposts.
git clone https://github.com/strelov1/freehire.gitzenhostai/9drive
Virtual storage gateway pooling multiple free Google Drive accounts into a combined 60GB+ high-speed personal bucket.
git clone https://github.com/zenhostai/9drive.git
Repository screenshot
Tencent/libpag
The official rendering library for PAG (Portable Animated Graphics) files that renders After Effects animations natively across multiple platforms.
git clone https://github.com/Tencent/libpag.gitShort demos. New discoveries. Less noise in your feed.