Screenshots From the README of wolffshots/hass-audiobookshelf.
About
Audiobookshelf adds sensors for an Audiobookshelf server to Home Assistant, showing connection state and active sessions. It reads server-wide data locally, including users, users online, open sessions, libraries, size, items and duration, with extra sensors for each library found. Recent sessions counts sessions the server updated in the last two minutes, which is the closest the API gets to currently playing. An optional setting checks GitHub hourly for new server releases and adds an update entity, and it is off by default because it is the only request that leaves the network. A Remove My Progress action clears listening progress for books whose series name matches the given text, and it cannot be undone. Setup is done in the UI with the server address and an admin API key, and only one server can be configured.
Automatic summary of the README and code of wolffshots/hass-audiobookshelf. Something wrong, or are you the maintainer and want your own text here? Get in touch
Supports
Works locally Talks to your devices on your own network. No vendor cloud in between.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.
Provides
- Sensors
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Audiobookshelf
- API URL (starting with http:// or https://)
- API Key
- Update interval in seconds (defaults to 300s/5min)
Reauthenticate Audiobookshelf
- API Key
Reconfigure Audiobookshelf
- API URL (starting with http:// or https://)
- API Key
After setup
- Update interval in seconds (minimum 30, defaults to 300s/5min)
- Check GitHub for new Audiobookshelf releasesAudiobookshelf does not report available updates itself, so this asks GitHub once an hour. It is the only thing this integration does that leaves your network, and it is off by default.
Texts from the code of wolffshots/hass-audiobookshelf.
Entities
- SensorsUsers, Users online, Open sessions, Recent sessions, Auth sessions, Libraries, Size, Items, Duration
- UpdatesServer
Actions
- Remove My ProgressRemove listening progress for library items. This cannot be undone.Fields: Series name
Shows in Vulpo
Chart card, Apple Watch.Information
- Installs
- 317 sharing analytics
- GitHub stars
- 70
- Connection
- Works locally
- Upkeep
- Updated in the last 6 months
- Version
- v0.5.0,
- Category
- Media and entertainment, Music and radio services
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
audiobookshelf- Issues
- Report an issue













