Package: zrtool
zrtoolzrtool is a little cli tool that let you do some actions on a ZoomR16
project. For now, you can backup a project in a compressed format, and
extract any data you need from it. You can also get the original
uncompressed project if you want to restore a backuped project into you
ZoomR16 device.Installationzrtool need a proper installation offlac(https://www.xiph.org/flac/) to work. The flac encoder and decoder is
available on most platform, e.g.apt install flacfor debian based OS.zrtool will try to use theflaccommand line. If theflacbinary is
not accessible from your PATH, it can be specified with theZRTOOL_FLAC_BINenvironnement.The recommended way to install zrtool is by usingpipx:pipxinstallzrtoolIf you don't want to installpipxto manage python cli tools
installation, zrtool can also be installed with pip:pipinstallzrtoolUsage exampleAll this options are not yet available. They will be included in
version 1.0.0. To see what's already implemented refer to the CHANGES
document.Backup a project under the zrpa format.$zrtoolarchive[--compress|--no-compress]PRJ000/project-000.zrpaConvert back to the original format.$zrtoolexport[--numberN]project-000.zrpa[foo/]It will create a directoryPROJ000in the foo directory. If foo is not
specified, createPROJ000in the current directory. Number is
optional, if not given the number of the project is determined by the
project that can be found in the target directory. If specified this
number is used to define the name of the project directory.SearchSearch based on metadata.$zrtoolfilter\[--not]\--zprop"name""Test"\--zprop-track"fader"801\--tag"title"".*song"\--tag-file"title"".*song""MONO-000"\[--recursive]\[directory/...]path/to/archive.zrpa
path/to/other-archive.zrpaReturn the path of zrpa archive that match at least one of the given tag
or zprop. It get archive from directory if given, else it reads path
from stdin.
Filter can be piped to each other to perform "and" filter and more
complex search.MetadataShow metadata of a zrpa archive.$zrtooltagsproject-000.zrpa
title:Songtitle
author:Bandname
date:2020-02-29MONO-000.WAV:author:Someoneinstrument:Guitarcomment:RecordedwithsimplemicrophoneMASTR000.WAV:comment:Firstmixdone.Needstobeimproved
$zrtooltags--projectproject-000.zrpa
title:Songtitle
author:Bandname
date:2020-02-29
$zrtooltags--fileMONO-000.WAVproject-000.zrpa
MONO-000.WAV:author:Someoneinstrument:Guitarcomment:Recordedwithsimplemicrophone
$zrtooltags--project--keytitleproject-000.zrpa
Songtitle
$zrtooltags--fileMONO-000.WAV--keyinstrumentproject-000.zrpa
guitarAdd a new key and value to a project.$zrtooltag[--update]--key-valueTake0project-000.zrpa
$zrtooltag[--update]--key-valueAuthorSomeone--fileMONO-000project-000.zrpaEdit an existing metadata of a project.$zrtooltag--keyTitleproject-000.zrpa
$zrtooltag--keyInstrument--fileMONO-000project-000.zrpa
$zrtoolproject-000.zrpametadatarename-keyAuthorArtistRename an existing key.$zrtooltag--rename-keyAuthorArtistproject-000.zrpa
$zrtooltag--rename-keyAuthorArtist--fileMONO-000project-000.zrpaDelete an existing tag.$zrtoolrmtag--keyTitleproject-000.zrpa
$zrtoolrmtag--keyTitle--fileMONO-000project-000.zrpaFilesList archive content.$zrtoolfilesproject-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
$zrtoolfilesproject-000.zrpaAUDIO
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
$zrtoolfilesproject-000.zrpaAUDIO/*
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
$zrtoolfilesproject-000.zrpaAUDIO/**.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.ZDTExtract a file from an archive.$zrtoolextract[--directoryfoo/]project-000.zrpaAUDIO/**.ZDTExtractaudiofiles from an archive.$zrtoolget\--format{flac|vorbis|mp3|wav}\[--directoryfoo/][--name'${title} - ${author}.ogg']\project-000.zrpaMASTR000...Add audio file to an archive. File are added to the root of the archive,
except audio file that are added to the audio directory. If--dest DESToption is given,DESTis created in the archive starting from
the root and files are added in this directory. It prevent from
overwriting metadata file with a non-conform metadata file.$zrtoolfile[--update][--destAUDIO]project-000.zrpamusic.wav
$zrtoolfile[--update]project-000.zrpanote.txtRemove a file from an archive. Some integrity checks needs to be done.$zrtoolrmfileproject-000.zrpaAUDIO/MONO-000.WAV...Project dataRead project data in thePRJDATA.ZDTfile.$zrtoolzpropsproject-000.zrpa
name:PROJ000
...
$zrtoolzprops--track1project-000.zrpa
file:MONO-000.WAV
fader:80...
$zrtoolzprops--keynameproject-000.zrpa
PROJ000Edit project data.$zrtoolzprop--key-valuename"MYPROJ"project-000.zrpa
$zrtoolzprop--key-valuefileMASTR000.WAV--track1project-000.zrpa
$zrtoolzprop--keyFile--track1project-000.zrpa