arranhs/abs-tract

AudiobookShelf Goodreads & Kindle 元数据提供程序镜像

镜像概述

本镜像为AudiobookShelf的自定义元数据提供程序，旨在从Goodreads和Kindle平台拉取元数据，为有声书补充详细信息。通过集成该提供程序，用户可自动获取有声书的标题、作者、封面图片、内容简介、出版信息等元数据，提升AudiobookShelf库中有声书的元数据准确性和丰富度。

核心功能与特性

核心功能

• 作为AudiobookShelf的自定义元数据提供程序，无缝集成至现有有声书管理流程
• 支持从Goodreads获取图书元数据，包括书名、作者、ISBN、评分、简介等
• 支持从Kindle获取个人图书馆中的有声书信息，包括阅读进度、笔记等个性化数据
• 自动匹配有声书文件与元数据，减少手动编辑工作量

主要特性

• 多源数据整合：同时支持Goodreads（公开图书数据）和Kindle（个人数据）双数据源
• 轻量部署：基于Docker容器化部署，配置简单，资源占用低
• 实时更新：可根据配置定期或触发式拉取最新元数据
• 兼容性强：适配AudiobookShelf的元数据提供程序接口规范

使用场景与适用范围

适用场景

• 个人用户通过AudiobookShelf管理有声书库，需要补充详细元数据
• 家庭媒体服务器中部署AudiobookShelf，希望提升有声书信息展示效果
• 有声书收藏者需要统一管理不同来源的有声书元数据

适用范围

• 已部署AudiobookShelf的用户或服务器环境
• 需要从Goodreads获取公开图书信息的场景
• 使用Kindle购买或管理有声书，需同步个人阅读数据的用户

使用方法

前置条件

• 已安装Docker及Docker Compose（可选）
• 已部署AudiobookShelf服务，并可访问其API接口
• （可选）拥有Goodreads API密钥（用于获取公开图书数据）
• （可选）拥有Kindle账户访问凭证（用于获取个人图书馆数据）

Docker部署示例

基础部署（Docker Run）

bash
docker run -d \
  --name audiobookshelf-metadata-provider \
  -p 3000:3000 \
  -e AUDIOBOOKSHELF_URL="http://your-audiobookshelf-ip:80" \
  -e GOODREADS_API_KEY="your-goodreads-api-key" \
  -e KINDLE_EMAIL="your-kindle-email@example.com" \
  -e KINDLE_PASSWORD="your-kindle-app-password" \
  docker.xuanyuan.run/your-registry/audiobookshelf-metadata-provider:latest

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  metadata-provider:
    image: docker.xuanyuan.run/your-registry/audiobookshelf-metadata-provider:latest
    container_name: audiobookshelf-metadata-provider
    ports:
      - "3000:3000"
    environment:
      - AUDIOBOOKSHELF_URL="http://audiobookshelf:80"  # 若与AudiobookShelf在同一网络，可使用服务名
      - GOODREADS_API_KEY="your-goodreads-api-key"
      - KINDLE_EMAIL="your-kindle-email@example.com"
      - KINDLE_PASSWORD="your-kindle-app-password"
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

配置AudiobookShelf

1. 登录AudiobookShelf管理界面
2. 进入「设置」>「元数据」>「自定义元数据提供程序」
3. 添加新提供程序，输入本镜像服务地址（如http://metadata-provider:3000）
4. 启用该提供程序，保存配置

配置参数

环境变量说明

注：若无需从Goodreads或Kindle获取数据，可省略对应平台的环境变量。