beetbox/beets 安装与使用教程

beetbox/beets 安装与使用教程

beetsmusic library manager and MusicBrainz tagger项目地址:https://gitcode.com/gh_mirrors/be/beets

本教程将指导您安装和使用 beetbox/beets，这是一个强大的音乐库管理工具，能够自动整理您的音乐收藏并提供元数据增强功能。

1. 项目目录结构及介绍

在下载并解压 beets 之后，您会看到以下主要的目录和文件：

• beets/: 主要的源代码目录，包含了所有 beets 的模块和脚本。

  • config.yaml.example: 配置文件示例，可以用来创建自定义的配置文件。
  • plugins/: 存放各种扩展插件的目录。
  • cli.py: 命令行界面的入口点。

• docs/: 包含项目的文档资料。

• LICENSE: 许可证文件，说明了软件的使用权限。

• setup.py: Python 的安装脚本，用于安装和打包 beets。

2. 项目的启动文件介绍

beetbox/beets 的启动文件是 beets/cli.py。这个文件定义了一个名为 main() 的函数，它是程序执行的起点。通过运行 python setup.py install 或使用 pip 安装后，您可以使用 beet 命令来在终端中启动 beets。

例如，首次启动时，您可以运行 beet init 来创建一个默认的配置文件。

3. 项目的配置文件介绍

beets 使用 YAML 格式的配置文件来定制其行为。默认情况下，它会在用户的家目录下查找 .config/beets/config.yaml 文件，但可以通过 -c 参数指定其他路径。

下面是一个简单的 config.yaml 示例，展示了如何配置基本设置：

directory: ~/Music
library: library.db
import:
    write: yes
    move: no
    copy: no
    delete: no
paths:
    default: $artist/$album%aunique{}/$track - $title
    singleton: Non-Album/$artist - $title
    compilation: Compilations/$album%aunique{}/$track - $title
plugins: lastfm
lastfm:
    apikey: YOUR_API_KEY
    apisecret: YOUR_API_SECRET

• directory: 指定您的音乐库文件夹路径。
• library: 管理数据库的位置（默认为 SQLite）。
• import: 设置导入新音乐的行为，如是否写入标签、移动或复制文件等。
• paths: 自定义文件在音乐库中的存储结构。
• plugins: 启用的插件，这里以 lastfm 为例，用于集成最后FM服务。
• lastfm: 插件的配置，包括 API 密钥和密钥的秘密。

请注意替换 YOUR_API_KEY 和 YOUR_API_SECRET 为您自己申请的最后FM API 的实际键值。

完成上述步骤后，您就可以根据自己的需求管理和组织音乐库了。更多高级功能和插件可以在官方文档中找到更多信息。

beetsmusic library manager and MusicBrainz tagger项目地址:https://gitcode.com/gh_mirrors/be/beets