Key concepts

Instance

Helgobox is an instrument plug-in. That means you can add multiple instances of it, just as you would add multiple instances of a synth or effect. For example, you could place one instance on the monitoring FX chain and two instances somewhere in your project.

Instance ID

A randomly assigned, non-persistent identifier that identifies a particular Instance and is guaranteed to be unique within one REAPER session.

This ID can change after a restart of REAPER! If you are looking for something that doesn’t change, use the Instance key.

Instance key

A user-defined, persistent identifier that identifies a particular Instance. The instance key gets relevant if you want to connect to an instance from an Helgobox App running in Remote mode.

You can change the instance key of an instance by changing the Unit key of the instance’s main unit — they are the same.

Make your instance keys unique!
Because the instance key is user-defined, uniqueness can’t be guaranteed. For example, if you just copy and paste a Helgobox FX instance, you end up with two instances that have the same key. You should avoid this.