Skip to content

ChaptarrNG v0.9.986

Choose a tag to compare

@github-actions github-actions released this 08 Nov 20:59
· 377 commits to main since this release

0.9.978 - 2026-11-08

User-facing changes

Added

  • Bookshelf: ChaptarrNG can create and restore passphrase-encrypted portable backups in BookshelfNG's .enc format, so backup files can move between the two apps. Scheduled .zip.enc backups continue to use ChaptarrNG's mounted-secret format.
  • Bookshelf: Settings > Media Management > New Author Folders lets an administrator enable one server-wide setting to assign missing ebook and audiobook paths from their matching default roots for every new author, regardless of who adds the author. It is off by default; existing author paths and files are not changed or moved.
  • Distribution: ChaptarrNG now has a gated Launchpad source-package builder and publisher for the legacy bookshelfng Debian identity. It builds from the checksum-verified Linux x64 archive while preserving the service, environment file, and data path. Publishing remains gated by migration readiness, credentials, configured Ubuntu series, and channel acceptance; this change does not publish a package.
  • Migration: The BookshelfNG Chocolatey bridge preserves custom service arguments and data paths, keeps the provider choice, and restores the source database and application if ChaptarrNG fails its health check. The Windows migration installer is built from the matching release payload; publication requires the retirement gates.
    • Action required: Preview the migration and specify /ProviderMode if the existing provider is ambiguous.
  • Migration: ChaptarrNG now upgrades supported older BookshelfNG PostgreSQL schemas on a disposable snapshot before conversion. Preview leaves the source untouched, and successful conversion retains the original schema for rollback.
    • Action required: Preview the conversion and retain the BookshelfNG source until the new library is verified.
  • Installation: A draft Windows installer can move a BookshelfNG Readarr service to ChaptarrNG, preserving its data path and verified rollback backup. It previews before apply, checks the database, WAL, and journal for changes, and restores BookshelfNG if handoff fails. The unpublished candidate supports one SQLite database with the standard LocalService account.
  • Books: The Books index can show ebooks and audiobooks together while retaining format-specific status, monitoring, and details. The Formats view groups records only when they share a recognized work ID. Users can open or add the other format, apply bulk monitoring to both, and retry failed shelf loads.
  • Metadata: Add New can search the configured metadata server for books and authors. Catalog settings expose Metadata API and Hardcover searches with environment-backed Hardcover credentials, and metadata-server results keep each candidate's author ID when adding a book. Native Hardcover searches now include configured catalogs, while an explicitly selected Goodreads search stays on Goodreads.
  • Library: Choose a default format (audiobook, ebook, or both) for new authors, books, and series in UI settings, then override it per item. Add dialogs point to Quickstart when a selected format lacks a root folder or quality profile.
  • Integration: ChaptarrNG can send imported files to BookOrbit Book Dock with a separately configured account. Migrated BookLore URLs, credentials, and notification triggers remain unchanged.
    • Action required: Configure a separate BookOrbit account with Book Dock access.
  • Bookshelf: When enabled, Move Extra Files on Rename carries configured loose sidecars into a renamed book folder after the old folder no longer contains book media. Existing destination files are left untouched.
  • Library: ChaptarrNG can preview and move an author's registered audiobook or ebook files to a new format-specific location, including registered book sidecars resolved from the linked book's format root. A bulk workflow previews all selected authors together; destination conflicts block the move, paths that escape the author folders are rejected, and untracked files and author-wide extras stay in place.
  • Migration: ChaptarrNG adds BookshelfNG's Hardcover public-list and reading-status provider. The migration candidate also preserves supported Goodreads OAuth lists and notifications; missing or partial credentials block preview. Live Goodreads API acceptance with existing keys remains open.
  • Bookshelf: Adds opt-in support for BookshelfNG's M4B merge settings on eligible tracked audiobook downloads. ChaptarrNG preserves disc and track order and chapter titles, and falls back to the original parts if merging fails. Move mode removes consumed tracks only after a successful import; copy mode retains them. The candidate is not in v0.9.977 and still needs hosted and representative-media validation.
  • Migration: ChaptarrNG accepts raw BookshelfNG .db and legacy .xml backup uploads. It validates SQLite integrity and database lineage before staging a restore.
  • Library: Root Folder settings can preview and fill missing author root folders without moving book files. The preview reports skipped authors, rechecks settings before queueing refreshes, prevents duplicate or invalid submissions, and provides retryable feedback. When no authors are eligible, the dialog offers only Close.
  • Migration: ChaptarrNG now carries a host-side Docker helper for BookshelfNG snapshot, migration preview and apply, and restore preview and rollback. Future Linux standalone archives will include it. The helper saves a private full-appdata archive outside the source directory before each action, requires explicit provider mode for migration, and requires stopped-service confirmation before apply or restore.
    • Action required: Use the ChaptarrNG host helper for a separately backed-up BookshelfNG migration preview and confirmed handoff.
  • Bookshelf: Single-author and bulk command-line helpers now wrap ChaptarrNG’s preview-token-protected media move API. They show the server preview and require confirmation before queueing by default.
  • Bookshelf: BookshelfNG migrations can preserve native Hardcover work, author, edition, and series identities. Preview and apply use the selected provider mode, and the saved Hardcover token is carried into ChaptarrNG without exposing it in the migration report.
    • Action required: Use --provider-mode native-hardcover for native Hardcover sources and set HARDCOVER=true in ChaptarrNG.
  • Search: Add New now lets you choose between searching as you type and submitting searches manually. When you upgrade from BookshelfNG in the same browser, ChaptarrNG carries over the saved choice.
  • Search: Series rows now include an interactive series pack search. Results retain the series' books for the existing Manual Import flow, where each downloaded file can be reviewed and assigned.
  • Downloads: Interactive search can adopt a matching torrent already in the selected download client. ChaptarrNG tracks the existing item and imports its files when the download completes, without starting another download.
  • Bookshelf: The ChaptarrNG command-line helper can queue a match retry across all unmapped audiobook and ebook files and optionally wait for the command result. ChaptarrNG also continues to accept the BookshelfNG RetryUnmappedFiles API command name and routes it to the all-format match retry.
  • Bookshelf: An empty Bookshelf view now offers a direct link to add the first author or book.
  • Quickstart: Quickstart now guides ebook and audiobook setup through format-specific roots, indexers, and download clients, then reviews what is configured, skipped, failed, or still needed. Optional connections appear for selected or already configured library formats, configured connections stay visible when this session's scope is narrower, and existing roots stay unchanged.
  • Library: Book details now show both ebook and audiobook actions with clear labels. Open a same-work record in the other format, or add the missing format from the current book without searching again. The add modal keeps the existing author and work identity and uses the normal format-specific setup checks.
  • Seerrng: ChaptarrNG book details now has an Editions and Narrations tab listing known editions, narrators, production, duration, abridgement, language, publisher, and selected or owned status. Details the metadata does not state appear as not provided, never guessed. SeerrNG can also use the edition catalog and series narration APIs to offer narration choices and a second performance alongside the first.
  • Metadata: ChaptarrNG can search eight optional catalogs alongside its primary source. Provider IDs remain catalog-qualified, API keys are write-only, and field preferences use matching evidence. This feature remains unpublished during the BookshelfNG retirement freeze.
    • Action required: Enable supplemental catalogs and choose a source for selected metadata fields in Settings > Metadata.
  • Import Matching: Unmapped-file retries search enabled catalogs after local and V5 matching fail. Exact ISBN, ASIN, provider IDs, or normalized title and author can create a pending-author import when one work matches. Ambiguous files stay unmatched; catalog search never attaches them directly.
    • Action required: Review pending-author suggestions created when unmapped files match one exact catalog work.

Changed

  • Distribution: ChaptarrNG stable releases now place :main, :master, :latest, and :stable under the same multi-architecture image digest in GHCR and Docker Hub. The Unraid template continues to follow :latest.
  • Authentication: ChaptarrNG OIDC guidance now documents provider setup, callback and proxy paths, admission policy, configuration precedence, recovery, and troubleshooting.
  • Distribution: When all retirement gates are enabled, stable releases now attach checksum-verified AppImage and Flatpak candidates plus Cloudron, Co-op Cloud, and catalog handoff sources pinned to the compatibility-image digest. Compatibility image tags and attestations also wait for all gates.
  • Distribution: The unpublished StartOS candidate uses SDK 3.1.0 and requires StartOS 0.4.0.2 or newer. Its external package and device handoff remain pending.
    • Action required: Update StartOS to 0.4.0.2 or newer before installing the BookshelfNG-compatible candidate.
  • Localization: Language settings now offer 37 locale choices with regional fallbacks, right-to-left layout support, and clearer English fallback for untranslated labels.
  • Localization: The language selector shows native and English names and offers only catalogs containing translated UI text, including variants that inherit a translated parent. Existing saved choices remain visible for safe migration. Arabic retains language metadata and field-level direction handling, while shared layouts remain left-to-right pending full RTL acceptance.
  • Library: Author profile controls now clarify that root-folder defaults are copied to the author when applied. Apply them again after changing a root's defaults to update an existing author.
  • Migration: During conversion, ChaptarrNG retains BookshelfNG's numeric import-match setting and maps it to the closest matching mode if none is set: 50–66 Aggressive, 67–82 Balanced, 83–99 Strict. Invalid values stop conversion. This is an approximate policy mapping, not equivalent match behavior.
  • Migration: The unmapped-file retry helper accepts the existing BOOKSHELF_URL and BOOKSHELF_API_KEY environment variables during migration. CHAPTARR_URL and CHAPTARR_API_KEY take precedence when both are set.
  • Packaging: BookshelfNG-compatible Docker targets now advertise their legacy 8787 container port in image metadata. Standard ChaptarrNG images continue to advertise 8789.
  • Distribution: The Co-op Cloud BookshelfNG handoff candidate now backs up its retained volumes and serializes migration to one application instance. Its Swarm update pauses when health validation fails; the external recipe and installed channel remain unpublished.
  • Packaging: BookshelfNG Docker compatibility aliases now keep port 8787 on fresh installs while preserving saved ports and explicit port settings.
  • Migration: Legacy Readarr__... and Audioarr__... environment values fill unset Chaptarr settings, while explicit Chaptarr values win. Metadata URLs, the optional Playwright browser path, custom server ports, and URL-base health checks carry forward without changing the selected primary metadata provider.
  • Distribution: BookshelfNG-identity AppImage and Flatpak candidates now preserve split audiobook and ebook paths under their shared root. Synthetic rehearsals passed same-channel update, migration, path preservation, and rollback. These unsigned candidates remain unpublished pending normal release and channel gates.
  • Bookshelf: ChaptarrNG now preserves BookshelfNG's Required MyAnonamouse freeleech wedge setting. Eligible downloads request the wedge, and a failed wedge request marks the release unavailable instead of retrying without it.
  • Packaging: The production Docker image adds a /init launcher for existing StartOS service wrappers.
  • Updates: Fresh standalone installs and migrated BookshelfNG databases use checksum-verified ChaptarrNG GitHub releases unless another source was selected. Package-managed installs retain their package-manager route. Existing BookshelfNG standalone users still need one supported package, installer, or archive handoff before in-app updates can continue.
  • Integration: Hardcover list settings now show when account status is loading, connected, or unavailable. If Chaptarr cannot check the connection, retry the check before changing the saved account.
  • Integration: Import List preview and history errors now show available API details and offer a clear retry action. Closing a preview cancels stale results and clears its loading state when you reopen the history.
  • Quickstart: Quickstart now asks whether each root stores ebooks, audiobooks, or both, guides missing indexer and download-client setup, and summarizes saved formats, roots, acquisition services, and optional connections.
  • Seerrng: Edition catalog responses now use each Readarr facade's provider ID dialect, proxied cover URLs, and tracked media files for ownership state, so SeerrNG can present edition choices consistently across provider routes.

Fixed

  • Import: Successful multi-part M4B merges now remove consumed source tracks in Move mode while preserving them in Copy mode.
  • Bookshelf: BookshelfNG database conversion keeps its configured minimum match percentage active for candidate acceptance. When BookshelfNG used its unsaved default, ChaptarrNG preserves the 70% default; fresh ChaptarrNG installs keep their current matcher.
  • Authentication: Breaking: ChaptarrNG now always requires the provider to affirm email_verified=true for OIDC sign-in. The legacy OidcRequireEmailVerified=false setting no longer disables this check. Providers must return a verified email claim.
    • Action required: Ensure the OIDC provider returns a verified email claim before upgrading.
  • Library: The disk-scan setting now creates missing author folders and applies configured permissions, while the ebook-folder setting creates the configured ebook path. Import matching strips _UNPACK_ and _FAILED_ markers from derived names. Complete discography releases are accepted; incomplete ones remain filtered.
  • Ci: The Semgrep scan now receives the shared runner's proxy and trusted certificate bundle so it can fetch community rules on the isolated runner.
  • Bookshelf: When BookshelfNG compatibility is enabled, audiobook candidates use the legacy quality, custom-format, protocol, indexer, peer, book-count, age, and rounded-size priority. Fresh installs and mixed audiobook/ebook comparisons keep ChaptarrNG's ranking.
    • Action required: Migrated installs retain BookshelfNG's audiobook release ranking.
  • Migration: Routine matching now searches the configured catalog after local and V5 misses, using identifiers, author/title, title, a single-file filename fallback, then author-only search. Search stops at the first tier with results. Only one exact media type and stable author/work identity produces a reviewable suggestion; scoped imports cannot broaden.
  • Migration: Converted BookshelfNG installs retain hard release-term and quality-profile rejections, plus cutoff and upgrade checks during interactive searches. Fresh ChaptarrNG installs keep their existing bypassable profile filters.
  • Import: Unmapped files with a successful catalog search are no longer searched again on every unchanged scan. ChaptarrNG preserves this state when migrating from BookshelfNG, retries after a failed provider search or changed file, and clears it when a file is linked.
  • Bookshelf: Readarr-compatible book statistics now report ebook and audiobook file counts and disk usage separately, while keeping aggregate values for older integrations.
  • Bookshelf: Migrated BookshelfNG installations now keep the same four-connection cap and five-minute connection renewal for OIDC requests, while preserving ChaptarrNG's configured proxy and certificate handling.
  • Media: Audiobook conversion retries now stage each attempt separately and reuse only validated outputs. A file retained after a converter failure is kept for inspection and is not imported automatically.
  • Windows Service: Windows service startup now uses the executable directory as its content root, avoiding reliance on the service process working directory for application files.
  • Installation: Windows service installation now keeps an explicitly selected data directory, so a migrated BookshelfNG database stays attached after service registration.
  • Migration: The Windows migration installer keeps the existing Readarr service available for rollback until ChaptarrNG passes its health check. It records and restores the prior service startup mode and running state, and removes the disabled Readarr registration after the installer closes. Restore can recreate that registration if deferred cleanup already removed it.
  • Calibre: Calibre imports now treat its e language tag as English.
  • Metadata: Changing an author's audiobook or ebook metadata profile now refreshes metadata for that author.
  • Migration: BookshelfNG migrations now preserve source monitoring for works with no selected edition. Monitored works stay monitored in both audiobook and ebook catalogs; unmonitored works remain unmonitored. Use the media map to choose one format when needed.
  • Migration: Converted BookshelfNG libraries now retain source author, book, edition, and file IDs in a durable map. Format-scoped reads and legacy monitoring resolve split audiobook and ebook rows, and clients can fetch mappings through /api/v1/bookshelf/legacy-identities. The bounded, read-only identity lookup is also available to the restricted SeerrNG service key.
  • Distribution: Source-built Docker images now include the BookshelfNG compatibility defaults file required by the entrypoint, so freshly built images start normally.
    • Action required: Rebuild source-built Docker images from the updated ChaptarrNG source.
  • Migration: Startup path repair preserves separate audiobook and ebook directories when both media types use one shared root that is also the author's configured path.
  • Bookshelf: SeerrNG's Readarr API now resolves migrated BookshelfNG book IDs to the selected ebook or audiobook, including individual book and book-file lookups.
  • Api: ChaptarrNG preserves BookshelfNG v1 fields, embedded-book payloads, enum values, and queue-state names. Legacy release searches return arrays; interactive search uses /api/v1/release/search and migrated IDs search both formats. OpenAPI documents encrypted backup passphrases, downloads, restores, and author/book creation responses.
  • Bookshelf: BookshelfNG migration now carries the built-in Readarr import list into ChaptarrNG, preserving its saved endpoint, API key, profile and tag filters, and root-folder selection so you can keep using the same remote library after conversion.
  • Diagnostics: ChaptarrNG startup logs now include build/runtime and HTTP binding details and report whether the packaged UI entry point exists. Existing BookshelfNG image metadata environment values remain supported, with line breaks sanitized before logging.
  • Ci: Eligible Linux validation gains staged hosted-first routing with a JIT retry path. Superseded security scans are cancelled. Hosted-first routing remains disabled until the updated runner broker is deployed and the operator enables NG_HOSTED_FIRST; platform-specific and pull-request runner boundaries remain enforced.
  • Localization: Narrator settings and language-code guidance now use clearer wording in 12 interface languages, and several duration and bundled-title messages display the intended values.
  • Activity: Blocklist and Ignored Downloads now show list-load errors with Retry controls that reload the current list.
  • Search: Add New now announces provider search failures to assistive technology and shows a Retry button when search-as-you-type is enabled, so a failed lookup can be repeated without changing the query.
  • Import: Audiobook downloads no longer stall with "could not verify the expected edition" when the files match another listing of the same narration, such as an Audible or Goodreads copy of the grabbed edition.
  • Library: Author images remain available when a resized rendition is missing or empty. ChaptarrNG serves the retained original, including on FreeBSD where native cover resizing is unavailable.
  • Metadata: Adding a book refreshes author metadata only when the saved record is due and still rescans that author's folders for existing files.
  • Search: Automatic searches, including those started by SeerrNG requests, now retry without an Audible-style ", Book N" suffix when nothing else is found, as interactive searches already did.
  • Books: Paged Books keeps mass-search confirmation open until matching book IDs load and the search is queued. Failures in ID lookup, search, Select All, bulk Update, and RSS Sync include retry actions; retries reuse the same IDs, records, and format. Changing the filter or format cancels an unstarted search. Individual author and book refresh/search failures now show an error notification.
  • Books: Saving a book that has more than one monitored edition, for example after a request added a second one, no longer fails with "Sequence contains more than one matching element".
  • Migration: ChaptarrNG can restore a supported BookshelfNG database from a legacy ZIP backup. It validates and stages the database, then normal startup converts it and keeps the original BookshelfNG database as the rollback source. The source archive is left untouched.
  • Downloads: Direct Download catalog searches and detail-page link resolution now support KEPUB, MOBI, and AZW3 ebooks alongside EPUB and PDF results. Releases also carry the standard Books/Ebook category used by media classification and search ranking.
  • Downloads: Direct Download settings now accept legacy URL arrays and the current ordered, multiline format, preserving existing source order and API keys during upgrades and migration.
  • Library: Book details now show related-format lookup progress and offer retry and refresh guidance when catalog IDs are missing. The Both view explains why records without a shared work ID remain separate. Unmapped Files reports load failures, offers retry, disables bulk actions until loading succeeds, and provides accessible row controls.
  • Migration: Matching BookshelfNG provider contracts and settings are retained, including MyAnonAMouse, Hardcover, and Goodreads OAuth providers. Missing or partial OAuth credentials and unknown fields block preview without printing values. Existing Goodreads tokens still need live API acceptance.
  • Bookshelf: Refresh, cover-download, and supported metadata commands from existing clients now resolve migrated BookshelfNG IDs across split ebook and audiobook records, while format-scoped clients stay within their requested format.
  • Bookshelf: Book searches from existing clients now resolve migrated BookshelfNG IDs to the correct ebook or audiobook records, including both formats when the request is unscoped.
  • Bookshelf: PostgreSQL BookshelfNG conversion now adds the edition subtitle column to the active staging schema even when another schema already has a column with that name.
    • Action required: Preview and apply PostgreSQL BookshelfNG migrations in an isolated schema.
  • Bookshelf: BookshelfNG migration now requires explicit Hardcover or Goodreads provider mode for bare numeric IDs. Legacy tags resolve to the same standard ChaptarrNG image; migration receives mode from preserved channel configuration or an explicit operator choice and fails closed when it is unavailable.
    • Action required: Set HARDCOVER=true or HARDCOVER=false when migrating bare numeric provider IDs.
  • Downloads: When qBittorrent reports HTTP 409 because a torrent is already present, ChaptarrNG now checks for the matching hash in its configured categories and continues with the existing download. Torrents outside those categories remain rejected.
  • Library: Author profile controls mark missing root-folder defaults and disable reset, protecting explicit profiles. Bookshelf reports monitoring failures and keeps selections for retry. Desktop book cards retry failed overviews; small screens skip hidden requests. Edition, narrator, and delete views ignore stale responses. Setup clarifies BookLore and BookOrbit use separate URLs and logins.
  • Bookshelf: Download clients retain BookshelfNG's shared legacy category as a fallback when an audiobook or ebook category is left blank, including queue lookup, validation, and post-import handling.
  • Migration: Download clients created through the BookshelfNG compatibility API retain the original category and tag defaults. Existing client settings and native ChaptarrNG templates are preserved.
  • Migration: ChaptarrNG now uses a migrated BookshelfNG BookImportMinimumMatchPercent value in its fuzzy RSS-title fallback. The separate ChaptarrNG match mode still governs strictness-based matching and uses its own release and import-scoring behavior.
  • Bookshelf: Goodreads series import lists now fetch every page, so long series are not cut off after the first page. Configured import limits still apply across pages.
  • Migration: BookshelfNG and Readarr compatibility clients receive the original indexer flag names, including Halfleech and DoubleUpload. Native ChaptarrNG requests keep the descriptive display labels.
  • Bookshelf: Converted BookshelfNG installs now use the legacy metadata fields and identifier rules when scoring local books for a match. Audiobook performer credits are kept separate from explicit narrator credits, matching BookshelfNG's tag handling. Fresh ChaptarrNG installs keep their current matching behavior.
  • Migration: The BookshelfNG compatibility API preserves the original MAM creation defaults: disabled indexer, All search, and series searching off. Saved indexers and native ChaptarrNG templates retain their settings.
  • Migration: Migration retains BookshelfNG's effective download-client categories, tags and credentials, MAM search settings, and Plex connection protocol when a saved configuration omits those values. Explicit saved values, including empty or null values, remain unchanged. New native configurations retain ChaptarrNG defaults.
  • Migration: Migrated BookshelfNG Plex notifications honor the existing global Update Library switch and expose it in migrated native settings as well as the compatibility API. Native ChaptarrNG installations continue to use their notification event controls.
  • Migration: Migrated BookshelfNG clients now receive the original application base path in system status. The unchanged API address no longer advertises an extra /api prefix.
  • Packaging: The standard ChaptarrNG image advertises its fresh-install port 8789. Legacy BookshelfNG package adapters use that same image digest, preserve their service port, and detect legacy SQLite or PostgreSQL sources for supervised migration; no second compatibility image is built.
  • Updates: GitHub-based update checks now use the configured repository and default to Snapetech's ChaptarrNG repository.
  • Conversion: Detached audiobook conversions now retry after temporary scheduler or SQLite numeric-type errors instead of remaining queued until restart. Provider-supplied chapter data is preserved on filesystems that cannot create symbolic links by staging copies when space permits.
  • Settings: Conversion settings now show server error details and offer Retry when their initial settings request fails.
  • Library: Single-author rescans now ignore evidence inside excluded subfolders, such as download-client seed directories, instead of scanning those files as books.
  • Bookshelf: Editing an author from a book row now opens the matching audiobook or ebook settings in the author editor.
  • Books: Adding a book already tracked by an author now reuses the requested local edition without creating a duplicate and asks you to choose when distinct local records match. Numeric Hardcover and Goodreads IDs on Readarr-compatible search routes now resolve as provider IDs.
  • Bookshelf: ChaptarrNG now accepts BookshelfNG SQLite databases that still use the historical Blacklist table name. The source is upgraded on a temporary copy, and the untouched database remains available for rollback.
  • Migration: When a migrated installation has authentication configured but no local user account, ChaptarrNG now opens its first-run account setup instead of leaving the UI behind unusable credentials. The existing authentication mode is preserved when a user already exists.
    • Action required: Review first-run authentication after migration.
  • Compatibility: Production frontend bundles now retain compatibility polyfills so missing string helpers do not break the app.
  • Search: Interactive release search now shows provider error details and an accessible Retry action. Retrying repeats the current book or series search with its existing format and filters.
  • Library: Calendar, Wanted, author history, Edit Book editions, book-file details and quality loading, and backup lists now show load errors with Retry controls that reuse the current context. Quality changes remain disabled while the quality-profile request has failed.
  • Localization: Translations across twelve languages now use clearer, more consistent wording for settings, books, imports, errors, and status labels. Product names, technical identifiers, and release revision markers remain intact.
  • Localization: Provider settings, server errors, import progress, saved failure details, and outgoing notification text now follow the selected interface language. Changing languages also refreshes cached provider labels and Home Assistant display names while preserving configuration and protocol values.
  • Import: Manual Import and File Browser failures now announce the available error details and provide Retry actions. Manual Import hides stale file rows and disables submission until the preview reloads successfully.
  • Import: Manual Import pickers distinguish an empty library from unmatched filters, offer Clear and Retry actions, and hide stale book results while loading. Edition and quality selectors retain their title and Cancel control after failures, offer Retry, and prevent submission when no quality is available.
  • Library: Organize, retag, and convert previews now show available error details and offer Retry when their preview request fails.
  • Library: Narrator discovery failures now announce the error and offer Retry. While a retry is loading, the old error and Retry action are hidden so the result state stays clear.
  • Import: Audiobooks requested for a specific narrator, including a second narration of a book you already have, now import when the files carry no narrator tag but their length matches the requested recording and no other narration of the book comes as close. Files that name a different narrator are still rejected. The pinned edition's title also matches without an Audible-style ", Book N" suffix.
  • Quickstart: Guided setup now keeps expanded section headings visible while scrolling to each step.
  • Startup: The startup error page now identifies failed setup data, shows available API errors, and retries failed requests. Unsupported browser storage remains explanatory without a misleading retry action.

Security

  • Authentication: ChaptarrNG now validates OIDC callback responses with strict size limits and explicit verified-email admission, and displays local provider branding and official setup links.
  • Bookshelf: The paged Bookshelf API now defaults to 50 records, sorts by stored title, and includes each book's author and links. OIDC requests reject private or reserved targets unless the existing private-issuer setting is enabled, while retaining configured proxy and certificate handling.
    • Action required: Set BOOKSHELF_OIDC_ALLOW_PRIVATE_ISSUER=true when using a private OIDC issuer.
  • Authentication: Query API keys stay enabled by default; set CHAPTARR__AUTH__ALLOWAPIKEYQUERY=false to block them. BOOKSHELF_ALLOW_API_KEY_QUERY and BOOKSHELF_SEERRNG_API_KEY remain supported. Restricted SeerrNG keys cannot read configuration or health routes, and file/history reads must target one book. Header and SignalR authentication are unchanged.
  • Dependencies: Cover resizing now uses SkiaSharp, and PDF metadata extraction uses the .NET 10-compatible, MIT-licensed PDFsharp 6.2.4 instead of PdfSharpCore. Neither path depends on ImageSharp, so source and package builds no longer require the Six Labors build license or include ImageSharp's transitive dependency. Resized JPEG, PNG, JFIF, and WebP covers retain their requested format.
  • Http: The generated UI now rejects bundled JavaScript and stylesheet URLs that resolve to another origin. Same-origin relative and absolute asset URLs continue to work.
  • Downloads: Direct downloads now validate every redirect before following it, blocking local and private-network destinations. Redirect response bodies are discarded so they cannot be staged as book files.
  • Http: Breaking: ChaptarrNG now trusts forwarded headers only from configured proxies, disables cross-origin access until origins are allowed, and limits API traffic and request bodies. The backup restore upload keeps its separate 1 GiB limit.
    • Action required: Configure trusted proxy addresses and allowed origins when using forwarded headers or cross-origin browser clients.
  • Authentication: Keep BookshelfNG OIDC environment settings working after switching to ChaptarrNG. Sign-in is denied unless an allow-list or explicit verified-user access is configured.

Complete changelog

The complete generated changelog is attached to this release as chaptarrng-v0.9.986-full-changelog.md.