lidarr

🎵 高品质音乐库自动化管理

基于 Lidarr 开源平台的音乐库管理技能,支持 FLAC 无损音质,实现艺术家与专辑的自动化搜索添加。

收藏
5.8k
安装
1.8k
版本
v1.0.0
CLS 安全性认证2026-05-16
点击查看完整报告 >

使用说明

Lidarr Skill 是一款专为音乐收藏爱好者设计的自动化管理工具,通过与本地部署的 Lidarr 音乐管理平台对接,实现艺术家和专辑的智能搜索与添加。该技能基于 Shell 脚本开发,通过调用 Lidarr API 完成音乐库管理,支持 FLAC 无损音质等高品质音频配置,满足发烧友对音质的苛刻要求。

核心用法围绕命令行工作流展开。用户首先需要配置本地 Lidarr 实例的地址和 API 密钥,随后可通过 search 命令查询艺术家信息,利用 add 命令将目标艺术家加入监控列表。技能支持精细化的质量配置,默认推荐 FLAC 无损格式,同时提供专辑-only 或完整 discography 等多种元数据配置选项。对于已添加的艺术家,可使用 monitor-album 对特定专辑进行单独管理,或通过 remove 命令清理库内容,所有操作均通过简洁的 CLI 界面完成。

显著优点体现在专业性与灵活性的结合。首先,作为 Lidarr 生态的延伸,它继承了该平台强大的音乐元数据管理能力,依托 MusicBrainz 等权威数据库确保信息准确。其次,本地化部署模式确保用户的音乐收藏数据完全私有,API 通信仅限于用户自建的服务实例,避免隐私泄露风险。再者,命令行交互方式比 Web 界面更高效,特别适合批量操作和自动化脚本集成。最后,对 FLAC 24-bit 等无损格式的原生支持,使其成为高保真音乐管理的理想选择。

潜在缺点主要包括部署门槛和使用限制。该技能完全依赖用户自行搭建的 Lidarr 服务,对于没有 NAS 或服务器环境的普通用户而言,前期配置成本较高。作为 T3 级社区来源项目,虽然代码质量达到 A 级标准,但缺乏官方商业背书,长期维护存在不确定性。此外,技能仅支持本地实例管理,无法直接操作远程或公共 Lidarr 服务,且所有交互均通过终端完成,对非技术用户不够友好。

适合的目标群体明确:拥有 NAS 或家庭服务器的音乐发烧友、使用 Lidarr 管理大型音乐库的高级用户、以及希望通过自动化脚本维护音乐收藏的技术爱好者。对于追求音质完美、注重数据隐私、且具备一定 Linux 操作基础的用户,该技能能显著提升音乐库管理效率。

使用风险方面,首先需要关注 API 密钥安全,配置文件存储的密钥若权限设置不当可能被系统其他用户读取,建议设置 600 权限。其次,remove --delete-files 操作会物理删除硬盘上的音乐文件,误操作可能导致数据永久丢失,执行前务必确认。此外,技能依赖 curl 和 jq 系统工具,在精简版操作系统上可能需手动安装依赖。网络配置方面,若 Lidarr 实例暴露于公网,API 密钥泄露可能导致库被恶意篡改,建议在可信内网环境使用。

安全解读

核心功能

Lidarr 是一款面向音乐收藏爱好者的自建媒体库管理工具,通过命令行接口与 Lidarr 实例交互,实现艺术家检索、专辑管理、质量配置等全流程自动化操作。

主要能力

  • 智能搜索:支持通过 MusicBrainz 数据库查找艺术家,返回结构化编号列表
  • 灵活添加:可配置 FLAC/MP3 等音质档案,支持仅添加专辑或完整 discography
  • 精细管理:单独监控特定专辑、刷新元数据、移除艺术家(可选删除文件)
  • 零依赖部署:仅依赖系统标准工具 curljq,无第三方包风险

显著优点

1. 隐私优先设计:所有 API 调用指向用户自托管的私有 Lidarr 实例,数据不出境
2. 配置安全:API 密钥从用户主目录 ~/.clawdbot/credentials/ 读取,无硬编码凭据

3. 功能幂等:重复添加艺术家自动转为监控模式,避免操作失败

4. 音质精细化:内置无损 FLAC 与 24-bit 档案支持,满足发烧友需求

潜在局限

  • 网络依赖:需自行部署 Lidarr 服务并确保网络可达
  • 学习成本:需理解 Quality Profile 与 Metadata Profile 的概念差异
  • 无内置搜索:依赖外部下载器(如 qBittorrent、NZBGet)完成实际资源获取

适用人群

  • 自建 NAS/Homelab 的音乐收藏者
  • 追求 FLAC 无损音质的音频爱好者
  • 已有 Sonarr/Radarr 使用经验,希望统一媒体管理栈的用户

常规风险提示

  • 示例配置中的假 API Key 可能被安全扫描工具误报(已标记为文档示例)
  • 建议配置文件设置 chmod 600 权限,防止多用户环境密钥泄露
  • 生产环境强烈推荐 HTTPS 连接,避免 API 密钥在传输中暴露

lidarr 内容

scripts文件夹
手动下载zip · 4.4 kB
lidarr.shtext/x-shellscript
请选择文件