ZERROR

DOCUMENTATION

 0. OVERVIEW

 1. SYSTEM REQUIREMENTS

 2. INSTALLATION

 3. ZERROR UI

 4. PARAMETERS

 5. PRESETS

 6. RANDOM PILLS

 7. OFFSET PILLS

 8. RANDOM PILLS PRESET

 9. PLAY PILLS

10. LAYOUT MODE

11. LAYOUTS WIDGET

12. CONVENTIONAL MIDI

13. MIDI SURFACES

14. MIDI FIGTER TWISTER/SPECTRA

15. GLOBAL SETTINGS

16. TIMELINE

17. UPDATE ZERROR

18. LICENSING

19. CHANGELOG

 

 

0. OVERVIEW

Abbreviations:

TD - TouchDesigner

OP - TD's operator

UI - user interface

LMB - left mouse button

RMB - right mouse button

MMB - middle mouse button

[key] - keyboard button

 

 

1. SYSTEM REQUIREMENTS

Windows: Win 10+ modern gaming class machine.

Mac: M1 or higer, macOS 10.14+

TouchDesigner Free/Commercial/Pro, minimum build: 2023.12120

 

 

2. INSTALLATION

Mac and Windows:

1. Download zerror.tox

2. Drop zerror.tox to TD network editor

3. Open Zerror's viewer: right-click on Zerror COMP -> view..

Notes:

Zerror is designed to interact via container's panel in most cases.

Zerror's panel size could be easly changed and adapted to existing UI. Check UI_Integration_tips__ for more details.

Zerror's container remains privatly locked whenever it is free or pro version.

The free version is limited in the number of parameters and presets you can create.

 

 

3. ZERROR UI

Most of operations are performed inside Zerror COMP panel.

In order to get accsess Zerror's panel (as well as any TD's COMP panels): RMB click over OP -> view.. or check UI_Integration_tips__.

Zerror require TD main playbar is playing, TD global cooking is on, Zerror COMP is allowed cooking (all 3 are default for blank projects).

 

Inside Zerror Panel:

LMB to tweek rotary knobs, switch toggle and momentary buttons.

MMB click on knobs to emulate toggle switch over rotary knobs.

RMB click to open knob properties.

Drag RMB over knobs to move it.

Drag RMB over clean background to select multiple knobs and enter Layout mode. Layout mode changes mouse buttons functions to be more similar to TD network editor's workflow.

[P] to open Zerror Settings or Knob Settings

[W] to open Widgets menu.

[H] to enter Layout mode and zoom viewport to all knobs.

[G] to open utils/beta features.

 

 

4. PARAMETERS

Parameter knobs store values.

In most common cases that values are linked to TD's OPs parameters.

 

CREATE PARAMETERS

Drop any OP's parameter to Zerror viewer.

or

Drop OP's parameter group (e.g Translate (tx, ty, tz)) with CTRL/CMD hold to split parameter group into multiple knobs.

 

It is possible to drop multiple selected OP's parameters all at once. In that case hold CTRL to split OP's and ALT to traspose direction. Splitting parameters groups also remains on CTRL/CMD holded key.

 

The created Parameter Knob will be configured according to the operator's parameter, including the value range, type e.t.c.

OP's parameter will be automatically binded to the Knob (by default) or linked via expression (see Global settings)

Current parameter value will be stored across all previously created presets.

 

PARAMETER TYPES

Menu Parameter

Float/Int Parameter

Toogle/Momentary Parameter

 

 

CHAGING PARAMETERS VALUES

Use LMB to tweak parameter

or

type exact value with keyboard:

1. LMB click on knob or select multiple parameters with LMB drag over clean background.

2. Type the value

3. [ENTER] or LMB click anywhere

 

MMB click to switch min/max value or restore default value (depending on MMB action option -> see below).

To change default value: RMB click -> set default value.

 

RECALL PARAMETERS WITH PRESETS

All new parameters are recallable with presets by default.

In order to turn off Parameter recalling - double click LMB on a knob (or right-click -> 'recall' setting).

The color ring around inner circle indicates whether the parameter is recallable or not.

Recallable Parameter

Non recallable Parameter

 

VALUE RANGES

By default parameter knob ranges are set automatically.

Knob ranges could be changed:

RMB click on knob -> min / max settings

In case parameter value is out of knobs range - knob label will become red:

It does not mean any error or incompatibility.

Knob ranges could be forced clamped: RMB click on knob -> clamp min / clamp max setting

 

DELETE PARAMETERS:

Right click on Parameter -> Delete

or

Drag RMB over clean backgound to select 1 or more knobs, press [DELETE] keyboard key.

Linked OP's parameter will be automatically unlinked.

 

PARAMETERS OPTIONS (RMB click on knob):

knob type: change knob type

recall: recall parameter with presets on/off

sensitivity: knob sensitivity, also affects reaction to MIDI encoders events

menu items: for menu parameters only - select menu items with LMB. Drag items with LMB to change order. Shift+LMB to deselect all except clicked one, CTRL+LMB to invvert selection, CTRL+SHIFT+LMB to select all items

min: parameter value at knob fully counterclockwise

max: parameter value at knob fully clockwise

filter: smoothing pararmeter changes, works only with expression linked parameters see Global settings

clamp min/max: clamp parameter value respectively. This covers cases: 1. parameter stored in preset is out of knob range, 2. MIDI encoder events

set default value: set current parameter value as default value

MMB action: choose what happens on MMB click: toggle min/max or restore default value

label: knob label

size: knob size. Knob size also could be adjusted directly in Layout mode

color: knob color. This affects designated colored parts of the knob. In order to change common knobs colors: go to Global settings

show value: display actual parameter value

menu dislay: menu parameters - display menu names or menu labels as knob value

chan: the name of parameter channel. All parameters channels are available at Zerror OP output

show OP: navigate to linked OP inside TD network editor

save to layout: store curent position and size to other layouts. See Layouts widget.

set as default: set current knob settings (like: color, size, knob type, recall, calmp e.t.c) as defaults for new knobs

delete: delete selected knobs

 

 

5. PRESETS

Presets store set of all Parameters values for recalling it.

 

CREATE PRESETS:

Click and drag '+' widget.

New Preset widget

 

If you do not see '+' widget - press [W] key and add it to your workspace.

Created Preset keeps all Parameters knobs values. It keeps raw values, regardless Knobs value ranges.

 

RECALLING PRESETS AND PRESET TYPES:

There are 4 types of recalling presets. Each type has it's visual look. And each Preset Knob could be switched to any of this types (right-click -> knob type):

Morph Preset

Toggle Preset

Momentary Preset

Classic Preset

 

- MORPH(aka FLOAT) PRESET

One of the most important feature of Zerror.

Once you hold down left mosuse butoon (LMB) on it - it captures the current state of Parameters knobs.

As soon as you start turning - it starts partially morph captured state towards the actual preset state.

Reaching fully clockwise - the current preset if fully recalled.

You could break and contnue this process anytime by releasing and holding back LMB.

Any action on another knobs returns last Preset Knob indicator to zero, indicating that new arbitrary state of Parameters Knobs will be captured on new recalling of this preset.

Morph Presets also could act as toggle type by clicking with middle mouse button (MMB) on it.

 

Simplified example:

One paremeter knob PAR1 with 0-1 range and two presets, where P1 recalls PAR1 = 0, and P2 recalls PAR1 = 1:

 

- TOGGLE PRESET

Acts as A/B switch, where A is arbitrary state and B is stored state.

 

- MOMENTARY PRESET

Acts same as Toggle Presets without latching B state.

 

- CLASSIC PRESET

Acts as conventional presets - it recalls parameters states, and that's it.

 

 

DELETE PRESET

Right click on Knob -> Delete

or

LMB click on preset knob - press [DELETE] keyboard key.

or

Drag RMB over clean backgound to select 1 or more presets, press [DELETE] keyboard key.

 

PRESETS OPTIONS (RMB click on knob):

knob type: change preset knob type

sensitivity: knob sensitivity, also affects reaction to MIDI encoders events

recall by color: recall only parameters with specific color (or any color)

recallable only: turn off to ignore "recall" flag of parameter knobs

rand ranges: randomizes the recall ranges for float presets, so that all parameters morph slightly out of sync rather than all at once.

label: knob label

size: knob size. Knob size also could be adjusted directly in Layout mode

color: knob color. This affects designated colored parts of the knob. In order to change common knobs colors: go to Global settings

save preset: override preset with current state

store to presets: appears in Layout mode when presets and parameters selected. This action will store selected parameters values to selected presets

show OP: navigate to linked OP inside TD network editor

save to layout: store curent position and size to other layouts. See Layouts widget.

set as default: set current knob setting as defaults for new knobs

delete: delete selected knobs

 

 

6. RANDOM PILLS

Random pills randomize Parameters values.

 

Create Random pills:

Press [W] to enter Widgets menu.

Drag and drop Random pill.

 

Usage:

There are two types of random pills:

Morph random pill

Momentary random pill

 

To change Pill type: RMB on a Pill -> knob type

 

Morph Random Pill - once you hold down left mouse butoon (LMB) - it captures the current state of Parameters knobs.

As soon as you start turning - it starts partially morph captured state towards random state.

Turning counterclockwise returns Parameters state to the captured on.

Once you reach fully counterclockwise - new random state will be generated for next tweek of the Pill.

 

Momentary Random Pill - instantly randomize Parameters

 

Both Morph and Momentarty pills may affect parameters with specific colors and recall states only by choosing corresponding options from right-click menu: rand by color / rand by recall.

 

RANDOM PILL OPTIONS (RMB click on knob)

knob type: change preset knob type

sensitivity: knob sensitivity, also affects reaction to MIDI encoders events

rand by recall: allows to opererate on recallable/non recallable parameters

rand by color: allows to opererate on parameters with specific color(s)

max rand: maximum randomization (fraction of each parameter knob range)

label: knob label

size: knob size. Knob size also could be adjusted directly in Layout mode

color: knob color. This affects designated colored parts of the knob. In order to change common knobs colors: go to Global settings

save to layout: store curent position and size to other layouts. See Layouts widget.

set as default: set current knob setting as defaults for new knobs

delete: delete selected knobs

 

 

7. OFFSET PILLS

Offset pills offset all of specific Parameters values.

May affect parameters with specific colors and recall states by choosing corresponding options from right-click menu: offset by color / offset by recall.

 

Create Offset pills:

Press [W] to enter Widgets menu.

Drag and drop Offset pill.

 

Offset pill

 

 

SHIFT PILL OPTIONS (RMB click on knob)

sensitivity: knob sensitivity, also affects reaction to MIDI encoders events

shift by recall: allows to affect recallable/non recallable parameters

rand by color: allows to affect parameters with specific color(s)

label: knob label

size: knob size. Knob size also could be adjusted directly in Layout mode

color: knob color. This affects designated colored parts of the knob. In order to change common knobs colors: go to Global settings

save to layout: store curent position and size to other layouts. See Layouts widget.

set as default: set current knob setting as defaults for new knobs

delete: delete selected knobs

 

 

8. RANDOM PILLS PRESET

Random pills presets randomly select preset and recall it.

 

Create Random pills preset:

Press [W] to enter Widgets menu.

Drag and drop Random pill preset.

 

Usage:

There are two types of Random Preset Pills:

Morph random pill preset

Momentary random pill preset

 

 

To change Pill type: RMB on a Pill -> knob type

 

Morph Random Pill Preset - once you hold down left mouse butoon (LMB) - it randomly selects Preset Knob.

As soon as you start turning - it starts partially turn selected Preset.

Turning counterclockwise returns selected Preset towards zero.

Once you reach fully counterclockwise - new random Prest will be selected for next tweek of the Pill.

 

Momentary Random Pill Preset - instantly selects random Preset and recalls it fully.

 

RANDOM PILL PRESETS OPTIONS (RMB click on knob)

knob type: change preset knob type

rand by color: allows to select and recall presets by color

max rand: maximum recalling value for morph presets

sensitivity: knob sensitivity, also affects reaction to MIDI encoders events

label: knob label

size: knob size. Knob size also could be adjusted directly in Layout mode

color: knob color. This affects designated colored parts of the knob. In order to change common knobs colors: go to Global settings

save to layout: store curent position and size to other layouts. See Layouts widget.

set as default: set current knob setting as defaults for new knobs

delete: delete selected knobs

 

 

9. PLAY PILLS

Play pill animates parameters by randomly switching presets.

Play pill is experimental, it's setting and behaviour may slightly change in future updates.

 

Create Play pills:

Press [W] to enter Widgets menu.

Drag and drop Play pill.

 

Usage:

Udjust overall speed with LMB on pill.

Each time an orbiting circle pass 12 o'clock - the next random preset will be selected.

Depending on play pill settings selected preset will be recalled with or without fade.

Fade in time is defined by pill setting.

 

RANDOM PILL OPTIONS (RMB click on knob)

sensitivity: knob sensitivity, also affects reaction to MIDI encoders events

color: knob color. This affects designated colored parts of the knob. In order to change common knobs colors: go to Global settings

rand order: sample presets randomly(1) or sequentially based on it's position(0) or something in between (0-1)

rand by color: allows to sample and recall presets by color

size: knob size. Knob size also could be adjusted directly in Layout mode

period: period time in seconds. Actual period is affected by overall speed adjusted by knob

rand period: randomize period: 0 - no randomize, 1 - actual period is randomly set from 0 to period setting each time orditing circle pass 12 oClock

fade in: fade in time by period fraction

rand fade in: randomize fade in time: 0 - no randomize, 1 - actual fade in is randomly set from 0 to fade in setting each time orditing circle pass 12 oClock

fade curve: fade in curve: linear, easy in, easy out, easy in-out

max value: maximum recalling value for morph presets

rand value: randomize max value recalling value for morph presets

save to layout: store curent position and size to other layouts. See Layouts widget.

set as default: set current knob setting as defaults for new pills

delete: delete selected knobs

 

 

10. LAYOUT MODE

Layout mode designed for quick arrange, align and reorder knobs inside Zerror panel.

To enter Layout mode - start dragging over clean backround with RMB preseed. Release RMB.

Alternatively press [L] or [H].

Backround grid will appear. Mouse buttons functions will slightly change - Layout mode acts similar to TD's network editor:

Mouse scroll - zoom in/out

LMB drag over background - to move around

LMB/RMB drag over knob - move knob

LMB click on knob - select knob

LMB click on backgound - exit Layout Mode

RMB click on knob - select knob and open knob's setiings

RMB drag over backround - select multiple knobs

[H] fit viewport to all knobs.

 

Start dragging RMB over clean background to select multiple knobs.

Arrangement frame will appear.

Dragging arrangement frame corners with LMB or ctrl/alt/shift + LMB allows to quickly arrange multiple knobs in different ways:

- LMB - scale proportionaly

- SHIFT + LMB - scale proportionaly and equalize knob sizes

- ALT/OPTION + LMB - fit to rectangle

- ALT/OPTION + SHIFT + LMB - fit to rectangle and sort by knob type and label

- CTRL + LMB - align to arbitrary grid

- CTRL + SHIFT + LMB - align to arbitrary grid and equalize knob sizes

 

 

11. LAYOUTS WIDGET

Layouts widget allows to define and switch between 3 different knobs layouts. Each layout stores all knobs positions and sizes.

We see 3 common use cases:

1. There are too many knobs created and you could place some of them outside visible area in another layout. Like bank switching on midi controllers.

2. While using MIDI surfaces could also perform action like bank switching.

3. Group knobs differently for different tasks.

Create Layouts widget:

Press [W], drag Layouts widget to Zerror workspace.

Layouts widget

Colored circle dislays current layout: Red, Green or Blue

LMB click to cycle between layouts

Notes

Knobs created in one layout will be placed outside visible area in other layouts. You could find them in other layouts by pressing [H] key.

Selected knobs positions and sizes could be copied to another layout via knob setting -> copy to layout -> click on layout to copy to.

MIDI surfaces and Layouts widget itself are not stored in layouts.

 

 

12. CONVENTIONAL MIDI

Zerror supports conventional MIDI mappings with emprovement features.

Howerever we recommend to use MIDI surfaces for flexibillity especially when large amount of midi mapped knobs required.

Press [M] or [P] -> MIDI to enter MIDI mapping mode.

The rest of the process is conventional:

1. Choose MIDI in devices, tick MIDI out if your device supports feedback.

2. Select knob

3. Tweek MIDI controller

and so on 2,3,2,3....

 

To remove mapping:

Select knob or mapping from list, press [DELETE] button

 

Zerror automatically recognizes encoder and rotary CC. Encoder type CCs are marked in the midi mapping list with dotted circle.

For the rotary CC there are two modes: direct and pickup. The difference is in the beheavour when MIDI value significantly differs from knob position. Direct/pickup modes are defined per device.

Zerror automatically manages TD midi mapping dialog. Howevere you are welcome to manually make changes there without issues.

 

 

13. MIDI SURFACES

MIDI control surfaces designed to significantly enhance and speed up traditional MIDI mappings.

MIDI control surfaces supports: rotary (both endless and single turn) and encoder knobs notes on/off. It could send MIDI messages back to controller.

The idea behind MIDI Surfaces is to quickly "reproduce" your MIDI controller and its layout inside Zerror and simply drag knobs into it.

The benefits:

- clear visual representation of mappend knobs

- reduced number of mouse clicks required to map each knob

- mapping multiple knobs simultaniously

- no need to remember which knob is mapped to particular controller knob/button

- infinite number of virtual banks even with MIDI controllers that do not have it

 

Create MIDI surface:

Press [W], drag MIDI Surface widget to Zerror workspace.

 

For the first time created MIDI Surface requires to be configured accordingly to MIDI controller:

1. RMB click on MIDI Surface label at top left corner of the surface

2. Device -> select you MIDI device

3. Define rows and cols accordigly your controller or as you wish.

4. Click configure - Configure dialog will pop up.

5. Assign sequentially nessasary slots: LMB click on slot -> tweek rotary/button, and so on. In order to simplify the procees: tweek rotary more after assignment to switch to the next slot automatically. Also use keyboard up/down arrow keys if neccessary. It is also not nessasary to assign all slots.

6. Close Configure dialog.

 

Now your MIDI Surface is ready.

Drag and drop Zerror's knobs into surface with RMB or use Layout mode -> assigned knobs will stick to surface slots. Also in case the slot has a midi assignment - small circle will appear at right top of the dropped knob.

It is possible to assign one knob per slot.

 

Virtual banks

To add virtual banks:

RMB click on MIDI Surface label at top left corner of the configured surface -> clone surface

Place new surface in appropriate location.

To switch between banks - LMB click on MIDI Surface label or color circle at top right. Active bank become colored, inactive - monochromatic.

It is also possible to define a specific controller's knob/button for switching banks by mapping bank slot in configure dialog.

 

NOTES:

 

It is a good practice to save configuration files for your MIDI controllers - RMB on MIDI Surface label -> save config.

Next time - to create new MIDI Surface for this device: RMB on MIDI Surface label -> load config

 

You should define MIDI out and cc pickup accordingly to your controller's knobs beheavour.

In most common cases:

- Endless encoder without indication: MIDI out off, cc pickup off

- Endless encoder with indication: MIDI out on, cc pickup off

- Endless rotary with feedback support or indication (e.g AKAI mpd218): MIDI out on, cc pickup off

- Single turn knobs (e.g. Korg NanoCTRL): MIDI out off, cc pickup off or on

 

If you need blank parameters mapped at each MIDI surface's slot: RMB on MIDI Surface label -> fill empty slots.

This is useful when Zerror is used to control device via MIDI.

As an example - any standalone music Synthesizer which supports MIDI control could be easly extended with Zerror's presets and randomizers functiononality via MIDI Surfaces.

 

 

MIDI SURFACE OPTIONS (RMB click on Midi Surface label)

sensitivity: sensitivity for encoder messages

label: Surface label

size: Surface size

color: Surface color. In order to change common colors: go to Global settings

device: MIDI in device. Devices starts with number - are devices alredy assigned in TD MIDI Dialog and the number is ID. Selecting device without ID number - automatically creates new ID in TD dialog and assigns devices

on: tur on/off MIDI Surface

MIDI out: send MIDI messages back to device on/off

cc pickup: rotary knobs messages beheavour when incoming MIDI value significantly differs from knob value

rows and cols: define the shape of the surface

configure: open Configure dialog

create presets: create new preset at the empty slot on incomig MIDI vlaue = 127 (like press a button or fully clockwise rotary)

create pars: create and link new parameter at the empty slot on incomig MIDI vlaue = 127 (like press a button or fully clockwise rotary) and mouse cursor is over TD OPs parameter

fill empty slots: create blank parameter knobs at each empty MIDI-mapped midi slot

clone surface: duplicate selected MIDI Surface

load config: load MIDI Surface configuration from file

save config: save MIDI Surface configuration to file

set as default: save settings as defaults for new MIDI Surfaces

delete: delete selected MIDI Surface

 

 

14. MIDI FIGTER TWISTER/SPECTRA

Zerror natively supports MIDI Fighters (MF) Twister (MFT) and Spectra (MFS) .

Key features: Convinient control surface ,2-way MIDI connection, Infinite banks number, Multiple device support, Automatic configure device, 2-way color following, automatic device assign, special functions

Hardware setup:

Close all apps that uses MF. Connect you MF before start TD. You are able to connect simultaniously as much MF as you have.

 

Create MF Control Surface:

Press [W] to enter widgtes menu.

Drag and drop MIDI Figter Twister/Spectra

Created Surface widget will be assigned to MF automatically. It appears colored in case of success.

For the first time of usage MF with Zerror - MIDI addresses needs to be configured: RMB on a text label at top left of the control surface -> configure.

Note: this will override current MF hardware configuration. It does not affect device firmware. Default config could be restored via original MF utility.

 

Assign knobs:

Drag desired knobs with RMB into MF surface. Assigned knobs will stick to corresponting locations and MF encoders/buttons will light up with correcponding colors.

For multiple knobs assigmen Layout mode is more convinient.

 

Actions on empty slots:

Push MFT encoder or press MFS button to create new preset

In case mouse cursor is located over OP parameter - this action creates and link new parameter

 

Vitual banks

Zerror bypasses MF internal banks and utilize it's own virtual banking system.

To add bank - just add more MF surface.

To switch between banks - press rights side MF buttons 1 or 3. Alternatively - LMB click on MF surface label or color circle at top right. Active bank become colored, inactive - monochromatic.

 

In case of using multiple MF simultaniously - you could define which MF surface belongs to particular MF device:

RMB on MF surface label at top left -> change device property.

 

Side buttons

Both MFT and MFS has side buttons with special Zerror's functions:

 

Left side

Left side buttons performs actions on latest tweeked by MF knob

Button 1: toogle recall on-off parameter/ override preset. To confirm action - push correspondig MFT encoder/ MFS button. Or any other encoder/button to cancel.

Button 2: change knob color

Button 3: delete knob. To confirm action - push correspondig MFT encoder/ MFS button. Or any other encoder/button to cancel.

 

Right side

Button 1: switch to next control surface (aka next bank)

Button 2: cycle layouts, see Layouts widget for more info

Button 3: switch to previous control surface (aka previous bank)

 

 

MIDI Fighters settings menu (RMB click on label at left top corner)

sensitivity: sensitivity for encoder messages

label: Surface label

size: Surface size

color: Surface color. In order to change common colors: go to Global settings

device: MIDI in device. Devices starts with number - are devices alredy assigned in TD MIDI Dialog and the number is ID. Selecting device without ID number - automatically creates new ID in TD dialog and assigns devices

on: tur on/off MIDI Surface

configure: automatically loads controller settings.

create presets: create new preset at the empty slot (push encoder on TWISTER or press button on SPECTRA)

create pars: create and link new parameter at the empty slot (push encoder on TWISTER or press button on SPECTRA) while mouse cursor is over TD OPs parameter

fill empty slots: create blank parameter knobs at each empty slot

set as default: save settings as defaults for new MIDI FIGHTER surface

delete: delete selected MIDI FIGHTER surface

 

 

15. GLOBAL SETTINGS

Press [P] to enter Zerror Global Settings

Global Settings:

WIDGETS: open Widgets dialog

MIDI: open Conventional MIDI dialog

bg color: Zerror viewport backgound color

text color: knob labels color

value color: parameters value color

knob color: knobs base color

active color: knobs inner circle color on mouse down

color palette: change default colors for tagging knobs

day/night: switch between color themes: each color setting above is stored for particular theme

bg TOP: TOP to use as backgound image

bg opacity: bg TOP opacity

bind type: default linking parameters type: bind or expression

global sensitivity: global knobs sensitivity

multi tweak: turn on/off multiple knobs selections and tweaking

split chans: splits Zerror output CHOP while expression linking type is used. This option reduces unnessasary cooks at most circumstances.

OP colors: automatically change OP color when linking parameters, and changing its color tag

menu size: Zerror dialogs size

check updates: check for online updates

 

 

16. TIMELINE

Download Timeline

Timeline-Light is a free and lightweight timeline component for Zerror presets arrangement.

 

USAGE:

 

INITIALIZE:

1. Drop timelineZerrorLight.tox to network editor.

2. Drop Zerror COMP into Timeline viewer or assign Zerror COMP to timeline's Zerrorcomp parameter.

 

KEYFRAMES:

1. Create presets keyframes with RMB click on keyframe panel

2. Select keyframe with LMB click

3. Select multiple keyframes with CTRL/SHIFT + LMB or LMB drag over keyframe panel

4. RMB on selected keyframes to change presets or transition types

5. Adjust keyframes time by dragging with LMB

6. Stretch keyframes' times by dragging with [SHIFT]+LMB

It is possible to copy [CTRL+C] selected presets from Zerror Layout mode and paste [CTRL+V] in timeline.

 

TIME CONTROL:

1. Drag time with LMB over Time transport panel

2. Adgust start/end time by dragging time range circles.

3. Click LOOP button to activate loop mode.

3. Adjust loop start/end by dragging loop range circles.

4. Click PlAY/STOP/REWIND

5. To use external time control - assign CHOP with time channel (in seconds) to External time CHOP parameter, click External time button.

 

TIME NAVIGATION:

1. Click HOME button to Zoom to full time range.

2. Mouse scroll to zoom in/out time

3. Drag with RMB over Time transport panel to move visible time range.

 

SYNC AUDIO/VIDEO:

Drag and drop AUDIO/MOVIE OPs to timeline to automatically assign Timeline's time to file playback and adjust time ranges accordingly.

Or manually - use Timeline's output as a source for index parameter for AUDIO/MOVIE OPs, switch OPs Play Mode parameter to "Specify Index".

17. UPDATE ZERROR

For the new TD projects - simply download and use the latest Zerror.

 

To update zerror in existed project:

1. Press [P] to open Zerror Settings

2. Click 'Check updates' at the bottom -> confirm if updates are available

Or

1. Drop new clean Zerror.tox to network edit

2. Drop old Zerror COMP to new Zerror UpdateZerror parameter.

 

 

18. LICENSING

 

Purchase Zerror Pro:

1. From Zerror panel - press [P]->Licence manager at bottom, follow purchase link.

2. After checkout you will get an email with your License Code, keep it in secure place.

 

Activate:

Internet connection required

1. From Zerror panel - press [P]->Licence manager at bottom.

2. Paste your License Code

3. Click ACTIVATE

 

Transfer License to another machine:

Internet connection required

1. From Zerror panel - press [P]->Licence manager at bottom.

2. Select installed key -> DEACTIVATE

3. Now you could activate your License Code on another machine.

 

Compatibility:

Since Zerror version 5.19 - licences are portable and got a new (v2) format

Newer Zerror versions are compatible with older (v1) licenses

Older Zerror versions are not compatible with v2 licenses.

v1 licences are also transferable via newer Zerrors' License Manager, but older Zerror's will not work with v1 license after transfer.

To simplify all above:

In case the license was purchased after June 13 2024 - be sure to use Zerror v5.19+

In case the license was purchased before June 13 2024 - be sure to use Zerror v5.19+ after transfer it to new machine.

 

Zerror Demo limitations:

Demo version is limited with a number of parameters (5) and presets(5) you could create.

In order to benchmark larger number of knobs you could download sample projects.

Sample projects also represent limitations of projects created with Pro and opened on machines without Pro.

Purchasing Pro license doesn't interrupt current process of using Zerror - no new dowload required, no adittional actions on existed projects required.

 

Important about Zerror licensing:

Single Zerror Pro licence key is valid for single machine.

Single Zerror Pro licence key is valid for all new Zerrror versions during 1 year.

Zerror Pro license is transferrable since Zerror version 5.19

Zerror Pro license will not remove privacy from Zerror COMP.

Zerror Pro is required for creating new parameters and presets

Zerror Pro is not required for creating new widget

Zerror Pro is not required for tweek knobs, or control parameters and presets

In other words: once you ve done TD project with Zerror Pro - you could open and control it on other machines without need to purcase extra license. But creating extra parameters and presets might be limited.

 

 

19. CHANGELOG

zerror 5.389

February 08, 2025

TD build: 2023.12120

sorting improvements

MMB action on multiple parameters

select and tweak multiple parameter knobs

 

zerror 5.379

February 03, 2025

TD build: 2023.12120

bugfix: midiSurface noteOn/Off events not working

New widget: shift pill

bugfixes

Externaldata and Refreshdata parameters.

 

zerror 5.37

January 26, 2025

TD build: 2023.12120

Utils: drop page improvements

New Utility: Convert Bindings To Expressions

 

zerror 5.368

January 23, 2025

TD build: 2023.12120

bugfix: presets recalling few cases

 

zerror 5.367

January 23, 2025

TD build: 2023.12120

bugfix

 

zerror 5.366

January 23, 2025

TD build: 2023.12120

Bugfix: Midi Surface midi cc not full knob range handle

 

zerror 5.365

January 18, 2025

TD build: 2023.12120

Bugfix: 'fill empty slots' not working for Midi Fighters

 

zerror 5.364

January 13, 2025

TD build: 2023.12120

Bugfix: on update

 

zerror 5.363

January 13, 2025

TD build: 2023.12120

Midi Surface: bugfix when knob was mapped as encoder, but actually is not

Presets: rand ranges option randomizes the recall ranges for float presets, so that all parameters morph slightly out of sync rather than all at once.

 

zerror 5.359

January 10, 2025

TD build: 2023.12120

Presets parameters page: improvements

 

zerror 5.358

January 10, 2025

TD build: 2023.12120

Presets parameters page: improvements

 

zerror 5.357

January 10, 2025

TD build: 2023.12120

Presets parameters page: improvements

 

zerror 5.356

January 08, 2025

TD build: 2023.12120

bug fix: rand pill 'rand by recall' didn't work

 

zerror 5.355

January 07, 2025

TD build: 2023.12120

 

zerror 5.354

January 07, 2025

TD build: 2023.12120

Performance optimizations

Recall presets from Zerror parameters page

Midi Surface: performance ptimizations and bug fixes

Midi Fighter Twister: performance ptimizations

More natural behavour of parameters with inverted ranges

UI/UX improvements and fixes

 

zerror 5.218

December 23, 2024

TD build: 2023.12000

bugfix - on drop menu parameters

bugfix: Conventional midi new device assignment

New 'Classic' preset type - it acts as classic presets buttons on most of classic gear or most of software with presets. It only recalls preset without ability to return to previous state (unlike toggle/momentary preset types).

MIDI - better handling note on/off events: Note On with velocity 0 - performs with momentary Knobs only

 

zerror 5.215

December 19, 2024

TD build: 2023.12000

Momentary and toggle parameters act as buttons on incoming MIDI note on/off events, regardless of their 'MMB action' option.

 

zerror 5.214

December 19, 2024

TD build: 2023.12000

glslTop uniform parameters bugfix

 

zerror 5.213

December 19, 2024

TD build: 2023.12000

Labeling improvements

 

zerror 5.212

December 19, 2024

TD build: 2023.12000

Parameters knobs: 'set default value' option - set current value as default value to recall with MMB (in case MMB action is set to recall default value)

hold CTRL/CMD to split parameter group while dropping OP's parameters

 

zerror 5.21

December 16, 2024

TD build: 2023.12000

bugfix: potential fail to update zerror in very rare cases

 

zerror 5.209

December 16, 2024

TD build: 2023.12000

Zerror Settings button added to Right-click menu at top right corner.

Update menu knob labels if changed (which is convinient for custom menu parameters). Since there is no efficient way to monitor menu parameters items changes - zerror updates them while creating new presets or manually via zerror parameters: external -> Update menu labels pulse

Keyboard input improvements

Keyboard input improvements

Presets: 'recall by color' option - recall any (all) color parameters/ same as preset color/ not the same color

Presets: 'recallable only' option - uncheck to ignore parameters' 'recall' flag.

 

zerror 5.205

December 13, 2024

TD build: 2023.12000

Automatically labeling GLSL and GLSLmulti TOP's uniform parameters accordingly it's name

'Add preset' pulse parameter - create presets from outside Zerror UI

 

zerror 5.204

December 03, 2024

TD build: 2023.12000

default settings

bugfix: conventional midi - on delete mapping

MIDI FIGHTERS option: fill empty slots with blank parameters knobs.

Midi Fighters: optional turn on/off create parameter knobs and presets on empty slots

Midi Fighters: banks switch sorted by: (labels, y, x)

Midi Fighters: reduce midi device IDs usage

MidiSurfaces: core optimizations

MidiSurfaces: empty slots incoming midi indication

Midi Note On (as well as Midi Fighter Twister push encoder) - mimics knob's MMB action: min-max/default value

 

zerror 5.198

November 28, 2024

TD build: 2023.12000

bugfix: proper handle constantCHOPs' parameters' names

optional actions on MMB click: min-max or default value

 

zerror 5.197

November 28, 2024

TD build: 2023.12000

New Parameter: external -> next layout

 

zerror 5.196

October 16, 2024

TD build: 2023.12000

touchscreen support

 

zerror 5.195

October 16, 2024

TD build: 2023.12000

bugfix: on layouts switch

 

zerror 5.194

October 15, 2024

TD build: 2023.12000

bugfix: on project fps change

 

zerror 5.193

June 30, 2024

TD build: 2023.11760

parameters: it is possible to swap ranges to inverse the knob behavour

bugfix: create pulse parameters causes errors

 

zerror 5.192

June 14, 2024

TD build: 2023.11760

improvements

 

zerror 5.191

June 14, 2024

TD build: 2023.11760

 

zerror 5.19

June 12, 2024

TD build: 2023.11760

Bugfix: menu parameters with 'recall off' still recalling

Portable Licenses

 

zerror 5.188

May 24, 2024

TD build: 2023.11760

fix: on delete current preset by [DEL]

ctrl+c - copy presets for timeline

preset mixer for external timeline

 

zerror 5.182

May 17, 2024

TD build: 2023.11760

Play pill: rand order setting - sample presets randomly(1) or sequentially based on their positions(0) or something in between (0-1)

 

zerror 5.181

May 15, 2024

TD build: 2023.11760

global settings: bg opacity setting affects Zerror OP panel opacity now

preset recalling core optimization

 

zerror 5.179

May 08, 2024

TD build: 2023.11600

OG label0 removed

 

zerror 5.177

May 07, 2024

TD build: 2023.11600

presets recall momentary pararameters now

G key : copy pars from selected ops -> copy OP parameters values to knobs if matches

play pill: rand by color setting

Random pills: max rand setting

Random pill: on midi notes behavour

Random pill: rand by color setting - randomize parameters with all colors (all), same as pill's color (same), not the same as pill's color (not same)

Random pill: rand by recall setting - randomize both recallable and non-recallable parameter (all), recallable only (recall), non-recallable only(not recall)

Random Pill Preset: rand by color setting- select presets by color: all colors, same as pill colors, not the same as pill colors

Midi Surface: notes out setting - enable/disable sending notes to midi device,

Midi Surface: ignore velocity setting - ignore notes velocities and override with 'velocity' setting value

Midi Surface: rand velocity setting - randomize velocity (0 - no randomize, 1 - max randomize)

G key->GEN RAND PRESETS: bugfix

online update: minor bugfix

MIDI Fighter Spectra: bugfix

 

zerror 5.162

April 04, 2024

TD build: 2023.11600

beta feature: play pill - random animation widget

bugfix: random preset generator dublicates presets

bugfix: wrong TDbuild version check on Update

bugfix: on new preset UI behavour in few cases

 

zerror 5.16

March 31, 2024

TD build: 2023.11600

fixed: MIDI and MIDI surfaces - Intech Studio devices not recognized properly

fixed: MIDI settings lost on update

fixed: MIDI Surfaces broken on update

 

zerror 5.159

March 29, 2024

TD build: 2023.11600

on update - copy menu labels.

MIDI surface with TD NonCommercial bugfix

all knobs: no label -> no label background.

Menu parameters: 'menu display' setting allow to choose what to show as value: menu names or menu labels

 

zerror 5.154

March 20, 2024

TD build: 2023.11600

FIRST PUBLIC RELEASE

 

  

Discord

Support email

Instagram

Terms of use

Privacy policy