Skip to content

Librarr 1.2.1-beta

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 04 Aug 00:46

The 1.2.x line. Full detail in CHANGELOG.md.

Highlights

  • Per-format quality profiles. An author can carry a second profile that applies only to audiobooks, with its own ranking and cutoff — so an EPUB and an M4B of the same book no longer compete for one slot. Leave it unset and nothing changes.
  • A root-folder audiobook profile default. New authors created in that root folder inherit it, including authors created automatically when files land for someone not yet in the library. Schema migration 047.
  • Windows installers. win-x64 and win-x86 installers targeting %ProgramData%\Librarr, alongside the portable zips. First Windows artifacts the fork has shipped.
  • Work counts in Add Author search. Open Library carries several records for most well-known names; searching "Tolkien" now distinguishes the one with 355 works from the one with 1.
  • Crash reporting is off by default. Inherited builds hard-coded upstream's sentry.servarr.com DSNs with analytics defaulting on, so installs were reporting exceptions into an archived project's infrastructure. Sentry is now registered only if you set LIBRARR_SENTRY_DSN to a DSN you control. If you relied on AnalyticsEnabled, read the changelog entry before upgrading.
  • First .NET 10 release. The migration landed after v1.1.0-beta was tagged, so this is the first build to actually ship on it.

Why 1.2.1 and not 1.2.0

1.2.0-beta's downloads were built framework-dependent and would not have started without a separate .NET 10 install. .NET 7 dropped the rule that naming a runtime implies a self-contained build, and nothing here set it explicitly, so the .NET 10 migration cut every archive from ~97 MB to ~25 MB with no runtime inside. Tests, builds and the end-to-end smoke all passed, because CI machines already have .NET installed.

That draft was deleted unpublished with zero downloads, and the release pipeline now refuses to package a build whose output has no runtime in it. The 1.2.0-beta Docker images were never affected — the image opts out of self-contained deliberately, since its aspnet:10.0-alpine base already carries the runtime — and remain available.

Installing

Verify downloads against SHA256SUMS before installing. Upgrading from Readarr: see docs/migrating-from-readarr.md.

Windows users have two options: Librarr.1.2.1-beta.win-x64-installer.exe installs to %ProgramData%\Librarr and can register the Windows service for you, or the win-x64 / win-x86 zips are a portable build — unzip and run Readarr.exe (tray) or Readarr.Console.exe.

The Windows binaries are not code-signed, so SmartScreen will warn on first run — choose "More info" then "Run anyway", or verify the checksum above instead.

Docker: rorqualx/librarr:1.2.1-beta, or :beta to track the beta line.