audiobookshelf Release Notes

Last updated: Mar 20, 2026

Get this feed:

audiobookshelf Products

All audiobookshelf Release Notes (14)

  • Mar 19, 2026
    • Date parsed from source:
      Mar 19, 2026
    • First seen by Releasebot:
      Mar 20, 2026
    audiobookshelf logo

    audiobookshelf

    v2.33.1

    audiobookshelf adds a new authentication system and fixes API key handling plus HTML sanitization updates.

    Important: New authentication system was added in v2.26.0. See #4460 for details.

    Fixed

    • API Keys not respecting user enabled/disabled flag

    Changed

    • Podcast episode update endpoint sanitizes HTML for subtitle
    • Playlist & collection create/update endpoints strip HTML tags from name
    • More strings translated
      • Belarusian by @pavel-miniutka
      • German by @fabianjuelich
      • Spanish by @cyphra

    Full Changelog: v2.33.0...v2.33.1

    Original source
  • Mar 12, 2026
    • Date parsed from source:
      Mar 12, 2026
    • First seen by Releasebot:
      Mar 13, 2026
    audiobookshelf logo

    audiobookshelf

    v2.33.0

    audiobookshelf unveils a new authentication system and expanded language support, plus performance improvements and bug fixes across sessions, progress, and UI. The full changelog notes cache optimizations, safer endpoints, and refined subtitle parsing backed by many contributors.

    Important: New authentication system was added in v2.26.0. See #4460 for details.

    Added

    • Slovak language option by @belpe in #5077
    • Belarusian language option by @pavel-miniutka in #5071
    • Database indexes for discover query performance by @kevingatera in #5073

    Fixed

    • IDOR vulnerabilities in listening sessions, media progress, and bookmark endpoints #5062 by @mandreko in #5063
    • Server crash filtering by decade with collapsed series
    • Server crash on /me/progress/:libraryItemId/:episodeId? when episodeId is not passed in for a podcast library item #5058
    • Updating author name merging with same name authors in a different library #4628
    • Home page check current user from socket event when updating hide from continue listening
    • UI/UX: Match tab "click to use current value" incorrect title attribute
    • UI/UX: Aria-label for jump backward button by @KiwiHour in #4973

    Changed

    • Improved personalized shelves performance by parallelizing shelf queries and reducing search payload size by @kevingatera in #5073
    • Improved API cache invalidation for high-churn models (sessions, media progress) by @kevingatera in #5073
    • Improved subtitle parsing to account for bare colon in title by @kctdfh in #5036
    • Sanitize session DeviceInfo clientDeviceInfo fields
    • Sanitize server settings authLoginCustomMessage on save and load
    • Fix OpenAPI spec description by @openam in #5042
    • UI/UX: Display localized/styled text for selected filter by @sir-wilhelm in #4952
    • More strings translated
      • Belarusian by @pavel-miniutka
      • Catalan by @enboig
      • Chinese (Simplified Han script) by @FiendFEARing
      • Czech by @Plazec
      • Danish by @xxzp3
      • French by @dapitch666
      • German by @ShaikaJar @Maxklos @B0rax
      • Greek by @lambolighting
      • Hebrew by @enosh
      • Hungarian by @Kabika82 @ugyes
      • Japanese by @litoma
      • Lithuanian by @mantas3
      • Norwegian Bokmål by @Torstein-Eide @soteland
      • Polish by @Jarsey45
      • Portuguese (Brazil) by @lribeiro
      • Romanian by @hac3ru
      • Slovak by @goozi12345 @pecer
      • Slovenian by @thehijacker
      • Swedish by @Cotignac @karlbe
    • New Contributors
      • @KiwiHour made their first contribution in #4973
      • @openam made their first contribution in #5042
      • @belpe made their first contribution in #5077
      • @pavel-miniutka made their first contribution in #5071
      • @kctdfh made their first contribution in #5036
      • @mandreko made their first contribution in #5063
      • @kevingatera made their first contribution in #5073

    Full Changelog: v2.32.1...v2.33.0

    Original source
  • All of your release notes in one feed

    Join Releasebot and get updates from audiobookshelf and hundreds of other software products.

    Create account
  • Dec 23, 2025
    • Date parsed from source:
      Dec 23, 2025
    • First seen by Releasebot:
      Dec 24, 2025
    audiobookshelf logo

    audiobookshelf

    v2.32.1

    Important: New authentication system was added in v2.26.0. See #4460 for details.

    Fixed

    • Server crash matching with Audible provider #4931

    Updated

    • More strings translated
    • Finnish by @pHamala
    • Polish by @MarcinKlejna
    • Russian by @renesat
    • Swedish by @bittin

    Full Changelog: v2.32.0...v2.32.1

    Original source
  • Dec 21, 2025
    • Date parsed from source:
      Dec 21, 2025
    • First seen by Releasebot:
      Dec 21, 2025
    audiobookshelf logo

    audiobookshelf

    v2.32.0

    New authentication system arrives with v2.31.0, improving security and API metadata. The release also brings bug fixes for bulk matching, Debian upgrades, and duplicate handling across authors and genres, plus refreshed translations and sorted playlists.

    Important: New authentication system was added in v2.26.0. See #4460 for details.

    Fixed

    • Bulk matching books with multiple of the same new author only applies author to one book by @TN-SKYC in #4766
    • Debian package upgrades failing due to user "audiobookshelf" already exists #1617 by @Yetangitu in #4740
    • Multi-select inputs allowing duplicate new items by @votex001 in #4649
    • Audible & custom metadata providers allowing duplicate genres & tags #4634 (in #4927)

    Updated

    • API: Metadata match results return tags as an array of strings instead of a comma separated string (in #4927)

    • Playlists are sorted alphabetically in playlist modal by @sir-wilhelm in #4906

    • More strings translated

      • Arabic by @kfctatertot
      • Bulgarian by @lembata
      • Chinese (Simplified Han script) by @FiendFEARing
      • Finnish by @Napitauki @pHamala
      • German by @JBlond
      • Greek by @lambolighting
      • Hebrew by @mnavon
      • Italian by @66Bunz
      • Korean by @zardkim
      • Polish by @ahetek
      • Portuguese (Brazil) by @ljaksys
      • Slovenian by @thehijacker
      • Spanish by @kfctatertot @xlbrto

    New Contributors

    • @TN-SKYC made their first contribution in #4766
    • @votex001 made their first contribution in #4649

    Full Changelog: v2.31.0...v2.32.0

    Original source
  • Dec 1, 2025
    • Date parsed from source:
      Dec 1, 2025
    • First seen by Releasebot:
      Dec 11, 2025
    audiobookshelf logo

    audiobookshelf

    v2.31.0

    New authentication system added and a wide range of fixes and enhancements across UI, API, and localization in the v2.30 to v2.31 release window. Highlights include language options, improved error handling, and a new search/providers API.

    Added

    • Turkish & Korean language option

    Fixed

    • Chapter editor: Play button is still shown next to chapters with invalid start times #4691
    • Switching users does not refresh available libraries #4694
    • Admin users unable to close sessions for other users #4746
    • Custom metadata providers not showing in library edit modal #3820 by @mikiher in #4750
    • HLS transcoding fails for AC3/EAC3 codecs #4798 by @Vito0912 in #4808
    • UI/UX: Next/prev buttons not shown on item edit modal when opened using "Files" or "Match" context menu item #4718

    Changed

    • Increase default access & refresh token expirations. Refresh now 30 days & Access now 1 hour by @Vito0912 in #4756
    • Enable OIDC auth auto redirect via query parameter ?autoLaunch=1 on login page by @Yetangitu in #4737
    • Improve podcast RSS feed parser to handle feeds not wrapping html in CDATA #4757
    • Update "Days in a row" stat to not require today by @jamerst in #4770
    • Improved error handling for file system ensureDir by @mikiher in #4881
    • UI/UX: Rephrase library watcher setting to "Automatically watch ..." #4095 by @mikiher in #4815
    • UI/UX: Uploader shows progress indicator #895 by @Vito0912 in #4702
    • API: New GET /search/providers endpoint to fetch all metadata providers by @mikiher in #4750
    • More strings translated
      • Catalan by @celigabon
      • Chinese (Simplified Han script) by @FiendFEARing
      • Croatian by @biuklija @milotype
      • Czech by @Plazec @zendiik
      • Danish by @Andersborrits
      • Estonian by @alehandro112
      • Finnish by @pHamala @phewi
      • French by @dapitch666
      • German by @Blubberland @schoenfeldj @Vito0912 @B0rax
      • Hungarian by @ljaksys @ugyes
      • Italian by @burghy86
      • Korean by @zardkim
      • Lithuanian by @waipit
      • Polish by @pryszczoskor
      • Portuguese (Brazil) by @pmangro @nlqog @ljaksys
      • Romanian by @dinuzauri
      • Russian by @renesat
      • Slovenian by @thehijacker
      • Swedish by @3nm1 @Cotignac
      • Ukrainian by @maksim2005UKR

    New Contributors

    • @Yetangitu made their first contribution in #4737
    • @jamerst made their first contribution in #4770

    Full Changelog: v2.30.0...v2.31.0

    Original source
  • Oct 8, 2025
    • Date parsed from source:
      Oct 8, 2025
    • First seen by Releasebot:
      Dec 11, 2025
    audiobookshelf logo

    audiobookshelf

    v2.30.0

    New authentication system introduced with prior v2.26.0, plus a major update to book cover search with async streaming. The note also lists UI fixes, performance tweaks, and extensive translations, covering the full changelog for v2.29.0–v2.30.0.

    Added

    • Book cover search includes "Best" option (searches audible, google & fantlab) by @mikiher in #4716

    Fixed

    • OIDC invalid callback URL (incorrect protocol) #4609 by @Vito0912 in #4635
    • MultiSelect causing web client to become unresponsive due to duplicate keys #4634 by @nichwall in #4636
    • Podcast episodes being downloaded without an audio stream (in #4664)
    • UI/UX: Chapter editor overflowing on smaller screen sizes #4652

    Changed

    • Book cover search is now async, streams results using websockets by @mikiher in #4716
    • Decrease timeout to 10s (from 30s) on all metadata providers by @mikiher in #4716
    • UI/UX: Chapter editor does not redirect back after saving changes or deleting all chapters #4650
    • More strings translated
    • Arabic by @Salmanegr
    • Chinese (Simplified Han script) by @FiendFEARing
    • Croatian by @biuklija @milotype
    • Czech by @kuci-JK @petr-prikryl @Plazec @Losicek
    • Finnish by @pHamala
    • French by @lolly76
    • German by @Vito0912 @pjope @B0rax
    • Hungarian by @ugyes @Kabika82
    • Norwegian Bokmål by @husjon @PSchaug
    • Persian by @aghorbanmehr
    • Polish by @satanowski @ahetek
    • Portuguese (Brazil) by @jhonthan
    • Romanian by @Hnatiucb @Emdisi00
    • Russian by @GrakovNe @Devastator1979
    • Slovak by @pecer
    • Slovenian by @thehijacker
    • Swedish by @Cotignac
    • Turkish by @icutehunter @smilefate @oersen
    • Ukrainian by @maksim2005UKR

    Internal

    • Add a script to build an uncompressed windows executable #2998 by @mikiher in #4729

    Full Changelog: v2.29.0...v2.30.0

    Original source
  • Sep 11, 2025
    • Date parsed from source:
      Sep 11, 2025
    • First seen by Releasebot:
      Dec 11, 2025
    audiobookshelf logo

    audiobookshelf

    v2.29.0

    New auth system introduced with v2.26.0 alongside chapter editor tools, library improvements, podcast enhancements, and UI/UX polish. This release also fixes load issues, optimizes HLS, and expands translations across many languages.

    Important: New authentication system was added in v2.26.0. See #4460 for details.

    Added

    • Chapter editor tools/enhancements including bulk chapter import & more (see #4384) by @josh-vin in #4384
    • Book library sort options for Progress: Started and Progress: Finished #4540 by @tagmeh in #4575

    Fixed

    • Initial page load failing to load library (on token refreshes) #4567 (in #4590)
    • Library path folder browser not working on latest Windows 11 (replace wmic with powershell) #4531 by @sir-wilhelm in #4533
    • Podcast itunes id not set on podcasts created from search and podcast matching #4614
    • Book match tab last used provider saved in local storage being overriden by itunes when matching a podcast #4615
    • Server listening log for ipv6 host by @renesat in #4595
    • UI/UX: Podcast match author input not showing the current author value #4617

    Changed

    • Podcast episode download requests pass / in Accept header by @renesat in #4596
    • Podcast episode downloads always embed meta tags (previously only mp3) (in #4598)
    • Remove unnecessary token from HLS playlist files by @laxandrea in #4608
    • UI/UX: Changed book library Progress Updated sort option label to Progress: Last Updated
    • UI/UX: Replace SVG icons with material-symbols icon equivalents by @Toby222 in #4552
    • UI/UX: Remove unnecessary success toast for podcast episode removed #4606
    • More strings translated
      • Belarusian by @i-Nosferatu-i
      • Bulgarian by @jeliozver
      • Chinese (Simplified Han script) by @FiendFEARing
      • Croatian by @biuklija
      • Czech by @kuci-JK
      • Dutch by @matieke
      • German by @Vito0912 @Dalabad @Eragos @B0rax
      • Hungarian by @ugyes @Kabika82
      • Italian by @paolor72 @laxandrea
      • Russian by @renesat
      • Slovenian by @thehijacker
      • Spanish by @idojius86
      • Swedish by @Cotignac @MageSneaky
      • Vietnamese by @phamngocminhhang

    New Contributors

    • @laxandrea made their first contribution in #4608
    • @renesat made their first contribution in #4596
    • @sir-wilhelm made their first contribution in #4533
    • @tagmeh made their first contribution in #4575

    Full Changelog: v2.28.0...v2.29.0

    Original source
  • Aug 10, 2025
    • Date parsed from source:
      Aug 10, 2025
    • First seen by Releasebot:
      Dec 11, 2025
    audiobookshelf logo

    audiobookshelf

    v2.28.0

    New authentication system rolls out with v2.26.0 and ongoing improvements across v2.27 to v2.28.0 Highlights include a server CORS whitelist, crash fixes for direct play transcoding, and OIDC registration tweaks, plus extensive translation updates.

    Added

    • Server setting to allow a whitelist of CORS origins by @Vito0912 in #4557

    Fixed

    • Server crash when transcode requests are made to the direct play endpoint #4555 (in #4565)
    • OIDC auto-register still creating a user when groupclaim is invalid #4563
    • OIDC callback URL validation

    Changed

    • More strings translated
    • Belarusian by @i-Nosferatu-i
    • Chinese (Simplified Han script) by @FiendFEARing
    • Croatian by @biuklija
    • Estonian by @alehandro112
    • French by @ThoDon
    • German by @Vito0912 @numerfolt @LaurinSorgend
    • Hindi by @ashishwadekar
    • Norwegian Bokmål by @Erbros
    • Russian by @NickSkier
    • Ukrainian by @Maksim2005UA2

    Full Changelog: v2.27.0...v2.28.0

    Original source
  • Aug 2, 2025
    • Date parsed from source:
      Aug 2, 2025
    • First seen by Releasebot:
      Dec 11, 2025
    audiobookshelf logo

    audiobookshelf

    v2.27.0

    New authentication system ships in v2.26 with a wave of UX fixes, translations and accessibility tweaks. Highlights include a book library sort option, sepia epub theme, UI fixes, mobile polish and multilingual support leading into v2.27.0.

    Important: New authentication system was added in v2.26.0. See #4460 for details.

    Added

    • Book library sort option for progress last updated #1215 (in #4542)
    • Sepia theme in epub e-reader #4407 by @michaeldvinci in #4534

    Fixed

    • All e-reader devices visible to non-admin users #4529 (in #4530)
    • UI/UX: Edit chapter page lookup modal showing incorrect duration when removing branding by @chriscam85 in #4551
    • UI/UX: Cursor pointer for version in side rail by @FelixSche in #4528
    • UI/UX: Sessions table overflowing horizontally on mobile

    Changed

    • UI/UX: Localized user stats heatmap tooltip #4550
    • More strings translated
    • Belarusian by @i-Nosferatu-i
    • Chinese (Simplified Han script) by @FiendFEARing
    • Danish by @MikkelOlesen
    • Dutch by @RemcoSchrijver @Pepsicola1995
    • German by @B0rax @Vito0912 @networksecurityvodoo
    • Hebrew by @enosh
    • Hungarian by @ugyes @Kabika82
    • Russian by @GrakovNe
    • Slovenian by @thehijacker
    • Swedish by @Cotignac
    • Ukrainian by @Maksim2005UA2

    New Contributors

    • @FelixSche made their first contribution in #4528
    • @michaeldvinci made their first contribution in #4534
    • @chriscam85 made their first contribution in #4551

    Full Changelog: v2.26.3...v2.27.0

    Original source
  • Jul 23, 2025
    • Date parsed from source:
      Jul 23, 2025
    • First seen by Releasebot:
      Dec 11, 2025
    audiobookshelf logo

    audiobookshelf

    v2.26.3

    Important: New authentication system was added in v2.26.0. See #4460 for details.

    Fixed

    • Some podcast episodes always transcoding (in #4520)
    • Unable to change root user password when not set #4522 (in #4523)

    Changed

    • More strings translated
    • Chinese (Simplified Han script) by @FiendFEARing
    • German by @Dalabad
    • Russian by @Nab0y
    • Ukrainian by @Maksim2005UA2

    Full Changelog: v2.26.2...v2.26.3

    Original source
  • Jul 21, 2025
    • Date parsed from source:
      Jul 21, 2025
    • First seen by Releasebot:
      Dec 11, 2025
    audiobookshelf logo

    audiobookshelf

    v2.26.2

    Important: New authentication system was added in v2.26.0. See #4460 for details.

    Fixed

    • Web client page load causing a token refresh #4509 (in #4510)

    Changed

    • Audible match results return match confidence score, shows in match results by @mikiher in #4319
    • More strings translated
    • Chinese (Simplified Han script) by @springsunx @FiendFEARing
    • Croatian by @biuklija
    • Czech by @kuci-JK
    • Italian by @Prangel85
    • Turkish by @SerhatGulasti
    • Ukrainian by @Maksim2005UA2

    Full Changelog: v2.26.1...v2.26.2

    Original source
  • Jul 16, 2025
    • Date parsed from source:
      Jul 16, 2025
    • First seen by Releasebot:
      Dec 11, 2025
    audiobookshelf logo

    audiobookshelf

    v2.26.1

    New authentication system arrives in v2.26.0 with fixes like OIDC auto register error, API tweaks and UI improvements. Sessions endpoints now return user objects and UI shows usernames, with multilingual translations and a full changelog from v2.26.0 to 2.26.1.

    Important

    Important: New authentication system was added in v2.26.0. See #4460 for details.

    Fixed

    • OIDC error when auto registering users #4485 (in #4486)
    • ALLOW_CORS env variable not working #4497

    Changed

    • UI/UX: Localize listening time on sessions table (in #4493)
    • UI/UX: Sessions modal shows username instead of user id #4496 (in #4503)
    • UI/UX: Show deprecated warning message on legacy API token on user page (in #4503)
    • API: /api/sessions and /api/users/:id/listening-sessions endpoints always return a user object on sessions (in #4503)

    More strings translated

    • Chinese (Simplified Han script) by @FiendFEARing
    • Croatian by @biuklija
    • German by @networksecurityvodoo
    • Swedish by @Cotignac @Landrash
    • Ukrainian by @Maksim2005UA2

    Full Changelog

    Full Changelog: v2.26.0...v2.26.1

    Original source
  • Jul 12, 2025
    • Date parsed from source:
      Jul 12, 2025
    • First seen by Releasebot:
      Dec 11, 2025
    audiobookshelf logo

    audiobookshelf

    v2.26.0

    New secure authentication system released with JWT and refresh tokens. All users must re-login to start using it as the old system will be removed after Sep 30, 2025. Includes API Key management, session handling, rate limiting and several UI/UX improvements plus fixes.

    Important: New authentication system

    A more secure authentication system has been added, see #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

    • Remove TOKEN_SECRET environment variable (See #4460 for new vars) (in #4444)
    • UI/UX: Timestamps in podcast episode description are clickable to open player at time (in #4419)
    • UI/UX: Podcast episode view modal shows duration & episode feed modal shows duration & size (in #4422)
    • UI/UX: Book narrators page, narrator name links to library filtered by narrator
    • API: Update password change endpoint (/api/me/password) to return error status codes
    • Server init database cleanup removes duplicate media progress rows
    • More strings translated
    • Chinese (Simplified Han script) by @springsunx @FiendFEARing
    • Croatian by @biuklija
    • Czech by @petr-prikryl
    • Danish by @DavidMunch @Strit
    • Dutch by @matieke @DavevanIersel
    • German by @B0rax @Dalabad @Eragos @Vito0912
    • Hungarian by @Kabika82
    • Italian by @burghy86
    • Slovenian by @thehijacker
    • Ukrainian by @buzzik @Maksim2005UA2

    Internal

    • Env variable override to use experimental React client (in #4430)

    New Contributors

    • @HadrienPatte made their first contribution in #4413

    Full Changelog: v2.25.1...v2.26.0

    Original source
  • Jun 14, 2025
    • Date parsed from source:
      Jun 14, 2025
    • First seen by Releasebot:
      Dec 11, 2025
    audiobookshelf logo

    audiobookshelf

    v2.25.1

    Audible-like audiobook app releases v2.25.0 with fixes across podcast checks, file management, and catalog data. It improves episode matching, adds a safe uploader path check, a fallback user agent for downloads, and richer translations with new contributors.

    Note

    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
      • Czech by @Plazec
      • Danish by @DavidMunch
      • Dutch by @rekentek
      • German by @Sh4tterh4nd @Dalabad
      • Hungarian by @ugyes
      • Norwegian Bokmål by @anorm
      • Russian by @GrakovNe @renesat
      • Slovenian by @thehijacker
      • Ukrainian by @Maksim2005UA

    New Contributors

    • @JKubovy made their first contribution in #4383

    Full Changelog: v2.24.0...v2.25.1

    Original source

This is the end. You've seen all the release notes in this feed!

Related vendors