zrtool

zrtool是一个小的命令行工具，允许您在ZoomR16项目中执行一些操作。目前，您可以备份项目为压缩格式，并从中提取所需的所有数据。如果您想要将备份的项目恢复到ZoomR16设备中，也可以获取原始未压缩的项目。

安装

zrtool需要正确安装flac（https://www.xiph.org/flac/）才能工作。flac编码器和解码器在大多数平台上都可用，例如，对于基于debian的操作系统，可以使用apt install flac。

zrtool将尝试使用flac命令行。如果flac二进制文件不可从您的PATH中访问，可以使用ZRTOOL_FLAC_BIN环境变量指定。

安装zrtool的推荐方式是使用pipx

pipx install zrtool

如果您不想使用pipx来管理Python CLI工具的安装，也可以使用pip安装zrtool

pip install zrtool

使用示例

所有这些选项目前尚不可用。它们将在版本1.0.0中包含。要查看已实现的内容，请参阅CHANGES文档。

在zrpa格式下备份一个项目。

$ zrtool archive [--compress|--no-compress] PRJ000/ project-000.zrpa

转换回原始格式。

$ zrtool export [--number N] project-000.zrpa [foo/]

它将在foo目录下创建一个名为PROJ000的目录。如果未指定foo，则将在当前目录下创建PROJ000。编号是可选的，如果未给出，则项目编号由目标目录中可以找到的项目确定。如果指定，则使用此编号定义项目目录的名称。

搜索

基于元数据搜索。

$ zrtool filter \
    [--not] \
    --zprop "name" "Test" \
    --zprop-track "fader" 80 1 \
    --tag "title" ".*song" \
    --tag-file "title" ".*song" "MONO-000" \
    [--recursive] \
    [directory/...]
path/to/archive.zrpa
path/to/other-archive.zrpa

返回至少匹配给定标签或zprop的zrpa存档的路径。如果给出目录，则从目录中获取存档，否则从stdin读取路径。过滤器可以相互管道以执行“与”过滤和更复杂的搜索。

元数据

显示zrpa存档的元数据。

$ zrtool tags project-000.zrpa
title: Song title
author: Band name
date: 2020-02-29
  MONO-000.WAV:
    author: Someone
    instrument: Guitar
    comment: Recorded with simple microphone
  MASTR000.WAV:
    comment: First mix done. Needs to be improved
$ zrtool tags --project project-000.zrpa
title: Song title
author: Band name
date: 2020-02-29
$ zrtool tags --file MONO-000.WAV project-000.zrpa
MONO-000.WAV:
  author: Someone
  instrument: Guitar
  comment: Recorded with simple microphone
$ zrtool tags --project --key title project-000.zrpa
Song title
$ zrtool tags --file MONO-000.WAV --key instrument project-000.zrpa
guitar

向项目中添加新的键和值。

$ zrtool tag [--update] --key-value Take 0 project-000.zrpa
$ zrtool tag [--update] --key-value Author Someone --file MONO-000 project-000.zrpa

编辑项目的现有元数据。

$ zrtool tag --key Title project-000.zrpa
$ zrtool tag --key Instrument --file MONO-000 project-000.zrpa
$ zrtool project-000.zrpa metadata rename-key Author Artist

重命名现有键。

$ zrtool tag --rename-key Author Artist project-000.zrpa
$ zrtool tag --rename-key Author Artist --file MONO-000 project-000.zrpa

删除现有标签。

$ zrtool rmtag --key Title project-000.zrpa
$ zrtool rmtag --key Title --file MONO-000 project-000.zrpa

文件

列出存档内容。

$ zrtool files project-000.zrpa
AUDIO/
AUDIO/MASTR000.WAV
AUDIO/MONO-000.WAV
AUDIO/MONO-001.WAV
AUDIO/MONO-002.WAV
AUDIO/MONO-003.WAV
AUDIO/MONO-004.WAV
AUDIO/MONO-005.WAV
EFXDATA.ZDT
metadata.json
PRJDATA.ZDT
$ zrtool files project-000.zrpa AUDIO
AUDIO/
AUDIO/MASTR000.WAV
AUDIO/MONO-000.WAV
AUDIO/MONO-001.WAV
AUDIO/MONO-002.WAV
AUDIO/MONO-003.WAV
AUDIO/MONO-004.WAV
AUDIO/MONO-005.WAV
$ zrtool files project-000.zrpa AUDIO/*
AUDIO/MASTR000.WAV
AUDIO/MONO-000.WAV
AUDIO/MONO-001.WAV
AUDIO/MONO-002.WAV
AUDIO/MONO-003.WAV
AUDIO/MONO-004.WAV
AUDIO/MONO-005.WAV
$ zrtool files project-000.zrpa AUDIO/* *.ZDT
AUDIO/MASTR000.WAV
AUDIO/MONO-000.WAV
AUDIO/MONO-001.WAV
AUDIO/MONO-002.WAV
AUDIO/MONO-003.WAV
AUDIO/MONO-004.WAV
AUDIO/MONO-005.WAV
EFXDATA.ZDT
PRJDATA.ZDT

从存档中提取文件。

$ zrtool extract [--directory foo/] project-000.zrpa AUDIO/* *.ZDT

从存档中提取音频文件。

$ zrtool get \
    --format {flac|vorbis|mp3|wav} \
    [--directory foo/]
    [--name '${title} - ${author}.ogg'] \
    project-000.zrpa MASTR000...

将音频文件添加到存档中。文件添加到存档的根目录，除了添加到音频目录的音频文件。如果指定了--dest DEST选项，则从根目录开始创建DEST，并将文件添加到该目录。这可以防止非符合元数据的文件覆盖元数据文件。

$ zrtool file [--update] [--dest AUDIO] project-000.zrpa music.wav
$ zrtool file [--update] project-000.zrpa note.txt

从存档中删除文件。需要执行一些完整性检查。

$ zrtool rmfile project-000.zrpa AUDIO/MONO-000.WAV...

项目数据

在PRJDATA.ZDT文件中读取项目数据。

$ zrtool zprops project-000.zrpa
name: PROJ000
...
$ zrtool zprops --track 1 project-000.zrpa
file: MONO-000.WAV
fader: 80
...
$ zrtool zprops --key name project-000.zrpa
PROJ000

编辑项目数据。

$ zrtool zprop --key-value name "MYPROJ" project-000.zrpa
$ zrtool zprop --key-value file MASTR000.WAV --track 1 project-000.zrpa
$ zrtool zprop --key File --track 1 project-000.zrpa