Audiobookshelf
Audiobook and podcast server
advplyr



Features:
- Fully open-source, including the android & iOS app (in beta)
- Stream all audio formats on the fly
- Search and add podcasts to download episodes w/ auto-download
- Multi-user support w/ custom permissions
- Keeps progress per user and syncs across devices
- Auto-detects library updates, no need to re-scan
- Upload books and podcasts w/ bulk upload drag and drop folders
- Backup your metadata + automated daily backups
- Progressive Web App (PWA)
- Chromecast support on the web app and android app
- Fetch metadata and cover art from several sources
- Chapter editor and chapter lookup (using Audnexus API)
- Merge your audio files into a single m4b
- Embed metadata and cover image into your audio files (using Tone)
- Basic ebook support and e-reader (experimental)
Android App (beta)
- Try it out on the Google Play Store
iOS App (early beta)
- Available using Test Flight: https://testflight.apple.com/join/wiic7QIW
New features and improvements:
- Added "Best" option for book cover search (searches audible, google & fantlab)
- Book cover search is now async and streams results using websockets
- Decreased timeout to 10s on all metadata providers
Bug fixes:
- Fixed OIDC invalid callback URL issue
- Fixed MultiSelect causing web client to become unresponsive
- Fixed podcast episodes being downloaded without an audio stream
- Fixed chapter editor overflowing on smaller screen sizes
UI/UX improvements:
- Chapter editor no longer redirects back after saving changes or deleting all chapters
- Various translation updates for multiple languages
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
New features and improvements:
- Added chapter editor tools and enhancements including bulk chapter import
- Added book library sort options for "Progress: Started" and "Progress: Finished"
- Improved podcast episode matching and downloads
Bug fixes:
- Fixed initial page load failing to load library on token refreshes
- Fixed library path folder browser not working on latest Windows 11
- Fixed various podcast-related issues including episode downloads and matching
UI/UX improvements:
- Updated icons and labels for better clarity
- Enhanced accessibility for screen readers
- Improved podcast page functionality
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
⚠️ Important: New authentication system was added in v2.26.0. 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 until September 30, 2025.
New features and improvements:
- Added server setting to allow a whitelist of CORS origins
Bug fixes:
- Fixed server crash when transcode requests are made to the direct play endpoint
- Fixed OIDC auto-register still creating a user when groupclaim is invalid
- Fixed OIDC callback URL validation
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
⚠️ Important: New authentication system was added in v2.26.0. 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 until September 30, 2025.
New features and improvements:
- Added book library sort option for progress last updated
- Added sepia theme in epub e-reader
- Improved podcast episode matching
- Enhanced M4B encoder with better backup file handling
Bug fixes:
- Fixed some podcast episodes always transcoding
- Fixed unable to change root user password when not set
- Fixed issues with e-reader devices visibility and chapter editing
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
⚠️ Important: New authentication system was added in v2.26.0. 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 until September 30, 2025.
Bug fixes:
- Fixed some podcast episodes always transcoding
- Fixed unable to change root user password when not set
- Language improvements
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
⚠️ Important: New authentication system was added in v2.26.0. 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 until September 30, 2025.
New features and improvements:
- Improved podcast episode matching using Fuse.js
- Enhanced M4B encoder with better backup file handling
- Improved book library sorting with secondary sort by title
- Localized listening time on sessions table
- Sessions modal now shows username instead of user id
Bug fixes:
- Fixed web client page load causing a token refresh
- Fixed OIDC error when auto registering users
- Fixed ALLOW_CORS environment variable not working
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
⚠️ Important: New authentication system was added in v2.26.0. 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 until September 30, 2025.
New features and improvements:
- Localized listening time on sessions table
- Sessions modal now shows username instead of user id
- Deprecated warning message for legacy API token on user page
- More strings translated in various languages
Bug fixes:
- Fixed OIDC error when auto registering users
- Fixed ALLOW_CORS environment variable not working
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
⚠️ Important: New authentication system
A more secure authentication system has been added. 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 until September 30, 2025.
New features and improvements:
- JWT authentication with refresh tokens
- API Key config page for managing configurable API Keys
- Rate limiter for authentication endpoints
- Explicit filter for books & podcasts
- Improved podcast episode matching using Fuse.js
- Enhanced M4B encoder with better backup file handling
- Improved book library sorting with secondary sort by title
Bug fixes:
- Fixed scanner re-adding single-file audiobooks when deleted through web UI
- Fixed continue listening items not updating for mobile local syncs
- Fixed server crash when FantLab metadata provider requests time out
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
New features and improvements:
- Added notifications for podcast episode check failures
- Support for custom timeout settings for podcast downloads
- Improved podcast episode matching using fuzzy search
- Enhanced M4B encoder with better backup file handling
- Better fallback handling for podcast episode downloads
- Improved book library sorting with secondary sort by title
- Updated Audible provider to return ISBN when available
Bug fixes:
- Fixed M4B encoder ignoring custom values
- Fixed potential issues with podcast episode check getting stuck
- Fixed rich text editor file attachment removal
- Fixed alignment issues in chapters table
- Security fix for the pathexist check
- Various translation updates for multiple languages
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
New features and improvements:
- Added podcast library filter for RSS Feed Open
- Added Arabic language option
- Improved security for uploader pathexists check
- Enhanced rich text editor functionality
- Updated M4b encoder bit rate preset selection
- Various translation updates for multiple languages
- Bug fixes and performance improvements
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
New features and improvements:
- Added support for searching episode titles in podcast libraries
- Improved audiobook chapter lookup for removing Audible intro/outro branding
- Updated translations for Arabic, Catalan, Croatian, German, Russian, Slovak, Slovenian, Spanish, and Ukrainian
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
New features and improvements:
- Added audiobook chapter lookup support for removing Audible intro/outro branding
- New API endpoint for direct playing audio files using session ID
- Improved audiobook m4b encoder with smarter presets for codec, bitrate, and channels
- Enhanced file watcher to re-scan library items when non-media file updates are made
- Improved Year in Review display logic
Fixed issues:
- Resolved server crash when updating the "Ignore prefixes when sorting" setting
- Fixed .ignore file causing ignores outside the directory
- Corrected issue where users without access to books in a series could still find the series in search results
- Resolved UI/UX issue with share audio player track bar tooltip overflowing on mobile
UI/UX enhancements:
- Revamped audiobook tools page
- Improved podcast episode table sorting
- Enhanced authentication config page to show "restart server" message when OIDC is enabled
- Updated various translations including Catalan, Finnish, German, Italian, Russian, Slovak, Slovenian, Spanish, and Ukrainian
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
New features and improvements:
- Added bulk download option for multiple library items
- Improved filename sanitization and normalization
- Added support for multiple series in series & series-part meta tags
- Increased latest episodes page to show 50 latest (was 25)
- Added support for .aif audio files
Fixed issues:
- Resolved incorrect items count on library page for users with item restricting permissions
- Fixed book tools page, chapter edit page, and library stats page not setting the current library properly on refresh
- Corrected podcast library item size not updating when downloading episodes
- Fixed inconsistent order of multiple authors on a book
UI/UX enhancements:
- Improved error messaging for chapter lookup errors
- Added option to toggle episode pub date sort in podcast episode download modal
- Enhanced keyboard navigation for checkboxes and button focus
- Updated stats page "items finished" icon
- Improved cover image handling in item edit modal and player
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
New features and improvements:
- Added podcast episode table sorting option for filename
- Improved book and podcast library page performance
- Enhanced podcast page play button functionality
- Updated OPF file parser to support OPF v3 refines meta elements
Fixed issues:
- Resolved issue with queuing multiple of the same episode for download
- Fixed scanning epub not using first image for cover in some cases
- Corrected publish year not saving when matching with OpenLibrary
UI/UX enhancements:
- Improved RTL support on podcast episodes table rows
- Updated various settings and UI elements for clarity
- Enhanced podcast page accessibility for screen readers
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
Fixed:
- Resolved an issue where library items were not being cached correctly
- Fixed podcast author name display in player
- Resolved an issue where non-admin users could delete and update libraries
Changed:
- Improved logic for ignoring files during library scanning
- Improved library page redirect after removing items
- Updated translations for Belarusian, Croatian, Czech, German, Italian, Polish, Swedish, and Ukrainian
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
Fixed:
- Podcast feeds http to https redirect issue
- Book library title sorting for new databases
Changed:
- Improved podcast library performance
- Refreshed bookshelf UI when book titles change
- Added translations for Bulgarian, Croatian, Swedish, and Turkish
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
Fixed:
- Caching issues with libraries page
- End of chapter sleep timer not always triggering
- Server crash related to series sequence updates
- UI display issues with book cover images
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
Fixed:
- Security issue for remote authentication bypass 🚨
- Server crash when feed cover image is requested and doesn't exist
- Unable to remove books from collections
Changed:
- Improved performance for book library page queries
- Improved parsing of name strings with single name authors
- UI/UX improvements to edit modals and batch edit page
- Book rich text description is now resizable
- More translations in multiple languages
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
Added:
- Support for rich text book descriptions
- Player setting to adjust playback rate increment/decrement amount
Fixed:
- Various server stability issues
- Problems with podcast episode downloads
- Issues with collection and series feeds
- UI display problems for sub-series
Changed:
- Improved clipboard copy functionality
- Enhanced visibility of progress bars on covers
- Added help text for collections and playlists
- Expanded book information in API responses
- Additional translations in multiple languages
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
Added:
- Support for running in subdirectories
Fixed:
- Various library and playlist management issues
- Server stability improvements
- UI display issues with podcasts and audiobooks
- Transcoding issues with spaces in paths
- Problems with CBZ file scanning
Changed:
- Improved podcast RSS feed handling
- Enhanced bookmark management and playback features
- Better podcast episode descriptions
- Improved library performance and UI responsiveness
- Additional translations in multiple languages
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
Fixed:
- Feed episode refresh issues
- Share media player functionality
- User stats heatmap display and calculations
Changed:
- Improved library page performance
- Enhanced playlist and collection management
- Updated accessibility for book, author and series cards
- Additional translations in Bengali, Russian and Slovenian
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
Fixed:
- Quick match not properly handling empty series or authors
- Podcast download queue visibility on mobile screens
- Issues with podcast episode downloads and file extensions
- File watcher behavior with dot files
- Cover image display issues in RSS feed preview
Changed:
- Improved podcast episode description handling
- Added Australia and New Zealand podcast regions
- Enhanced keyboard navigation and accessibility
- Improved performance during scrolling
- Additional translations in multiple languages
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
Fixed:
- Server crash when uploading cover art
- Server crash related to playback sessions
Changed:
- Added Catalan language option
- Improved server configuration page layout
- Additional translations in Catalan and Slovenian
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
Fixed:
- Server crash when deleting libraries or users
- Issues with podcast episode playback progress
- Share player settings functionality restored
Changed:
- Enhanced security with improved iframe restrictions
- Added audio filename and size details to podcast episode view
- Additional translations in Bengali, Croatian, French, German and Russian
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
Fixed:
- Unable to edit book series sequence
- iOS file picker improvements
- Upgrade issues from older versions resolved
Changed:
- Improved podcast episode table sorting and filtering
- Enhanced mobile upload page interface
- Additional translations in Arabic and Italian
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
Fixed:
- Server crash on new libraries
- Error handling when adding new series
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
New features:
- Library setting to control when to mark items as finished (time remaining or percentage)
- User permission to allow users to create ereaders
Fixed:
- Incorrect version shown as latest version when update is available
- Server crash when downloading files
- Incorrect time remaining for podcast episodes
- Server crash when streaming download
Changed:
- Improved performance with database migration for indexes
- Enhanced embed metadata tool functionality
- Improved localization for missing strings
- More strings translated in various languages including Croatian, Czech, Dutch, German, Polish, and Simplified Chinese
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
This release includes several improvements and bug fixes:
Fixed:
- Potential database corruptions from NOCASE indexes
- Next/previous chapter behavior on public share player
- Book library published decade filter
- Extracting cover image from audio file with multiple images
Changed:
- Improved localization for missing strings
- More strings translated in various languages including Croatian, Dutch, German, Italian, Polish, Simplified Chinese, Slovenian, and Spanish
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
This release includes several improvements and bug fixes:
New features:
- Book library filter for published decade
- Book library filter for missing chapters
- Authors page lazy load and pagination
Fixed:
- Unicode handling for author and series queries
- Podcast episode batch mark as finished now available for all users
Changed:
- UI/UX improvements for author images
- Enhanced API functionality for libraries and authors
- More strings translated in various languages
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
This release includes several improvements and bug fixes:
Fixed:
- Server crash when scanning a library with no metadata precedence set
- Server crash on listening session sync
- Issues with parsing comics
- Server crash when calling library items API endpoint with non-integer limit
- Improved handling of authors and series with non-ASCII characters
Changed:
- New users default permissions now deny explicit content
- Improved logger formatting
- Enhanced handling of library scan failures
- UI/UX improvements, including centered audio player play button and vertical volume control
- Playlist & collection "Play" button renamed to "Play All"
- Improved number formatting on user listening stats chart
- More strings translated in various languages
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
This release includes several improvements and bug fixes:
Fixed:
- Metadata embed tool failing to embed webp covers
- Server crash when quick match adds a new series
- Server crash when using the get all collections API endpoint
- Server crash when using a custom metadata provider that returns an invalid response
- Byte conversion for file sizes using 1024 instead of 1000
Changed:
- Improved formatting for entity total in bookshelf toolbar
- Cleanup of logging output for library item updates
- More strings translated, including Bengali, German, and Simplified Chinese
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
This release includes several improvements and bug fixes:
Fixed:
- User permissions inverted tags accessible not being saved
- Unable to update root user email
- "Unlink OpenID" button showing blank in user account modal
Changed:
- Batch edit page shows confirmation before navigating away with unsaved changes
- More strings translated, including Bengali and Polish
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
This release includes several improvements and bug fixes:
Fixed:
- New authors not setting 'lastFirst' column
- Toasts not showing when updating library items
Changed:
- More strings translated, including Slovenian
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
This release includes several improvements and bug fixes:
Fixed:
- Resolved server crash with SQLITE_CORRUPT error (reverted Unicode extension).
- Reverted session MemoryStore to default.
- Fixed podcast episode download request failing due to user-agent string.
- Corrected UNC path normalization.
Changed:
- Updated localization for “Year in Review” images.
- Added logging for library item downloads.
- Reverted accent-insensitive search.
- Changelog modal now shows all releases with the same major/minor version.
- Added more translations, including Simplified Chinese.
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
Added:
- Player setting to set skip forward/backward time
- “End of chapter” option for sleep timer
- Progress percentage for M4B merge and metadata embed tools
- Random sort for book/podcast library and series
- Support for accent-insensitive search
- Setting to show subtitles on book cards
Fixed:
- Filter data not populating when opening item page directly
- Podcast episode match not encoding search query
- Series and collection RSS feeds maintaining book order
- Server crash on duplicate series in OPF
- M4B merge and embed tools checking folder permissions and stripping file permissions
- Search query lost when switching libraries on the search page
- Backups not restoring properly
- Series & collection RSS feeds not setting cover image
- Media item shares duration limit increased
- Debian/PPA re-downloading ffmpeg/ffprobe on every reinstall
- Changelog not shown from settings page
- Series bookshelf row padding issue
Changed:
- Debian package now downloads dependencies on server start
- Removed old ffmpeg/ffprobe location in Debian/PPA
- Global library search includes genres
- OPML import runs in the background to prevent timeouts
- Fetch more home page items on wide screens
- Backup settings allow unlimited size with “0”
- NFO metadata parser supports language
- Improved EPUB scanner for correct cover image and OPF metadata parsing
- M4B merge tool retains advanced encoding settings
- Logs added when an ebook is downloaded
- Replaced default session memorystore with stable memorystore
UI/UX Improvements:
- Match tab supports clicking on current value to set it
- Simplified ItemSearchCard component logic
- Formatted numbers on user stats page based on locale
- Library stats page moved to library siderail (also in settings nav)
- Updated material icons font to material symbols
Translations:
- Dutch
- Finnish
- German
- Hebrew
- Italian
- Polish
- Ukrainian
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
This release brings audiobookshelf from version 2.9.0 to 2.11.0.
Added
- Create book share links with expiration (admin users only)
- Email settings option to enable/disable rejecting unauthorized certificates
- Support for disabling SSRF request filter with env variable
- Support for custom backup path on backups config page or with env variable
- Epub ereader setting for font boldness
- Finnish translations
Fixed
- Casting podcast episodes
- Match all authors hitting rate limit
- Scheduled library scans using old copy of library
- Changing author name in edit author modal not updating metadata JSON files
- AB merge tool not working in Debian pkg due to ffmpeg v7
- Download file ssrfFilter URL
- Overdrive mediamarkers incorrect timestamp parsing
- Unhandled exception syncing user progress
- Server crash from library scanner race condition
- UI/UX: PDF reader flickering
- UI/UX: Audio player long author name overflowing
- UI/UX: Audio player long chapter name overflowing
Changed
- Replace Tone with Ffmpeg for embedding metadata
- Playback sessions are closed after 36 hours of inactivity
- User agent string for podcast RSS feed and file download requests
- Increased time delay between when watcher detects a file and when it scans the folder
- Prevent editing backup path if it is set using env variable
- UI/UX: Show publish date in changelog modal
- UI/UX: Chapters table "End" column changed to a "Duration" column
- UI/UX: Bookshelf refactor for consistent scaling
- UI/UX: Cleaner error page for 404s
- More strings translated
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
This release brings audiobookshelf from version 2.8.0 to 2.9.0.
Added
- Support for webp images in cbz/cbr comic files
- Podcast library filter for language
- Hebrew, Ukrainian, Bengali, Traditional Chinese, Estonian, Hungarian, Vietnamese translations
Plus many fixes and changes...
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
This release brings audiobookshelf from version 2.7.1 to 2.8.0.
Added
- Allow adding a custom message on login page (from auth config page)
- Ability to add custom metadata providers (from item metadata utils)
- Crash logs are stored in /metadata/logs/crash_logs.txt
- Portuguese (Brazil) translations
- Podcast library setting to set iTunes search region
- OpenID: Edit user modal shows button to unlink user from OpenID
Plus many fixes and changes...
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
This release brings audiobookshelf from version 2.6.0 to 2.7.1. Note: OpenID Connect Authentication requires mobile app v0.9.70-beta or up
Added
- Year in review stats images to user stats page
- Ability to fetch book data in uploader
- Zoom controls to comic reader Plus many fixes and changes...
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
This release brings audiobookshelf from version 2.5.0 to 2.6.0.
Added
- SSO via OpenID Connect authentication
- Simple API caching for /libraries* requests
- NFO files as book metadata source
- Czech translations
- Swedish translations
Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
This release brings audiobookshelf from version 2.2.22 to version 2.5.0. Full release notes can be found at https://github.com/advplyr/audiobookshelf/releases
Added:
- Send ebook to other devices
- Export OPML for podcast libraries
- Library filter for ebook items
Fixed:
- Closing audio player resetting progress
- Epub3 ebook showing white background
- Podcast episode downloads for RSS feeds that use the same title for every episode
Changed:
- Library filter max height set to window height
- New API endpoints for static library item files, ebooks and downloading
- Security updates
- More strings translated (German)
- Audiobookshelf now works with mobile apps (Android & iOS)
Added:
- M4B merge tool advanced options for ffmpeg encoder
Fixed:
- Crash on adding podcast
- Dropdowns hidden in edit modals
- Get libraries API endpoint (bad response payload)
Changed:
- API endpoint for author image allows raw=1 query to get raw image
- More strings translated: french, simplified Chinese, & German
