Dodelidoo-Labs/sonobarr

这是什么？

核心功能

• 01同步 Lidarr 中受监控的艺人，并可将选中的候选艺人加回 Lidarr。
• 02从 Lidarr、Last.fm 播放记录和 ListenBrainz 歌单生成发现批次。
• 03AI 助手可根据文字描述，通过兼容 OpenAI 的模型生成种子艺人。
• 04艺人请求流程支持管理员审批，并通过 Socket.IO 实时同步状态。
• 05支持通过 YouTube 或 iTunes 试听，并可查看 Last.fm 简介与统计信息。
• 06支持 OIDC 单点登录和用户自带的 API 密钥。

适用场景

• 基于已有 Lidarr 音乐库，寻找符合口味的新艺人。
• 在家庭或小团队中共享同一个自托管 Lidarr 实例，每人使用独立账号。
• 让非管理员用户提交艺人请求，由管理员审批后加入 Lidarr。

快速上手

1. 1

   创建工作目录并将其所有者设置为容器的 UID/GID

   mkdir -p sonobarr && cd sonobarr sudo chown -R 1000:1000 .
2. 2

   下载示例 docker-compose.yml 和 .env 配置文件

   curl -L https://raw.githubusercontent.com/Dodelidoo-Labs/sonobarr/develop/docker-compose.yml -o docker-compose.yml curl -L https://raw.githubusercontent.com/Dodelidoo-Labs/sonobarr/develop/.sample-env -o .env
3. 3

   编辑 .env,设置 secret_key、Lidarr 地址与 API 密钥,以及 Last.fm API 密钥和密钥secret

4. 4

   使用 Docker Compose 启动 Sonobarr,然后打开 http://localhost:5000

   docker compose up -d

使用前须知

• !需要先运行 Lidarr 实例并拥有 Last.fm API 密钥才能正常使用。
• !主要面向 Docker 部署,README 未提供面向普通用户的原生非 Docker 安装方式。
• !公开 API 文档尚未完成。

收录于专题

标签

常见问题

sonobarr 是什么？

自托管音乐发现工具，结合 Lidarr 音乐库与 Last.fm 推荐，并提供 AI 辅助的网页界面。 Sonobarr 是一个自托管的网页应用，基于你已有的 Lidarr 音乐库发现新艺人。它从 Lidarr 读取艺人，在 Last.fm 上查找相似艺人，并把结果流式推送到浏览器卡片网格中。你可以试听预览、查看简介，并一键把候选艺人加回 Lidarr。

sonobarr 可以免费使用吗？用的什么许可证？

sonobarr 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

sonobarr 还在维护吗？

半年内有更新。sonobarr 最近一次提交是在 2026年9月9日。

sonobarr 适合用来做什么？

基于已有 Lidarr 音乐库，寻找符合口味的新艺人。 在家庭或小团队中共享同一个自托管 Lidarr 实例，每人使用独立账号。 让非管理员用户提交艺人请求，由管理员审批后加入 Lidarr。

sonobarr 怎么安装和运行？

创建工作目录并将其所有者设置为容器的 UID/GID: mkdir -p sonobarr && cd sonobarr sudo chown -R 1000:1000 . 下载示例 docker-compose.yml 和 .env 配置文件: curl -L https://raw.githubusercontent.com/Dodelidoo-Labs/sonobarr/develop/docker-compose.yml -o docker-compose.yml curl -L https://raw.githubusercontent.com/Dodelidoo-Labs/sonobarr/develop/.sample-env -o .env 编辑 .env,设置 secret_key、Lidarr 地址与 API 密钥,以及 Last.fm API 密钥和密钥secret 使用 Docker Compose 启动 Sonobarr,然后打开 http://localhost:5000: docker compose up -d

在哪里获取 sonobarr？

源代码和安装说明在 GitHub 上：https://github.com/Dodelidoo-Labs/sonobarr