Documentation Wiki rss-feed

Building instruments Part 1 - MIDI and AU instruments

Video Part One

  • How to build an audio unit

Video Part Two

  • Connecting your audio unit to the console mixer

Video Part Three

  • Connecting your audio unit to the recorder and scaler
  • How to browse plugins for the audio unit

How to build a new audio unit

Full script (don't forget to adapt Xs and ordinal numbers)

rig create
it to audio unit rig 5 name ify

recorder create
audio unit rig 5 hey
it add

scaler create
audio unit rig 5 hey
it add

audio unit create
audio unit rig 5 hey
it add

audio unit rig 5 recorder listen

auxilliary input 1 to strip position input 1 name ify
auxilliary input 2 to strip position input 2 name ify
auxilliary input 3 to breath input name ify
auxilliary input 4 to controller input name ify
auxilliary input 5 to absolute strip input 1 name ify
auxilliary input 6 to absolute strip input 2 name ify
auxilliary input 7 to pedal input 1 name ify
auxilliary input 8 to pedal input 2 name ify
auxilliary input 9 to pedal input 3 name ify
auxilliary input 1 0 to pedal input 4 name ify

auxilliary output 1 to strip position output 1 name ify
auxilliary output 2 to strip position output 2 name ify
auxilliary output 3 to breath output name ify
auxilliary output 4 to controller output name ify
auxilliary output 5 to absolute strip output 1 name ify
auxilliary output 6 to absolute strip output 2 name ify
auxilliary output 7 to pedal output 1 name ify
auxilliary output 8 to pedal output 2 name ify
auxilliary output 9 to pedal output 3 name ify
auxilliary output 1 0 to pedal output 4 name ify

all join

kgroup X hey
output X create

kgroup X output X to audio unit rig 5 recorder connect
audio unit rig 5 recorder to audio unit rig 5 scaler connect
audio unit rig 5 scaler to audio unit rig 5 audio unit connect

audio unit rig 5 recorder roll output to audio unit rig 5 scaler k pitch bend input connect

talker kgroup X hey
output X create

audio unit rig 5 audio unit hey
all channel to 2 set

audio unit rig 5 audio unit
left audio output to console mixer channel 1 7
left audio input connect

audio unit rig 5 audio unit
right audio output to console mixer channel 1 7
right audio input connect

metronome to audio unit rig 5 recorder connect
metronome to audio unit rig 5 audio unit connect

audio unit rig 5 recorder hey
scheduler 1 use

audio unit rig 5 recorder strip position output 1 to audio unit rig 5 audio unit parameter 1 connect
audio unit rig 5 audio unit parameter 1 to strip position 1 name ify
audio unit rig 5 recorder strip position output 2 to audio unit rig 5 audio unit parameter 2 connect
audio unit rig 5 audio unit parameter 2 to strip position 2 name ify
audio unit rig 5 recorder breath output to audio unit rig 5 audio unit parameter 3 connect
audio unit rig 5 audio unit parameter 3 to breath name ify
audio unit rig 5 scaler pressure output to audio unit rig 5 audio unit parameter 5 connect
audio unit rig 5 audio unit parameter 5 to key pressure name ify
audio unit rig 5 scaler roll output to audio unit rig 5 audio unit parameter 6 connect
audio unit rig 5 audio unit parameter 6 to key roll name ify
audio unit rig 5 scaler yaw output to audio unit rig 5 audio unit parameter 7 connect
audio unit rig 5 audio unit parameter 7 to key yaw name ify
audio unit rig 5 recorder pedal output 1 to audio unit rig 5 audio unit parameter 8 connect
audio unit rig 5 audio unit parameter 8 to pedal 1 name ify
audio unit rig 5 recorder pedal output 2 to audio unit rig 5 audio unit parameter 9 connect
audio unit rig 5 audio unit parameter 9 to pedal 2 name ify
audio unit rig 5 recorder absolute strip output 1 to audio unit rig 5 audio unit parameter 1 0 connect
audio unit rig 5 audio unit parameter 1 0 to absolute strip 1 name ify
audio unit rig 5 recorder absolute strip output 2 to audio unit rig 5 audio unit parameter 1 1 connect
audio unit rig 5 audio unit parameter 1 1 to absolute strip 2 name ify
audio unit rig 5 recorder pedal output 3 to audio unit rig 5 audio unit parameter 1 2 connect
audio unit rig 5 audio unit parameter 1 2 to pedal 3 name ify
audio unit rig 5 recorder pedal output 4 to audio unit rig 5 audio unit parameter 1 3 connect
audio unit rig 5 audio unit parameter 1 3 to pedal 4 name ify
audio unit rig 5 scaler pressure output to audio unit rig 5 audio unit parameter 1 6 connect
audio unit rig 5 audio unit parameter 1 6 to key position name ify

Detailed explanations including Belcanto

Note that the instructions below combine information from this seminar together with later ones to give you the full picture about how to build a functioning audio unit instrument.

1214 111
rig create

66 23 1118 8728 1214 15 123 74
it to audio unit rig 5 name ify

768 111
recorder create

1118 8728 1214 15 5
audio unit rig 5 hey

66 62
it add

147 111
scaler create

1118 8728 1214 15 5
audio unit rig 5 hey

66 62
it add

1118 8728 111
audio unit create

1118 8728 1214 15 5
audio unit rig 5 hey

66 62
it add

Rename the recorder inputs and outputs so that connections are all done automatically (explained in a next seminar):

1118 8728 1214 15 768 1131
audio unit rig 5 recorder listen

4452 116 11 23 133 1464 116 11 123 74
auxilliary input 1 to strip position input 1 name ify

4452 116 12 23 133 1464 116 12 123 74
auxilliary input 2 to strip position input 2 name ify

4452 116 13 23 134 116 123 74
auxilliary input 3 to breath input name ify

4452 116 14 23 1775 116 123 74
auxilliary input 4 to controller input name ify

4452 116 15 23 8735 133 116 11 123 74
auxilliary input 5 to absolute strip input 1 name ify

4452 116 16 23 8735 133 116 12 123 74
auxilliary input 6 to absolute strip input 2 name ify

4452 116 17 23 161 116 11 123 74
auxilliary input 7 to pedal input 1 name ify

4452 116 18 23 161 116 12 123 74
auxilliary input 8 to pedal input 2 name ify

4452 116 21 23 161 116 13 123 74
auxilliary input 9 to pedal input 3 name ify

4452 116 11 22 23 161 116 14 123 74
auxilliary input 1 0 to pedal input 4 name ify

4452 125 11 23 133 1464 125 11 123 74
auxilliary output 1 to strip position output 1 name ify

4452 125 12 23 133 1464 125 12 123 74
auxilliary output 2 to strip position output 2 name ify

4452 125 13 23 134 125 123 74
auxilliary output 3 to breath output name ify

4452 125 14 23 1775 125 123 74
auxilliary output 4 to controller output name ify

4452 125 15 23 8735 133 125 11 123 74
auxilliary output 5 to absolute strip output 1 name ify

4452 125 16 23 8735 133 125 12 123 74
auxilliary output 6 to absolute strip output 2 name ify

4452 125 17 23 161 125 11 123 74
auxilliary output 7 to pedal output 1 name ify

4452 125 18 23 161 125 12 123 74
auxilliary output 8 to pedal output 2 name ify

4452 125 21 23 161 125 13 123 74
auxilliary output 9 to pedal output 3 name ify

4452 125 11 22 23 161 125 14 123 74
auxilliary output 1 0 to pedal output 4 name ify

63 1181
all join

To connect keygroups to the recorder say:

error ? 5
Error X hey

125 ? 111
output X create

error ? 125 ? 23 1118 8728 1214 15 768 61
Error X output X to audio unit rig 5 recorder connect

1118 8728 1214 15 768 23
audio unit rig 5 recorder to
1118 8728 1214 15 147 61
audio unit rig 5 scaler connect

1118 8728 1214 15 147 23
audio unit rig 5 scaler to
1118 8728 1214 15 1118 8728 61
audio unit rig 5 audio unit connect

Connect the pitch bend input of the scaler:

1118 8728 1214 15 768 131 125 23
audio unit rig 5 recorder roll output to
1118 8728 1214 15 147 error 2314 2317 116 61
audio unit rig 5 scaler Error pitch bend input connect

For the lights to show up correctly, also create a talker kgroup output (see next seminar):

4322 error ? 5
talker Error X hey

125 ? 111
output X create

(note that the talker kgroup always has a 4x5 layout so the output position is possibly different)

To make this stereo:

1118 8728 1214 15 1118 8728 5
audio unit rig 5 audio unit hey

63 1122 23 12 67
all channel to 2 set

To connect this audio unit to the mixer say (make sure you check for available channels through the mixer browser first):

1118 8728 1214 15 1118 8728
audio unit rig 5 audio unit
118 1118 125 23 8727 1132 1122 11 17
left audio output to console mixer channel 1 7
118 1118 116 61
left audio input connect

1118 8728 1214 15 1118 8728
audio unit rig 5 audio unit
121 1118 125 23 8727 1132 1122 11 17
right audio output to console mixer channel 1 7
121 1118 116 61
right audio input connect

Some final housekeeping:

52 23 1118 8728 1214 15 768 61
metronome to audio unit rig 5 recorder connect

52 23 1118 8728 1214 15 1118 8728 61
metronome to audio unit rig 5 audio unit connect

1118 8728 1214 15 768 5
audio unit rig 5 recorder hey

243 11 75
scheduler 1 use

Connect the scaler and recorder outputs to the audio unit parameter inputs for the routing matrix (covered in a later seminar)

1118 8728 1214 15 768 133 1464 125 11 23
audio unit rig 5 recorder strip position output 1 to
1118 8728 1214 15 1118 8728 8731 11 61
audio unit rig 5 audio unit parameter 1 connect
1118 8728 1214 15 1118 8728 8731 11 23
audio unit rig 5 audio unit parameter 1 to
133 1464 11 123 74
strip position 1 name ify
1118 8728 1214 15 768 133 1464 125 12 23
audio unit rig 5 recorder strip position output 2 to
1118 8728 1214 15 1118 8728 8731 12 61
audio unit rig 5 audio unit parameter 2 connect
1118 8728 1214 15 1118 8728 8731 12 23
audio unit rig 5 audio unit parameter 2 to
133 1464 12 123 74
strip position 2 name ify
1118 8728 1214 15 768 134 125 23
audio unit rig 5 recorder breath output to
1118 8728 1214 15 1118 8728 8731 13 61
audio unit rig 5 audio unit parameter 3 connect
1118 8728 1214 15 1118 8728 8731 13 23
audio unit rig 5 audio unit parameter 3 to
134 123 74
breath name ify
1118 8728 1214 15 147 128 125 23
audio unit rig 5 scaler pressure output to
1118 8728 1214 15 1118 8728 8731 15 61
audio unit rig 5 audio unit parameter 5 connect
1118 8728 1214 15 1118 8728 8731 15 23
audio unit rig 5 audio unit parameter 5 to
114 128 123 74
key pressure name ify
1118 8728 1214 15 147 131 125 23
audio unit rig 5 scaler roll output to
1118 8728 1214 15 1118 8728 8731 16 61
audio unit rig 5 audio unit parameter 6 connect
1118 8728 1214 15 1118 8728 8731 16 23
audio unit rig 5 audio unit parameter 6 to
114 131 123 74
key roll name ify
1118 8728 1214 15 147 132 125 23
audio unit rig 5 scaler yaw output to
1118 8728 1214 15 1118 8728 8731 17 61
audio unit rig 5 audio unit parameter 7 connect
1118 8728 1214 15 1118 8728 8731 17 23
audio unit rig 5 audio unit parameter 7 to
114 132 123 74
key yaw name ify
1118 8728 1214 15 768 161 125 11 23
audio unit rig 5 recorder pedal output 1 to
1118 8728 1214 15 1118 8728 8731 18 61
audio unit rig 5 audio unit parameter 8 connect
1118 8728 1214 15 1118 8728 8731 18 23
audio unit rig 5 audio unit parameter 8 to
161 11 123 74
pedal 1 name ify
1118 8728 1214 15 768 161 125 12 23
audio unit rig 5 recorder pedal output 2 to
1118 8728 1214 15 1118 8728 8731 21 61
audio unit rig 5 audio unit parameter 9 connect
1118 8728 1214 15 1118 8728 8731 21 23
audio unit rig 5 audio unit parameter 9 to
161 12 123 74
pedal 2 name ify
1118 8728 1214 15 768 8735 133 125 11 23
audio unit rig 5 recorder absolute strip output 1 to
1118 8728 1214 15 1118 8728 8731 11 22 61
audio unit rig 5 audio unit parameter 1 0 connect
1118 8728 1214 15 1118 8728 8731 11 22 23
audio unit rig 5 audio unit parameter 1 0 to
8735 133 11 123 74
absolute strip 1 name ify
1118 8728 1214 15 768 8735 133 125 12 23
audio unit rig 5 recorder absolute strip output 2 to
1118 8728 1214 15 1118 8728 8731 11 11 61
audio unit rig 5 audio unit parameter 1 1 connect
1118 8728 1214 15 1118 8728 8731 11 11 23
audio unit rig 5 audio unit parameter 1 1 to
8735 133 12 123 74
absolute strip 2 name ify
1118 8728 1214 15 768 161 125 13 23
audio unit rig 5 recorder pedal output 3 to
1118 8728 1214 15 1118 8728 8731 11 12 61
audio unit rig 5 audio unit parameter 1 2 connect
1118 8728 1214 15 1118 8728 8731 11 12 23
audio unit rig 5 audio unit parameter 1 2 to
161 13 123 74
pedal 3 name ify
1118 8728 1214 15 768 161 125 14 23
audio unit rig 5 recorder pedal output 4 to
1118 8728 1214 15 1118 8728 8731 11 13 61
audio unit rig 5 audio unit parameter 1 3 connect
1118 8728 1214 15 1118 8728 8731 11 13 23
audio unit rig 5 audio unit parameter 1 3 to
161 14 123 74
pedal 4 name ify
1118 8728 1214 15 147 128 125 23
audio unit rig 5 scaler pressure output to
1118 8728 1214 15 1118 8728 8731 11 16 61
audio unit rig 5 audio unit parameter 1 6 connect
1118 8728 1214 15 1118 8728 8731 11 16 23
audio unit rig 5 audio unit parameter 1 6 to
114 1464 123 74
key position name ify

To Browse for a plugin say (note that the EigenBrowser must be opened first):

8777 5
eigenbrowser hey

1118 8728 1214 15 1118 8728 8741 413
audio unit rig 5 audio unit plugin browse