zoomrlib 1.1.0

Library to read and write a ZoomR16 project file

zoomrlib

zoomrlib is a library that let you read and write a Zoom R16 project file and export it into a JSON file. It provide also a little cli to show content of a Zoom R16 project as text.

Installation

Python >= 3.8 is needed (older python version may work, but it's not tested).

pip install zoomrlib

Usage

Most important information from a project file can be read and write:

For the whole project:

• name
• header
• bitlength
• protected
• insert_effect_on
• tracks
• master

For a track:

• file
• status
• stereo_on
• invert_on
• pan
• fader
• chorus_on
• chorus_gain
• reverb_on
• reverb_gain
• eqhigh_on
• eqhigh_freq
• eqhigh_gain
• eqmid_on
• eqmid_freq
• eqmid_qfactor
• eqmid_gain
• eqlow_on
• eqlow_freq
• eqlow_gain

For the master track:

• file
• fader

From an Effects file, you can learn:

• send_reverb_on
• send_reverb_patch_num
• send_reverb_patch_name
• send_chorus_on
• send_chorus_patch_num
• send_chorus_patch_name

In a python program, use it like this:

import zoomrlib

with zoomrlib.open("PRJDATA.ZDT", "r") as file:
    prjdata = zoomrlib.project.load(file)

print(prjdata.name)
for track in prjdata.tracks:
    print(track.file)
print(prjdata.master.file)

with zoomrlib.open("EFXDATA.ZDT", "r") as file:
    efxdata = zoomrlib.effect.load(file)

print(efxdata.send_reverb_patch_name)
print(efxdata.send_chorus_patch_num)

The package brings a small binary that let you export ZDT file to json:

zoomrlib PRJDATA.ZDT > prjdata.json

Or directly from the library:

python -m zoomrlib PRJDATA.ZDT > prjdata.json

How to contribute

Read the document: DEVELOP.md

Contributors

• Rémy Taymans (@remytms)
• Glenn Boysko (@gboysko)

Other projects using this library

• ZoomProjectReader

Thanks

This library can't exist without the huge work and help of Leonhard Schneider (http://www.audiolooper.de/zoom/home_english.shtml). Thanks for his help. If you are looking to a GUI to manage your Zoom R16 take a look at his project.