Skip to content

Release history

shelfmark releases

Self-hosted web interface for searching and downloading books and audiobooks from multiple sources

All releases

12 shown

Review required
v1.3.0 Breaking risk
Auth RBAC Dependencies

urllib3 CVE + security hardening

v1.2.3 Bugfix

Fixed permission errors causing shutdowns on first start after upgrading from 1.2.2 on Unraid.

Full changelog

This release fixes an issue for Unraid installs receiving wrong permissions and shutting down on the first start after updating to 1.2.2.

v1.2.2 Breaking risk
⚠ Upgrade required
  • If using non-root mode, explicitly set Docker user or Kubernetes `runAsUser/Group` to 1000:1000
  • Ensure output folders have appropriate permissions as automatic checks are removed
Breaking changes
  • Removed user folder permission check/correction logic; users must now manually ensure correct permissions.
Notable features
  • Newznab indexer can be configured directly as a release source
  • PrimaryTitle field added with live preview and custom field picker in template editor
  • Non-root support via explicit Docker user `1000:1000` or Kubernetes `runAsNonRoot/runAsUser/Group`
Full changelog

New

  • Newznab - New release source: Configure a newznab indexer directly (#867 by @blades)
  • PrimaryTitle field + path template improvements — new field for renaming templates, plus live preview and custom field picker in the template editor (#908)
  • Non-root support - Installs with user: "1000:1000” will now run as non-root. Note: This does not impact those with just PUID/PGID as 1000:1000, the docker user must be explicitly set too. (#871)
  • Kubernetes users can use runAsNonRoot and runAsUser/Group at 1000:1000 to run as non-root. (#871)
  • User folder permission checks / corrections removed and replaced by “test destination” button in settings. Users are responsible for ensuring output folders have correct permissions. (#871)
  • Combined search improvements - Now continue a combined search when one option is unfulfilled, and deselect previously chosen releases.
  • Direct source refactoring - Decoupled the direct source from the core of the app. It can now be disabled, and users must supply working mirror URLs to use going forward. Existing users updating will keep their existing mirror configs.

Fixes

  • Moved Shelfmark runtime from /app to /home. Fixes internal bypasser issues with newer Chromium release. (#919)
  • Temp filename length capped to avoid OS limits (#912)
  • OIDC discovery URL no longer has trailing slash stripped (#887)
  • Fixed JSON script blocking behavior (#862)
  • Fixed orchestrator timeout and exception handling (#832)
  • Fixed env variable config lookup in various places (#817)
  • Retry states now persist across restarts (#817)
  • Prowlarr downloads now offer retries (#817)
  • Fixed seedtime parsing for prowlarr release source (#805)

Misc / Tooling

  • Large tooling update
    • Backend: Added uv, ruff, basedpyright, vulture, pytest-xdist, prek, pytest-cov.
    • Frontend: Added oxlint, oxfmt, vitest, knip
  • Major lint / typecheck / formatting rewrites to improve code quality
v1.2.1 New feature
Security fixes
  • Blocked SSRF in image cover proxy
  • Sanitized settings tab names to prevent path traversal
Notable features
  • Combined Book + Audiobook Downloads
  • Split release source selection by content type
  • Torrent removal option
v1.2.0 New feature
Notable features
  • Redesigned search tools
  • Hardcover list integration
  • Manual search mode
v1.1.2 New feature
Notable features
  • SSL certificate validation setting
  • OIDC auto-redirect option
  • HIDE_LOCAL_AUTH environment variable
v1.1.1 New feature
Notable features
  • Multi-user request system
  • OIDC authentication
  • Apprise notifications
v1.0.4 New feature
Notable features
  • Customizable AA mirror list
  • Rich search formatting for indexers
  • M4A audiobook support
v1.0.3 Bugfix

Reverted Chromium and SeleniumBase dependencies to 1.0.1 versions to fix bypass failures with slow download sources.

v1.0.2 New feature
Notable features
  • Booklore upload support
  • rTorrent download client support
  • Reverse proxy authentication
v1.0.1 Bug fix
Notable features
  • Onboarding UI for new and existing users
  • NO_PROXY support with wildcard patterns
  • IRC non-TLS connections
v1.0.0 New feature
Notable features
  • Prowlarr integration for torrent/NZB downloads
  • IRC/XDCC support
  • Full audiobook download support

Beta — feedback welcome: [email protected]