甜菜 - 云端在线

程序：

您的姓名

beet - 音乐标注器和图书馆组织者

概要

甜菜 [ARGS...] 命令 [ARGS...]
甜菜 帮助 命令

指令

进口
甜菜导入 [-CWAPRqst] [-l LOGPATH] 路径...
甜菜进口 [选项] -L 查询

将音乐添加到您的音乐库，尝试从 MusicBrainz 获取正确的标签。

将命令指向一些音乐：目录、单个文件或压缩档案。 这
音乐将被复制到可配置的目录结构并添加到库中
数据库。 该命令是交互式的，将尝试让您验证 MusicBrainz 标签
它认为是可疑的。 见 自动标记 指南 有关如何使用的详细信息
交互式标签更正流程。

传递给导入命令的目录可以包含单个专辑或多个专辑，在
在这种情况下，叶目录将被视为专辑（后一种情况适用于
典型的艺术家/专辑组织和许多人的“下载”文件夹）。 路径可以
也可以是一首歌曲或档案。 甜菜支持 拉链 和 焦油 存档开箱即用。
提取 RAR 文件，安装 rar文件 包和 的unrar 命令。

可选的命令标志：

· 默认情况下，该命令将文件复制到您的库目录并更新 ID3 标签
在你的音乐上。 如果您想保持音乐文件不变，请尝试 -C （别
复制）和 -W （不要写标签）选项。 您也可以默认禁用此行为
在配置文件中（如下）。

· 此外，您可以完全使用禁用自动标记行为 -A （不要自动标记）---然后
您的音乐将与其现有的元数据一起导入。

· 在长时间标记导入期间，跟踪未添加的专辑会很有用
标记成功---要么是因为它们不在 MusicBrainz 数据库中，要么是因为
文件有问题。 使用 -l 选项指定一个文件名来记录每个
当您跳过专辑或“按原样”导入或专辑被跳过时作为副本。

· 相关地， -q (quiet) 选项可以通过自动标记来帮助处理大量导入，而无需
打扰要求用户输入。 每当正常的自动标记模式要求
确认，安静模式悲观地跳过专辑。 静音模式也
禁用标记器恢复中断导入的能力。

· 说到恢复中断的导入，标签器会提示你
目录的最后一次导入被中断（被您或崩溃）。 如果你想
跳过此提示，您可以通过提供自动说“是” -p 或“不”使用 -P。 该
默认情况下，可以使用配置选项禁用恢复功能（见下文）。

· 如果您只想导入 新 目录中的东西，使用 -i 运行一个选项
增量 进口。 有了这个标志，甜菜将跟踪它曾经的每个目录
导入并避免再次导入它们。 如果您有“传入”，这很有用
您定期添加内容的目录。 要使其正常工作，您将
需要使用增量导入 每周 次 你在目录上运行导入
问题---包括第一次，当没有子目录将被跳过。 所以考虑
使 增量 配置选项。

· 默认情况下，甜菜将在不询问是否找到非常接近的元数据匹配的情况下继续进行。
要禁用此功能并让进口商每次都询问您，请使用 -t （用于 胆小） 选项。

· 导入者通常以一次整张专辑的模式工作。 如果你想
导入单个非专辑曲目，使用 独生子 模式通过提供 -s 选项。

· 如果您有一个专辑，该专辑在一个共同的顶部下分布在多个目录中
目录，使用 - 平坦的 选项。 这需要目录下的所有音乐文件
（递归地）并将它们视为单个大专辑而不是每个专辑
目录。 这可以帮助您处理更顽固的多碟专辑。

· 同样，如果您有一个包含多个相册的目录，请使用
--组专辑 在将文件匹配为之前根据其元数据拆分文件的选项
单独的专辑。

名单
甜菜列表 [-apf] 查询

查询 音乐数据库。

想搜索蒙特利尔的“Gronlandic Edit”？ 尝试 甜菜 名单 格罗兰迪克. 可能是你
想看到 2009 年发布的所有标题中带有“蔬菜”的内容吗？ 尝试 甜菜 名单
年份：2009 标题：蔬菜. 您还可以指定排序顺序。 （阅读更多 询问.)

您可以使用 -a 切换到搜索专辑而不是单个项目。 在这种情况下，
您使用的查询仅限于专辑级别的字段：例如，您可以搜索
年份：1969 但查询项目级字段的部分，如 标题：富 将被忽略。 记住
这 艺术家 是一个项目级别的字段； 专辑艺人 是对应的专辑字段。

-p 选项使甜菜打印出匹配项目的文件名，这可能对
管道到其他 Unix 命令（例如 参数）。 同样， -f 选项让您指定
用于打印每张专辑或曲目的特定格式。 这使用相同的模板
语法为甜菜' 径 格式. 例如，命令 甜菜 ls -af '$专辑： $tracktotal'
披头士 打印出每张披头士专辑的曲目数。 在 Unix shell 中，请记住
将模板参数用单引号括起来以避免环境变量扩展。

去掉
甜菜删除 [-ad] QUERY

从您的音乐库中删除音乐。

此命令使用相同的 询问 语法为 名单 命令。 你会看到一个列表
将被删除并要求确认的文件。 默认情况下，这只是删除
来自图书馆数据库的条目； 它不会触及磁盘上的文件。 实际删除
文件，使用 甜菜 去掉 -d.

修改
甜菜修改 [-MWay] 查询 [FIELD=VALUE...] [FIELD!...]

更改数据库中项目或专辑的元数据。

供应一个 询问 匹配你想要改变的东西和一系列 字段=值 对。
例如， 甜菜 修改 天才 of 爱 艺术家=“汤姆” Tom 俱乐部” 将改变艺术家
曲目“爱的天才”。 删除字段（这仅适用于灵活的
属性），在字段名称后面加上感叹号： 场地！.

-a switch 对专辑而不是单个曲目进行操作。 物品将自动
如果它们在您的库目录中，则在必要时移动，但您可以禁用它
-M. 标签将根据您对导入的设置写入文件，
但这些可以被覆盖 -w （写标签，默认）和 -W （不要写标签）。
最后，此命令在进行任何更改之前礼貌地征求您的许可，但是您
可以跳过该提示 -y 开关。

移动
甜菜移动 [-ca] [-d DIR] 查询

移动或复制库中的项目。

默认情况下，此命令充当库合并器：与查询匹配的项目是
重命名为您的库目录结构。 通过指定目标目录
-d 手动，您可以将与查询匹配的项目移动到文件系统中的任何位置。 这 -c
选项复制文件而不是移动它们。 与其他命令一样， -a 选项匹配
专辑而不是物品。

更新
甜菜更新 [-aM] 查询

更新库（并可选择移动文件）以反映带外元数据更改
和文件删除。

这将扫描所有匹配的文件并读取它们的标签，用
新的价值观。 默认情况下，文件将根据新的元数据重命名； 禁用
这个与 -M.

要执行更新的“试运行”，只需使用 -p （用于“假装”）标志。 这将显示
您提出了所有建议的更改，但实际上不会更改磁盘上的任何内容。

当更新的曲目是专辑的一部分时，专辑级别的字段 所有 曲目来自
专辑也更新了。 （具体来说，该命令从第一个复制专辑级别的数据
曲目并将其应用于其余曲目。）这意味着，如果
专辑中的专辑级别字段不相同，显示的某些更改 更新
命令可能会被同一专辑中其他曲目的数据覆盖。 这意味着
运行 更新 命令多次可能会显示正在应用的相同更改。

写
甜菜写 [-pf] [查询]

将数据库中的元数据写入文件的标签。

当您更改存储在甜菜库数据库中的元数据时（在导入或
与 修改 命令，例如），您通常可以选择仅存储更改
在数据库中，让您的文件保持不变。 这 写 命令可让您稍后更改
将数据库的内容写入文件中。 默认情况下，这会写
仅当数据库和文件中的标记之间存在差异时才进行更改。

您可以将此命令视为与 更新.

-p 选项预览元数据更改而不实际应用它们。

-f 选项强制写入文件，即使文件标签与数据库匹配。 这个
对于确保在写入时运行的已启用插件（例如 Scrub 和 Zero
插件）在文件上运行。

统计
甜菜统计数据 [-e] [查询]

显示整个图书馆的一些统计数据（如果您不提供 询问) 或匹配的
项目（如果你这样做）。

-e (- 精确的) 选项使总文件大小的计算更准确但速度更慢。

领域
甜菜田

显示可用于的项目和专辑元数据字段 询问 和 路径格式.
包括插件提供的任何模板字段。

配置
甜菜配置 [-pd]
甜菜配置 -e

显示或编辑用户配置。 此命令执行以下三件事之一：

· 没有选项，打印当前用户配置的 YAML 表示。 随着
- 默认 选项，甜菜的默认选项也包含在转储中。

· - 小路 选项而是显示配置文件的路径。 这可以
结合 - 默认 标志显示甜菜保持其内部默认值的位置。

·随着 - 编辑 选项，beets 尝试打开您的配置文件进行编辑。 它首先
尝试 $编辑器 环境变量，然后是后备选项，具体取决于您
平台： 打开 在 OS X 上， XDG开 在 Unix 上，在 Windows 上直接调用。

全球 旗帜

Beets 有一些影响所有命令的“全局”标志。 这些必须出现在
可执行文件名（甜菜) 和命令---例如， 甜菜 -v 进口 ....

· -l 路径: 指定要使用的库数据库文件。

· -d 目录: 指定库根目录。

· -v：详细模式； 打印出大量调试信息。 请使用此标志
报告错误时。

· -c 文件: 读取指定的 YAML 配置 文件.

甜菜还使用 甜菜根目录 用于查找配置和数据的环境变量。

SHELL 竣工

Beets 包括对 shell 命令完成的支持。 命令 甜菜 完成 打印
出一个 打坏 3.2 脚本； 启用完成将这样的行放入您的 的.bashrc or
类似文件：

评估“$（甜菜完成）”

或者，为了避免减慢 shell 启动时间，您可以通过管道将 甜菜 完成 产量
改为文件和源。

您还需要获取 bash 完成 脚本，可能可以通过
你的包管理器。 在 OS X 上，你可以通过 Homebrew 安装它 酿造 安装
bash 完成; Homebrew 将为您提供有关采购脚本的说明。

完成脚本建议子命令的名称和（键入后 -) 选项
给定的命令。 如果您正在使用接受查询的命令，该脚本还将
完整的字段名称。

甜菜列表 ar[TAB]
# 艺术家：artist_credit：artist_sort：artpath：
甜菜列表 artp[TAB]
甜菜列表艺术路径\:

（不要担心冒号前面的斜线：这是一个转义序列
壳，不会被甜菜看到。）

插件命令的完成仅适用于那些在运行时启用的插件
甜菜 完成. 如果您稍后添加插件，您将需要重新生成脚本。

如果您使用 zsh，请查看包含的 完成 脚本.

使用 onworks.net 服务在线使用甜菜