Flaq

内容

• 安装
• 用法
• 查询
• 标准

安装

Cargo 安装

crates.io 列表可以在这里找到。

以下是用 cargo 安装的示例。

cargo install flaq

请注意，cargo 安装不包含自动完成脚本，因此除非您手动将脚本复制到相应的 /usr/share/ 目录，否则 shell 自动完成将不会工作。

Arch Linux AUR

AUR 列表可以在这里找到。

以下是用 yay 安装的示例。如果您使用 paru，只需将 paru 替换为 yay 即可。

yay -S flaq

用法

以下是简短的帮助说明用法（可通过 flaq -h 访问）。要获取详细帮助，请运行 flac --help。

A CLI tool for editing and query `.flac` files metadata tags

Usage: flaq [OPTIONS]

Options:
  -v, --version-number  Print version
  -c, --clean           Clean duplicated fields, where both the tag field and value match
      --clean-all       [Caution] Clean duplicated fields, and deletes ALL non-standard header comments
      --set             [Default] Set field to new given values. Previous values are deleted
      --append          Append flag. If set appends values leaving existing values untouched
      --delete          Deletes associated values for provided fields, leaving the field unset
  -L, --list-detailed   Provides a formated list of all tags associated with each matching file
  -l, --list            Provides a machine readable listing of matching files
      --dry-run         Performs the modification, ready for previewing, without saving/commiting the change
  -h, --help            Print help (see more with '--help')

Tag Fields:
  -t, --title [<TITLE>...]
          Track/Work name
      --song-version [<VERSION>...]
          Recording version (e.g. remix info)
  -A, --album [<ALBUM>...]
          The collection name to which this track belongs
  -n, --tracknumber [<TRACKNUMBER>...]
          The track number of this piece if part of a specific larger collection or album
  -a, --artist [<ARTIST>...]
          The artist generally considered responsible for the work
      --performer [<PERFORMER>...]
          The artist(s) who performed the work
      --copyright [<COPYRIGHT>...]
          Copyright attribution, e.g., '2001 Nobody's Band' or '1999 Jack Moffitt'
      --license [<LICENSE>...]
          License information, for example, 'All Rights Reserved'
  -o, --organization [<ORGANIZATION>...]
          Name of the organization producing the track (i.e. the 'record label')
      --description [<DESCRIPTION>...]
          A short text description of the contents
  -g, --genre [<GENRE>...]
          A short text indication of music genre
  -d, --date [<DATE>...]
          Date the track was recorded
      --location [<LOCATION>...]
          Location where track was recorded
      --contact [<CONTACT>...]
          Contact information for the creators or distributors of the track
      --isrc [<ISRC>...]
          ISRC number for the track

Arguments:
  -q, --query <QUERY>
  -f, --files [<FILES>...]

查询

查询是一系列操作，将针对每个提供的文件进行评估，不包括不满足查询的文件。

查询是变量、字面量和运算符的组合。查询是一个表达式，可以是任何其他表达式的组合，但最终必须评估为布尔值。

变量

任何标准标签都可以用作变量。该变量将替换为每个相应文件匹配的标签列表。变量通过其完整标签名称使用，该名称不区分大小写（例如，Title、tracknumber、ArtISt 都是变量的有效使用）。

如果提供的文件中任何必需的变量未设置，查询将出错。

• 日期
  • 第一个用于 date 标签的标记，必须以 YYYY、YYYY-MM 或 YYYY-MM-DD 的格式存储。注意，查询的日期字面量以 d 前缀，但存储的日期不是
• Tracknumber
  • 第一个用于 tracknumber 标签的标记，必须可以解析为无符号32位整数。
  • 如果 Tracknumber 未设置或无法解析，将引发错误并导致查询失败
• 其他标签
  • 所有其他标签都将替换为为该标签设置的字符串列表

字面量

• 字符串字面量 "<string>"
  • 字符串字面量必须用引号括起来，允许使用转义字符（包括额外的引号）。字符串可以包含任何Unicode字符
  • 例如： "Casiopea"、"瀬葉淳"、"Some \"Escape Characters\""
• 整数字面量 <num>
  • 整数字面量必须可以解析为32位无符号整数（包括0在内的正整数）
  • 例如： 10、0、1234
• 日期字面量（《d<YYYY>、《d<YYYY>-<MM> 或 d<YYYY>-<MM>-<DD>
  • 日期必须以 d 前缀，并可以按年、年-月或年-月-日形式给出。
  • 例如： d1980、d2001-01、d1192-03-12