Audiobookshelf Updates & Release Notes

Important: New authentication system

• A more secure authentication system has been added, see https://github.com/advplyr/audiobookshelf/discussions/4460 for details
• All users are required to re-login to the web client to start using the new authentication system
• The old authentication system will continue to function and be removed from the server no earlier than September 30, 2025 to allow 3rd party apps time to update

Added

• JWT authentication with refresh tokens to replace old authentication system (See #4460) (in #4444)
• API Key config page for managing configurable API Keys that act on behalf of users (See #4460) (in #4444)
• Session model for managing sessions in the new auth system (See #4460) (in #4444)
• Rate limiter for authentication endpoints (See #4460) (in #4444)
• Explicit filter for books & podcasts (only shows if user has access) #2114 by @Vito0912 in #4425

Fixed

• Scanner re-adding single-file audiobooks in folder root when they are deleted through the web ui #4459 (in #4469)
• Continue listening items not updating due to updatedAt timestamp not updating for mobile local syncs #4366 (in #4454)
• Dockerfile NUSQLITE3_PATH build arg not configurable by @HadrienPatte in #4413
• Book author secondary sort by title not respecting ignore prefixes when sorting setting #4414 (in #4417)
• Server crash when FantLab metadata provider requests time out #4410

Changed …

Note: v2.25.0 had a bug that I caught immediately so release notes were never drafted

Added

• Notifications for podcast episode check failed and disabled due to too many failed attempts #4377 by @Vito0912 in #4378
• Support env variable MAX_FAILED_EPISODE_CHECKS for podcast episode check cron job by @Vito0912 in #4370

Fixed

• Follow-up security fix for uploader pathexists check (in #4393) (See GHSA-xjqw-8829-qmm6)
• M4B encoder ignoring custom values #4359 by @Vito0912 in #4361
• M4B encoder backup file with the same name overwriting the original file (in #4361)
• Potential fix with podcast episode check cron job getting stuck #4098 by @Vito0912 in #4373
• All file attachments were not being removed from rich text editor by @Vito0912 in #4374
• API: /api/filesystem/pathexists and /api/upload not respecting user library access permissions (in #4398)
• UI/UX: Alignment issue in chapters table on audiobook tools page

Changed

• Improve podcast episode matching using Fuse.js #4382 by @JKubovy in #4383
• Audible provider now returns ISBN if available by @Vito0912 in #4394
• Podcast episode downloads now use a fallback user agent to handle some podcast servers that block requests #4401 (in #4404)
• Book library page sorting by author now uses title as the secondary sort #4380 (in #4388)
• More strings translated
  • Arabic by @UsamaFoad …

Added

• Podcast library filter "RSS Feed Open" #4335
• Arabic language option

Fixed

• Security fix for uploader pathexists check in #4342 (See GHSA-xj8h-wrw2-g829)
• Rich text editor allowing images when copy/pasted from browser in #4349
• M4b encoder bit rate preset selection not working with bit rates higher than 192k #4337
• Unable to fetch podcast RSS feed when it has episodes with an empty guid #4325
• Media progress updates will use the lastUpdate value passed into the request (for local progress sync) in #4326
• UI/UX: Descriptions with html lists causing overlapping text when expanding (iOS/Safari specific) #4348

Changed

• Series sequence does not allow spaces #4314
• Update max allowed JSON request size #4250 in #4318
• API: /api/filesystem/pathexists requires directory and folderPath in #4342
• API: Updating library item descriptions and podcast episode descriptions sanitize the HTML in #4355
• More strings translated
  • Arabic by @UsamaFoad
  • Bulgarian by @antoniy
  • Catalan by @fitojb
  • Chinese (Simplified Han script) by @springsunx @FiendFEARing
  • Croatian by @biuklija
  • Czech by @kuci-JK
  • German by @Vito0912 @schoenfeldj
  • Italian by @ilbebinonessuno
  • Slovak by @pecer
  • Slovenian by @thehijacker
  • Spanish by @fitojb
  • Ukrainian by @Maksim2005UA …

Added

• Support for searching episode titles in podcast libraries #3301 in #4293
• Support listening on unix socket #3819 by @balki in #4166

Fixed

• Docker image not including nunicode in #4299

Changed

• More strings translated
  • Arabic by @UsamaFoad
  • Catalan by @fitojb
  • Croatian by @biuklija
  • German by @cebo29
  • Russian by @renesat
  • Slovak by @pecer
  • Slovenian by @thehijacker
  • Spanish by @fitojb
  • Ukrainian by @Maksim2005UA

New Contributors

• @balki made their first contribution in https://github.com/advplyr/audiobookshelf/pull/4166

Full Changelog: https://github.com/advplyr/audiobookshelf/compare/v2.22.0...v2.23.0

Added

• Audiobook chapter lookup support for removing Audible intro/outro branding #4152 by @Vito0912 in #4226
• API: New endpoint for direct playing audio files using session ID (now preferred method see #4263) #4259 in #4263

Fixed

• Server crash when updating the "Ignore prefixes when sorting" setting #4221 in #4234
• .ignore file causing ignores outside the directory by @nschum in #4261
• Users without access to any book in a series still able to find the series in search results #3736
• UI/UX: Share audio player track bar tooltip overflowing page (now hidden on mobile) in #4241
• API: Library stats endpoint returning null instead of 0 for some stats #4251

Changed

• Audiobook m4b encoder uses smarter presets for codec, bitrate and channels #4169 #1257 in #4253
• Improve Year in Review display logic by @josh-vin in #4240
• Improve file watcher to re-scan library items when non-media file only updates are made #4245 in #4249
• Podcast episode table uses a secondary sort when sorting #4262 in #4270
• M4b encoder option is now shown for all audiobooks (previously hidden for single file m4b audiobooks) in #4274
• UI/UX: Audiobook tools page revamped in #4253
• UI/UX: Authentication config page shows "restart server" message when OIDC is enabled #4064
• API: HLS stream endpoint no longer requires user token in URL in #4266
• More strings translated
  • Catalan by @fitojb
  • Finnish by @SUPERHAMSTERI
  • German by @Azorimor …

Added

• Bulk download option when selecting multiple library items #3541 by @Vito0912 in #4133

Fixed

• Validate uploads endpoint request (See GHSA-47g3-c5hx-2q3w)
• Incorrect items count on library page for users with item restricting permissions #4163 in #4164
• Book tools page, chapter edit page and library stats page not setting the current library properly on refresh #4170
• Podcast library item size not updating when downloading episodes #4180
• Inconsistent order of multiple authors on a book #4177
• Re-scanning podcast items can result in inaccurate episode counts. in #4195
• Socket events for library item updates not respecting users item restricting permissions #4199 in #4200
• Server crash when requesting an RSS feed for a collection with no books by @Vito0912 in #4223
• UI/UX: Library item page details overflowing text for some translations #4187

Changed

• Filename sanitization normalization to NFC & debug logs for sanitization #4121
• Added support for multiple series in series & series-part meta tags (semicolon separated) #4136
• Uploader checks if a library item exists in a subdirectory before uploading #4146
• PSC chapters are now parsed from podcast feeds when downloading episodes
• Latest episodes page shows 50 latest (was 25) #3343
• .aif audio files are now supported #4211 by @Nishantsingh11 in #4212 …

Added

• Podcast episode table sorting option for filename + show filename when sorting by it #3637 by @4ch1m in #4030

Fixed

• Possible to queue multiple of the same episode for download #2672 #4036 by @nichwall in #4041
• Scanning epub not using first image for cover in some cases #4105 by @Roukanken42 in #4106
• Publish year not saving when matching with OpenLibrary #4114 by @GabrielGavrilov in #4118
• UI/UX: Whitespace in custom metadata provider inputs not being trimmed #4069
• UI/UX: RTL support on podcast episodes table rows by @mikiher in #4082

Changed

• Improved book library page performance for author sort by @mikiher in #4080
• Improved podcast latest episodes page performance #4043 by @mikiher in #4080
• Podcast page play button plays first incomplete episode in the table by @nichwall in #4035
• Playing episodes from the podcast page populates the player queue based on the order in the table by @nichwall in #4035
• Migration manager ignores non-js files #4042 in #4078
• Update OPF file parser to support OPF v3 refines meta elements #4109 in #4113
• UI/UX: Rename setting "Enable Watcher" to "Automatically scan libraries for changes" #4095
• UI/UX: Rename setting "Enable automatic backups" to "Automatic backups" #4095
• UI/UX: Search/download podcast episodes modal indicates episodes that are queued for download
• UI/UX: Update native browser confirm prompts to use our custom confirm modal …

Fixed

• Caching issue with library items page #4018 by @mikiher in #4020
• UI/UX: Long podcast author overflows in player by @smithmd in #3944
• API: Get podcast library items endpoint when not including a limit query param #4014
• API: Library delete, update and delete items with issues allowing calls from non-admin users by @Alexshch09 in #4027

Changed

• Improved scanner ignore logic #2399 #1641 by @nichwall in #4031
• Custom metadata provider requests log the url #4004 by @nichwall in #4034
• UI/UX: Removing all items with issues redirects to library page #4022 by @mikiher in #4037
• More strings translated
  • Belarusian by @i-Nosferatu-i
  • Croatian by @milotype @biuklija
  • Czech by @mickeynos
  • German by @Vito0912
  • Italian by @burghy86
  • Polish by @mraczka
  • Swedish by @Cotignac
  • Ukrainian by @Maksim2005UA

New Contributors

• @smithmd made their first contribution in https://github.com/advplyr/audiobookshelf/pull/3944
• @Alexshch09 made their first contribution in https://github.com/advplyr/audiobookshelf/pull/4027

Full Changelog: https://github.com/advplyr/audiobookshelf/compare/v2.19.4...v2.19.5

Fixed

• Podcast feeds http to https redirect not working #3142 #3658 by @sloped in #3978
• Sorting by title for book libraries not working on new databases #4003 by @mikiher in #4005

Changed

• Improve podcast library performance #3965 by @mikiher in #3996
• UI/UX: Refresh bookshelf when book title changes #3998 by @mikiher in #4008
• More strings translated
  • Bulgarian by @ivan-penchev @lembata
  • Croatian by @biuklija
  • Swedish by @Cotignac
  • Turkish by @armanckeser

New Contributors

• @sloped made their first contribution in https://github.com/advplyr/audiobookshelf/pull/3978

Full Changelog: https://github.com/advplyr/audiobookshelf/compare/v2.19.3...v2.19.4