a free articulation management system for REAPER
In the alpha preview of Reaticulate, there is no GUI for creating custom banks. It'll come, but for now, you'll need to understand the nitty gritty on this page.
Reaticulate directly manages REAPER's assigned global Reabank file, which it dynamically assembles from both the distributed factory banks and your own custom banks. Relative to REAPER's resource directory (which you can find by invoking the REAPER action "Show REAPER Resource path"), these files are:
(Reaticulate combines these files into a file it manages called
You'll never edit this file directly, but it's what Reaticulate feeds back to REAPER to use as
the default reabank file.)
You can take a look at the factory banks for inspiration, but if you want to start slinging
your own custom articulation banks, the easiest way is to click the pencil button at the
top of the UI and open the file in your editor. Clicking this will create the file if
necessary before opening the editor. Open in Default App will launch whatever application
you've associated with
Once you save changes to the file, click the reload button (next to the pencil) to force Reaticulate to pick up the changes.
Let's take a look at the normal REAPER reabank file. The standard format is:
Bank <MSB> <LSB> <Bank name> <program #> <articulation name>
Bank 65 1 Spitfire Symphonic Brass - Horn Solo 20 legato 1 long 52 marcato 50 tenuto 40 staccato 100 rip 101 fall 70 trill m2 71 trill M2
The two numbers on the Bank line indicate the MSB and LSB of the MIDI bank. These values are between 0 and 127 and are somewhat arbitrary, as long as the pair is unique to the REAPER instance. Following that is an arbitrary name for the bank.
User banks must use MSBs from 0 to 63. MSB of 64 and above are reserved for factory banks.
Each subsequent line (until the next Bank line) specifies the programs for the bank. The number is the MIDI Program Change event number (which is technically arbitrary but see the Program Numbers section below for some advice), and the description is, in our case, the name of the articulation.
Reaticulate extends Reabank files by adding special notations on lines starting with
Let's revisit the above example bank, now notated for Reaticulate, and how this bank looks in the GUI:
//! g="Spitfire/Symphonic Brass" n="Horn Solo" //! m="Set patch to UACC" Bank 65 1 SSB - Horn Solo //! c=legato i=legato o=cc:32,20 20 legato //! c=long i=note-whole o=cc:32,1 1 long //! c=short i=marcato-quarter o=cc:32,52 52 marcato //! c=short i=tenuto-eighth o=cc:32,50 50 tenuto //! c=short i=staccato o=cc:32,40 40 staccato //! c=short-dark i=rip o=cc:32,100 100 rip //! c=short-dark i=rip-downward o=cc:32,101 101 fall //! c=long i=trill-min2 o=cc:32,70 70 trill m2 //! c=long i=trill-maj2 o=cc:32,71 71 trill M2
Notated attributes take the form
name="value" if the value contains spaces)
and are separated by whitespace. The line(s) prefixed with
//! immediately preceding the
uncommented line will annotate it with the supplied attributes.
When an articulation is triggered, Reaticulate will emit the MIDI output events defined by
o attribute (see below). In the above example, each articulation sends a single MIDI
event: CC 32 with a value defined by the second argument. The expectation for this factory bank
is that the Spitfire Horns Solo patch be set to UACC (a feature of the patch itself).
These are the supported attributes for Bank lines. Attributes are optional unless specifically marked as required.
||Group name separated by slashes. Used to build a menu hierarchy for the bank. Generally should be Vendor/Product.|
|n||The name of the patch the bank describes. If not specified, the Reabank name is used.|
|clone||Clones the articulations from the referenced bank, specified as a fully qualified bank name (i.e. the groupname/bankname format), to the current bank which contains the clone attribute. The cloned articulations will appear after any articulations explicitly defined in the current bank.|
|off||For articulations with note-hold outputs, this defines the "default program" when no note-hold articulation is active. The GUI will show this program as active when a manually triggered note-hold keyswitch is released. When this articulation is explicitly activated via Reaticulate, it will cause any active note-hold articulation to be released.|
Default articulation flags. Most can be overridden per articulation. Is a comma-delimited list of one
or more of the options below. Any option can be prefixed with
|chase||Comma-delimited list of CCs (or CC ranges) that should be chased when CC chasing is enabled for an articulation (as is default). For example: 1,2,5,11-21,92-120. (Default: 1,2,11,64-69)|
|m||A custom message displayed in the track configuration page and optionally the main articulation list screen. This usually provides some special instructions about how to configure the virtual instrument to be compatible with the bank, or other performance details.|
Programs can be decorated with these attributes:
||Articulation icon name. See Articulation Icons section below for possible names.|
|n||Overrides the articulation name for display in the articulation list in the Reaticulate UI. Program events as seen in the MIDI editor will use the program name specified on the uncommented line.|
Color for the articulation button. Either the name of a color (see the
Articulation Colors section below)
or an HTML hex-style color in the form
|f||Articulation flags as defined above. (Overrides the defaults set at the bank level.)|
A group number between 1 and 4 (defaults to 1 if not specified). Only one articulation within a
group may be active at a time.
For consistency, it is recommended that you use group 1 for the main set of articulations.
One or more output events that describe the action taken when the articulation is triggered.|
Inserts some padding above the articulation when displayed in Reaticulate's main
articulation list screen.|
|transpose||A value between -127 and 127 which defines how many pitches incoming notes should be transposed after the articulation is activated.|
|velocity||A multiplier between 0.00 and 10.00 (up to 2 decimals of precision) that will be applied to incoming note velocities. The note-off velocity (if it exists -- it's quite rare) will also be multiplied by this value.|
A value in the form
A value in the form
Although the program numbers are arbitary and don't influence any specific behavior, some
form of standardization is recommended because this allows using the
Reaticulate_Activate articulation by CC actions to trigger a given articulation (or
at least its closest approximation) from a control surface, tablet, etc., no matter the
Reaticulate's factory banks will conform as closely as possible to Spitfire's UACC specification.
So, for example, by consistently using program 42 to map to spiccato, or some similar very short articulation, you could have a control surface send CC value 42 (via a CC number of your choice bound to the Activate Articulation action) to set spiccato, no matter what track is selected.
This section is a bit nerdy. It's quite necessary to understand to build your own banks, but don't worry, there are some more approachable examples later.
Programs can trigger up to 16 output events, specified by the
o attribute, which
ultimately describe the articulation's behavior.
Output events can be used to send a MIDI event to the virtual instrument to cause the underlying patch to change articulations, or even just to set up routing to some destination MIDI channel. Or both: you can have a program send a MIDI event to a specific channel, and subsequently performed MIDI will be routed to that channel.
Multiple output events are separated by a
/ (forward slash) where each individual
output event roughly takes the form
type@channel:arg1,arg2 (no whitespace allowed).
A more formal specification for a single output event would look like this:
Where elements enclosed in square brackets are optional, and where:
Output events prefixed with
- don't affect the routing of future MIDI events. Otherwise, if channels
are not prefixed this way then any future user-generated MIDI event will be routed to this channel when
the articulation is activated.
type defines the type of output event (see below), e.g. note, cc, etc.
@channel specifies the destination MIDI channel of the output event and, unless
-, it implies subsequent MIDI events will also be routed to that destination
When channel is not specified, the destination channel will be dictated by the destination channel the defined by the user when the bank was configured on the track. (See the usage page for more information on source and destination channels.)
Alternatively, a special channel value of
- will direct the output event to
the destination(s) setup by the previously activated articulation.
.bus specifies the destination bus of the output event and subsequent incoming
events when the articulation is activated.
bus is a value between 1 and 16.
As with the channel, if not specified the default bus will be dictated by the
destination bus for the bank's track configuration. If the bus is defined but
not the channel (e.g.
@.4) then then the default channel will be used but
the bus will be overridden.
If you use Reaticulate's MIDI controller feedback feature, you won't be able to assign bus 16 as this bus is used by the feedback feature internally.
arg2 depend on the type
%filter_program if defined will only emit the output event if the specified program number
filter_program is currently active on the same channel in another group. This allows
the state of other groups to modify the output events emitted by the articulation.
For example, you might have an articulation group that specifies normal attack vs hard attack with different programs. A single sustain articulation could then emit different keyswitches depending on whether the normal or hard attack is selected in the group.
Possible output event types are:
|program||Program change message.
|cc||A CC event, with
|note||A sequence of note-on and note-off events, where
|note-hold||A note-on event, where
|pitch||A pitch bend event, where
|art||Activate another articulation in the same bank, with
Be aware that if multiple
note output events are specified for a given articulation, all note-on
events will be sent before any note-off event. This means as far as the target patch is concerned
the notes will be simultaneously pressed. This is also true for
note-hold events, except that
of course in that case all the necessary note-off events will be deferred until the next articulation.
type can also be empty, specifying just
@channel, in which case the action of the
articulation will just be to set up routing to the destination channel specified, with no MIDI event
Alternatively, if the type is prefixed with a
- sign (e.g.
-note) then the output event is
emitted but routing of subsequent user MIDI events to the output event's destination channel
will not be done. This can be useful for example to send control events to listeners on other
channels. If all the output events for the articulation are prefixed this way, then the
destination channel routing setup by the previous articulation won't be altered.
Ok, with the technicals out of the way, here are some examples.
This one from Cinematic Studio Strings sends 3 separate notes at specific velocities to set sordino and legato in addition to the sustains patch.
//! c=long-light i=con-sord o=note:12/note:22,1/note:23,127 7 con sordino
A generic example where we have 3 individual articulation patches on 3 separate MIDI channels and we want to do simple routing only: no keyswitches needed by the underlying virtual instrument.
//! c=legato i=legato o=@1 20 legato //! c=long i=note-whole o=@2 1 sustains //! c=short i=staccato o=@3 40 staccato
Here's another one from Cinematic Studio Strings, setting up spiccato without sordino. The twist is the "beefy spiccato" program, where we are setting CSS as with spiccato but also layering it with another patch on channel 2.
//! c=short i=spiccato o=note:17,1/note:23,1 42 spiccato //! c=short-dark i=spiccato o=note:17,1/note:23,1/@2 44 beefy spiccato
Now for a more sophisticated example: an excerpt from the Bohemian violin bank. This instrument controls legato by a single note toggle keyswitch (hitting the same note repeatedly toggles legato), so this is in its own group.
Most of the articulations in the Bohemian are only active while the note is held, and once the note
is released, it defaults back to an intelligent, adaptive mode which VirHamonic calls the Performer.
So the trick here is to specify an
off program for the bank (we arbitrarily choose 0) which
describes the default mode of the Bohemian when no articulations are explicitly chosen.
Finally, the last 3 programs define the Performer styles, and unlike the others, these ones are
latching keyswitches, so we use the
note type for these.
//! g="VirHarmonic/Bohemian Violin" n="Expansion 1" off=0 Bank 42 7 Bohemian Violin Exp1 //! c=long-dark i=note-whole g=2 f=toggle o=note:35 35 chords //! spacer=1 //! c=long-light i=phrase 0 performer //! c=long i=note-half o=note-hold:24 24 arc //! c=long-light i=legato-bowed2 o=note-hold:41 41 rebow //! spacer=1 //! c=fx i=phrase g=3 o=note:48 48 improv //! c=fx i=phrase g=3 o=note:49 49 czardas //! c=fx i=phrase g=3 o=note:50 50 emotive
This example also uses the
spacer attribute to provide a visual separation between the groups.
Suppose a trumpet library offered a number of different articulations with different types of mutes (no mute, straight mute, or harmon mute), with each variant being available under a different patch.
The obvious approach would be to create different articulations for each of the normal vs hard attack variants. This is a perfectly cromulent strategy to be sure, but by using filter programs you could move the hard/normal attack flag to a group and use only a single program for each articulation even if it offers all three variants.
Here we we have the three different patches for the different mute types on different MIDI channels. A single articulation definition can route to the appropriate patch depending on which mute articulation is selected.
//! c=long i=note-whole g=2 120 unmuted //! c=long-light i=stopped g=2 121 straight mute //! c=long-light i=stopped g=2 122 harmon mute //! c=long i=note-whole o=note@1:24%120/note@2:24%121/note@3:24%122 1 long //! c=short i=staccato o=note@1:27%120/note@2:27%121/note@3:27%122 40 staccato //! c=short i=marcato-quarter o=note@1:28%120/note@2:28%121/note@3:28%122 52 marcato
This bank uses programs 120-122 to define the different mute types. Notice there aren't any output events with these articulations -- they don't actually emit any outputs directly, but rather they influence the output events emitted by the long and staccato articulations.
Changing one of the mute types will retrigger long or staccato (whichever is selected) and cause the appropriate output event to be emitted for the new mute type.
c program attribute defines the color of the button for the articulation, which is either
a HTML color code or one of the predefined names. When
specified, then the default color is used.
The image right shows the available names and their out-of-the-box colors.
(The icons shown are just for demonstration purposes. The color selection has no bearing on the
icon. That's defined by the
The factory banks use the light variants for articulations played more softly or subdued than normale, for example con sordino, sul tasto, or harmonics. The dark variants are used for grittier, distorted, or louder articulations, such as sul ponticello or Bartok pizzicato.
These color names can be overridden by specifying a
color attribute anywhere in your user
Reabank file (path #2 listed at the top of this page), whose value is a comma-delimited list
name=#hexcode items. For example, this line overrides the default and fx colors:
Here are the current icon names that may be assigned to the