MIDI
External MIDI devices can be integrated into Atrium’s mapping system, providing remote control over its parameters or tagalong buddies in clocked step.

Getting connected
Atrium has three hardware options for sending & receiving MIDI messages:
- USB-A port: Connect an external controller via the USB-A port on the rear panel. Use your favorite knob box, MIDI keyboard, or sequencer! Up to 900mA of power is provided -- enough for most controllers.
-
USB-C port: Atrium will appear as a MIDI device (named "Atrium") on a connected computer. Exchange messages with your favourite DAW or other MIDI-enabled environment.
-
TRS-MIDI: Hardware MIDI devices can connect over TRS-MIDI via the midi in and midi out 3.5mm jacks (on the rear panel). midi in automatically accepts either type A or type B connections. midi out uses the more common type A pinout. If your device uses 5-pin DIN cables, you'll need adaptors.
When powering Atrium from a computer's USB port, the MIDI connection is available over this same cable. Otherwise, attach a cable to the computer port to communicate.
MIDI Input
Available are a few different classes of MIDI messages, as well as different workflows. Each set has it's own implications for use: note takeover dramatically changes the impact of Atrium's controls, while clock and CC input are a more natural fit into the map-centric workflow.
MIDI Input Channel
By default, Atrium listens to incoming MIDI on all channels, but you can change it to a specific channel (1 through 15) if you have a complex multi-device MIDI chain.
- To change the MIDI channel globally, open Foam and navigate to the Settings page to adjust the 'MIDI input channel'. This sets Atrium's default channel, but it can be customized on a per-patch basis if desired.
- To change the MIDI channel per-patch, press midi to enter the on-board MIDI input settings and then use the black gesture key to cycle through the options (beginning with all/omni through channel 15).
- If you wish to clear the per-patch selection and use the default global setting, press midi to enter the on-board MIDI input settings and then hold clear & press the black gesture key.
Note that MIDI clock input has no channel, so it is always accepted from any source.
Notes
Atrium intentionally has no keybed, as a fundamental part of its design is the decoupling of pitch and envelope. However, we value recycling virtuosity and keeping Atrium approachable in many situations that call for direct note control – so, MIDI note control has two flavors: traditional and scale takeover.
The former couples note allocation and sustain articulation (though these signals can be reassigned), while the latter allows you to use MIDI notes to reshape the instrument's inherent notespace gestures.
Traditional
To treat Atrium as a more-traditional "desktop synthesizer", you'll want to enable note control. This modal setting will take over note allocation, and sustain articulation.
Enter the MIDI input settings:
- Press midi.
You'll see the interface go blank, apart from an X in the scale window & a dimly lit metronome.
Make sure to experiment with glide with MIDI, it's super fun.
Press scale to cycle through the voice allocation options:
Xmeans no "takeover" is performed (this is the normal state).Pstands for "polyphonic", accepting MIDI messages to dynamically allocate pitches & articulate them with sustain.Uswitches to "unison" mode, where all five voices are addressed by the most recent MIDI note.
Once you've selected your note allocation style, press midi to return to normal usage.
You'll notice a few things have changed:
- notes and chord are disabled.
- Playing notes on the keyboard will update the notes display.
- sustain will be opened according to the velocity of your played notes.
- scale will be blank, indicating "unquantized" mode.
But many things have not changed, and that's great! You can move around octaves, add glide to your notes, and even adjust voicing (in the downward direction) for some surprising voice spreading. Existing mappings to note and chord will still apply which can be quite confusing if you're not sure what's going on.
Map the tiniest amount of lfo to notes and spread out the voices with phase (sine is a great shape to start with). With polyphonic play you'll get that vintage warble, while unison becomes a massive drifting swarm. Add some glide and you'll be in bassline heaven.
While scale is disabled when entering a MIDI note mode, you can re-enable quantization by tapping scale. This can be helpful to stay in key, or provide a new interface into a "sequence" style scale.
Atrium can clear any sustained MIDI notes, intentional or otherwise, through either of these two methods:
- From your controller, send Atrium CC 123 with a value of 0 (this is known as a 'MIDI panic' signal). Or...
- On Atrium, hold clear and press midi.
Scale Takeover
While the "traditional desktop synthesizer" approach described above can be a great way to quickly get specific melodic ideas voiced on Atrium, we can also use incoming MIDI notes as a supplement to Atrium's natural notewise expansiveness – by using incoming MIDI notes to simply re-define the current scale, allowing Atrium to run full-force beyond traditions.
From the Scale Editor
- Enter the Scale Editor (tap! tap!).
- Press link to toggle "MIDI → scale" mode.
- Play a chord or sequence of keys when "MIDI → scale" is enabled to overwrite the current scale with your MIDI input.
- This setting persists if you exit the Scale Editor, and its state saves with your patch.
Make sure your MIDI source is on the same channel as your patch's MIDI input channel!
Via MIDI Channel 16
MIDI Channel 16 is reserved for special control over Atrium and any MIDI note messages sent over this channel will overwrite the current scale with your input.
Since this approach is "always-on" via MIDI Channel 16, you can easily combine it with the "traditional" MIDI note method on another channel for two types of play!
For more playing tips, visit Scales.
Remapping
v1.5 To use the pitch and velocity of incoming MIDI notes as map sources:
- Press midi.
- Hold map and either press chord (to map incoming MIDI pitch) or press loop (to map incoming MIDI velocity).
- Dial-in the intensity of the effect incoming MIDI pitch/velocity has on the desired parameters.
- Optional: disable the default mapping of incoming MIDI pitch on notes, or the default mapping of incoming MIDI velocity on sustain.
Sustain (CC 64)
MIDI CC 64 holds special significance as a 'sustain' signal, holding all played & playing notes until its release. In situations where you've connected a MIDI keyboard to Atrium, this allows you to take your fingers off the keys and keep the sounding voices active.
- If CC 64 is sent with value 64 or higher, all active voices will be sustained.
- If CC 64 is sent with value 63 or lower, all active voices will be released.
Note that CC 64 is separate from the mapping workflow in the following section. Sustain signals are explicitly tied to Atrium's polyphonic & unison MIDI note input modes and will not have any effect if MIDI takeover is disabled.
MIDI Modulators
Above the midi key you'll see three icons. From left-to-right these represent:
- Mod Wheel
- Pitch Bend
- Aftertouch
When an attached MIDI device sends these modulation messages, they are automatically exposed here, ready for mapping.
- Hold map and press midi to select these MIDI sources.
- Tap midi to cycle through the three options.
- Each source can be applied as a mapping, just like a typical map source.
- Press map to exit.
Map a little Pitch Bend to notes for traditional effects. The depth of the mapping affects the range of bend. The bend will be heard while mapping, so you can play the keyboard and notes slider simultaneously to find the right depth.
Try assigning your pitch wheel elsewhere!
Mapping CC's
Beyond these dedicated mapping sources, MIDI CC messages on channels 1 through 15 are also freely assignable. To achieve this, Atrium uses "MIDI learn" to create these assignments.
While this occurs outside the formal mapping system, the process is nearly identical, only differing in the method of source selection (ie. selecting a CC number):
- Press learn to listen for MIDI CC messages. The cc light will pulse as it waits.
- On your controller, move the knob/slider you will use to control Atrium. The cc light will illuminate solidly & this CC is selected as the source. You'll also see the
gestureLED strip has been repurposed to show your incoming CC's value. - Interact with Atrium's controls to define the depth of modulation for this CC. The learned icon will light (three arrows pointing outward).
- To assign a different CC, simply move the next knob/slider to be mapped.
- As you send different CCs, the learned icon will indicate whether this CC has any existing mappings.
- Press learn again to exit.
As you're learning CCs, any changes you make to the hardware controller will be immediately applied. This allows you to audition the full range of the mapping while configuring it. Use this feature to interactively find the right depth for your learnings.
Through MIDI learn, we're able to create types of macro controls that are otherwise not possible on Atrium itself. Consider learning a single CC to increase speed while decreasing tempo. Now your MIDI controller will increase the speed of some modulations, while decreasing others!
Use MIDI CC to control the knobs and sliders on Atrium, as well as the voicing, phase, spectrum, and stretch touchplates. Or try mapping MIDI CC to press keys, advancing every time the mapped CC reaches 64 from rising.
Clear CC Mappings
To clear a single CC's mappings:
- Press learn to listen for MIDI CC messages. The cc light will pulse.
- On your controller, move the knob/slider you want to edit. The cc light will illuminate solidly & this CC is selected as the source.
- Hold clear and touch the mapped destination to clear the mapping for that CC.
- To edit a different CC, simply move the next knob/slider to be edited.
- As you send different CCs, the learned icon will indicate whether this CC has any existing mappings.
- Press learn again to exit.
To clear all MIDI mappings, hold clear and press learn.
Static CC Map
While the MIDI learn modalities described above are consistent with Atrium's 'additive' approach to modulators, there are times when direct control over the parameters' full range of values is desired.
MIDI Channel 16 is reserved for this type of 'takeover'. When a MIDI CC message is received on Channel 16 it sets the associated parameter directly, as if you had moved the associated control on Atrium. These static CC messages are simpler, and as such can be more destructive, so use with care.
Values 0-127 span each parameter's full range. For knobs and sliders this means the same range as the control on Atrium. For stepped parameters, the CC range is scaled to cover all potential values. For stepped parameters with dynamic ranges ("sequenced" parameters), the CC is mapped from 1 to 11, folding into the current range of that parameter.
CC Range Guide
Continuous parameters (like energy) span the full range fluidly with values 0 - 127. For knobs and sliders this means the same range of control as on Atrium. For parameters where it makes sense to have a zero point (like chord), both values 63 & 64 will arrive there.
For stepped parameters, the CC range is scaled to cover all potential values. For brevity, we'll just list the thresholds of change:
- Off / On: 0, 64
- Three-step: 0, 43, 85
- Four-step: 0, 32, 64, 96
- Five-step: 0, 26, 51, 77, 102
When speed, time, or length are sync'd to the clock, their values turn ratiometric with these thresholds of change:
- Sync'd: 0, 15, 29, 43, 58, 72, 86, 100, 115
For stepped parameters with dynamic ranges ("sequenced" parameters), the CC is mapped from 1 to 11, folding into the current range of that parameter. This means value 0 will always go to the starting point of a sequence (eg. position 5 in a range of 5 to 9), and value 47 will always move 4 steps away from the start point.
- Sequenced: 0, 12, 23, 35, 47, 58, 70, 81, 93, 105, 116
| CC | Parameter | Range |
|---|---|---|
| 70 | notes | full |
| 71 | chord | full, with zero point |
| 72 | voicing | sequenced |
| 73 | octave | five-step |
| 74 | glide | four-step |
| 75 | quantizer | off / on |
| 76 | scale | sequenced |
| 77 | MIDI edits scales | off / on |
| 78 | global tune | full, with zero point |
| 79 | timbre mode | three-step |
| 80 | energy | full |
| 81 | timbre | full |
| 82 | tone | full |
| 83 | sustain mode | three-step |
| 84 | sustain | full |
| 85 | lowcut | four-step |
| 86 | droning | off / on |
| 87 | drone | sequenced |
| 88 | spectre | full, with zero point |
| 89 | time | full, unless sync'd |
| 90 | lens | sequenced |
| 91 | spectrum left | full, with zero point |
| 92 | spectrum centre | full, with zero point |
| 93 | spectrum right | full, with zero point |
| 94 | morph | four-step |
| 95 | tempo | full |
| 102 | ramp | full |
| 103 | length | full, unless sync'd |
| 104 | loop | off / on |
| 105 | stretch left | full, with zero point |
| 106 | stretch right | full, with zero point |
| 107 | speed | full, unless sync'd |
| 108 | phase | full, with zero point |
| 109 | shape | sequenced |
| 110 | MIDI clock input | off / on |
| 111 | MIDI note input | three-step |
| 112 | MIDI clock output | off / on |
| 113 | volume | full |
Additionally:
- Unknown CCs are ignored.
- CC 64 (Sustain) and CC 123 (All Notes Off) belong to "MIDI → scale" mode.
When adjusting these CCs you'll notice the pickup lights on Atrium, showing when the value moves away from the physical control's position. You can 'takeover' from Atrium again by moving the control to catch up to the light. Moving the CC again jumps the param to the received value – perhaps that can be used to interesting effect?!
Clock
Atrium can receive MIDI clock via any input that's sending a clock signal. When enabled, the MIDI clock will override Atrium's internal clock:
- Press midi to enter the MIDI input settings.
- Press tap to toggle receiving MIDI clock. You'll see the metronome LED animation engage when enabled.
- Press midi to exit.
Now Atrium's tempo knob acts as a clock multiplier/divider, with these divisions:
- 1/4
- 1/3
- 1/2
- 2/3
- 1 (at noon)
- 1.5
- 2
- 3
- 4
MIDI clock input expects standard 24ppqn timing signals. Other timings will further multiply the range, though should remain musically relevant.
MIDI Output
Atrium's MIDI output specification is still in its infancy. Presently only clock is supported, though this will change in future.
Clock
Share Atrium's clock via MIDI, through any (or all) of the ports:
- Hold alt & press midi to select the MIDI output settings.
- The extension window roughly displays an
Mfor MIDI. - Press tap to enable clock output. The metronome will pulse.
- Press alt to exit.
By default, Atrium will send its clock signal to all of the outgoing ports. To choose only a specific output destination:
- Hold alt & press midi to select the MIDI output settings.
- Press midi to cycle through the destination options.
- Press alt to exit.
Each destination has an associated light, and by default they will all be on:
- USB-A port: lights controller (piano keyboard icon).
- USB-C port: lights computer (laptop icon).
- TRS port: lights the midi key's window.
When Atrium is sending MIDI clock output and running from internal or tap-tempo, mute the clock modulator to gate MIDI output. Enabling will reset the clock phase and send a MIDI Start message.
When Atrium is running in its 'normal' internal clock mode (eg. not tap-tempo):
- Hold clear and press tap to reset the phase of the clock and send a MIDI Start message.
- Turn tempo to full CCW to stop the clock and send a MIDI Stop message.
- Turn tempo CW from full CCW to start the clock and send a MIDI Start message (Atrium's internal clock will be in phase with the outgoing MIDI clock).