audiobookshelf 提供者
Music Assistant 支持 audiobookshelf。由 Fabian Munkes 贡献和维护。
功能
其他
- 填充所提供用户可访问的所有库中的有声读物
- 填充所提供用户可访问的所有库中的播客
- 浏览功能具有以下结构:
- 有声读物搜索功能支持搜索作者和朗读者
- 进度双向同步,并在播放前获取
- 已知库中播客/有声读物元数据的事件驱动更新:
- 如果 MA 正在运行,更改会立即反映到 MA 数据库
- 新添加和刚刚删除的项目也会立即反映
- 但是:如果 MA 在 ABS 数据库发生更改时关闭,则只有在触发正常提供者同步时才会同步这些更改
- 支持单文件和多文件有声读物
- 在主页视图上支持推荐
配置
设置此提供者需要以下内容:
- 服务器。 Audiobookshelf 实例的服务器 URL(例如
https://abs.domain.tld/或http://192.168.1.4:13378/用于本地服务器)。 - 无 OIDC 的验证:
- 用户名。 Audiobookshelf 用户的用户名
- 密码。 此用户的密码
NOTE
用户必须是 user、admin 或 root 类型。Guest 用户既未测试也不受支持
- 如果配置了 OIDC:
- 2.26 版本之前,使用 Token 而不是用户/密码。 在指定字段中添加 token。此 token 可以由管理员用户在 ABS 设置 -> 用户中为任何用户获取
- 从 2.26 版本开始,audiobookshelf 内部使用 JWT token 系统。可以为外部应用程序创建永久 API 密钥。请按照 https://www.audiobookshelf.org/guides/api-keys/ 的 audiobookshelf 文档创建此类 API 密钥
NOTE
如果您插入旧的 legacy token,一旦这些 token 从 ABS 中移除,您的提供者将不再工作。
多用户环境
audiobookshelf 提供者可以为不同用户设置多次。 要实现与 MA 用户的单个媒体项目进度的正确同步,请参阅用户管理。
高级设置
- 验证 SSL。 启用以验证 SSL/TLS 连接的证书。默认开启
- 隐藏空播客。 同步时可以跳过尚未下载剧集的播客
已知问题 / 说明
- 多文件有声读物:UI 将显示 PCM 作为源文件格式(因为这是内部使用的),而不是有声读物的实际文件格式
- 目前针对 ABS >= 2.19.0 进行测试
- 首先出现任何问题时,请确保服务器正在运行 最新版本的 audiobookshelf 软件
尚不支持
- 播放列表
- 编辑提供者功能
- 创建/删除新库(即不是已知库中的媒体项目)不会以事件驱动方式反映。相反,请使用正常同步

