MXM Thanks EG manual

This manual goes through MXM Thanks EG card by card. What every MXM editor shares, such as presets, pages, zoom, themes and the keys, is in Using the MXM editors.

MXM Thanks EG at its opening size, 1676 × 1070, with the Init patch MXM Thanks EG at its opening size, 1676 × 1070, with the Init patch
MXM Thanks EG at its opening size, 1676 × 1070, with the Init patch · click for full size

App bar

From the left: the plugin’s name, the preset row, Theme and Scale, Volume, and a level meter.

ControlRangeInit
Volume−60.0 dB to 0.0 dB−9.0 dB

Volume is the instrument’s output level. The factory presets never move it: each sound is levelled in its own settings.

Voice

ControlRangeInit
ModePoly, Mono, LegatoPoly
Glide0.0 ms to 5.00 s0.0 ms
Bend range0 st to 24 st2 st

Poly plays up to eight notes at once. A new note takes an idle voice, or else the released voice that has sounded longest, or else the held one that has. Mono and Legato play one voice with last-note priority: in Mono each new note starts the sound again, and in Legato a note played over a held one carries on. Changing Mode releases every voice.

Glide is the slide time between notes, and zero turns it off. The slide is exponential, timed to within 1 % of the new note. In Poly a note glides from the last note played, in Mono from wherever the voice is, and in Legato only on a tied note. Bend range is in semitones.

Envelope 1, 2 and 3

The three cards are the same, and each envelope runs once per voice.

ControlRangeInit
A0.5 ms to 30.00 s5.0 ms
D0.5 ms to 30.00 s300.0 ms
S0 % to 100 %70 %
R0.5 ms to 30.00 s300.0 ms
Response−100 % to 100 %0 %
ModeNote, Gate, FollowNote
CycleOff, OnOff

A, D, S and R are attack, decay, sustain and release. Response bends every stage at once: logarithmic below the centre, straight at it, exponential above. It changes the curve, not the times. An envelope changes nothing until a route takes it somewhere.

Mode decides what starts the envelope. On Note each note starts it and letting go releases it. On Gate its Trigger starts it, it holds while the trigger is high, and it releases when the trigger falls. On Follow it moves towards whatever is routed into its Input, rising at the attack time and falling at the release time, which makes it a lag or a portamento for any signal.

Cycle makes the envelope repeat its attack and decay as a wave of its own, skipping the sustain and turning at 0.8 of full level. In Gate mode it cycles while Cycle is on or its Cycle target is high, and in Follow mode Cycle does nothing. A rising trigger during the decay, sustain or release restarts the attack from wherever the envelope is. During the attack it is ignored.

Each card has six route lines. Rise moves the attack time, Fall the decay and release times, and Time all of them together. Cycle and Trigger are the gates that make it cycle or start it, and Input is what it follows.

LFO 1, 2 and 3

ControlRangeInit
Rate0.01 Hz to 50.00 Hz5.00 Hz, 1.00 Hz, 0.20 Hz
SyncOff, OnOff
Fade0.0 ms to 10.00 s0.0 ms
ShapeSine, Triangle, Saw up, Saw down, Square, Sample and hold, Smooth randomSine
RetriggerOff, OnOff

The three cards differ only in their Init rates: a vibrato, a slow sweep and a drift. Sync is the note symbol beside Rate. With Sync on and a host tempo, the knob reads a note length, 4 bars at the bottom of its travel and 1/32 at the top. Without a host tempo the free rate stands. Fade brings the LFO in after each note, its depth rising in a straight line from zero. The shapes are drawn as pictures; Sample and hold takes a new random value every cycle, and Smooth random glides from one random value to the next.

With Retrigger off, one LFO serves every voice, and its Rate can only be moved by shared sources: Wheel, Pressure, Bend and the other shared LFOs. With it on, each voice has its own, started again with each note. Each card has one route line, Rate.

Engine

ControlRangeInit
Model24 engines in three banksVirtual analogue
Frequency−48 st to +48 st0 st
Fine−1.00 st to +1.00 st+0.00 st

Model chooses the engine. Click it for a list grouped as Bank 1, Bank 2 and Bank 3. Frequency tunes the engine in semitones, up to four octaves either way, and Fine by up to a semitone either way.

ModelWhat it is
Analogue with filterClassic oscillator waves through a resonant filter
Phase distortionBright, vocal tones made by bending the shape of a wave
Six-op FM 1, 2 and 3FM tones from banks of stored six-operator voices
Wave terrainA wave traced across a shifting landscape, smooth or gritty
String machineA chord of ensemble strings and organ, softly chorused
ChiptuneSquare-wave chords and arpeggios with the buzz of early home computers
Virtual analogueTwo classic oscillator waves, detuned or locked together
WaveshapingA triangle folded and shaped into bright, hollow tones
Two-op FMOne wave bending the pitch of another, with feedback
Grain and formantVocal and formant tones made from short grains of sound
HarmonicOrgan-like tones built from a row of harmonics
WavetableWaves swept through a table of shapes
ChordsFour-note chords from a choice of chord shapes
SpeechVowels, formants and spoken words
Granular cloudA cloud of tiny grains, a shimmer or a swarm
Filtered noiseNoise through a resonant filter
Particle noiseScattered clicks and drops of sound through resonant filters
Inharmonic stringA plucked or bowed string with a metallic, bell-like edge
Modal resonatorStruck bars, bells and plates
Bass drumA deep, punchy kick drum
Snare drumA snare drum, tight or rattling
Hi-hatA hi-hat, closed or open

Bank 1 runs from Analogue with filter to Chiptune, Bank 2 from Virtual analogue to Speech, and Bank 3 from Granular cloud to Hi-hat.

Some engines make their own envelope: the six-op engines, the chiptune, the inharmonic string, the modal resonator, the three drums and the speech engine’s words. On these the gate’s Level is only an accent, and letting go of the key does nothing, except on the chiptune, whose release closes it as the gate would. The inharmonic string and the modal resonator ring on. Morph alone sets how long, and from about 70 % only the instrument’s guard ends them, fading a released note that still sounds after 30 seconds. The factory plucks damp them with an envelope routed to Morph. The chiptune’s arpeggio moves on only in Mono: in Poly each note takes a fresh voice and plays its first step.

Pitch and Model take routes. A route on Model reaches up to 24 engines either way, and the engine is picked again at each note.

Shaping

ControlRangeInit
Harmonics0 % to 100 %50 %
Timbre0 % to 100 %50 %
Morph0 % to 100 %50 %

The engine’s three sound controls, and each engine decides what they do. Harmonics is the first; Timbre is most often its brightness or texture, and Morph most often a blend or a change of shape. All three take routes.

From decay

ControlRangeInit
Pitch−100 % to 100 %0 %
Timbre−100 % to 100 %0 %
Morph−100 % to 100 %0 %

Each note has a built-in decay envelope. These three set how far it sweeps the pitch, Timbre and Morph: up above the centre, down below it. The same envelope is the Decay route source. This card has no route lines.

Low-pass gate

ControlRangeInit
Decay0 % to 100 %50 %
Colour0 % to 100 %50 %

Every note passes through the gate. At Init a note pings it, and Decay is how long it rings. Colour sets how the gate closes: at 100 % it is a plain fade in volume, and below that a filter that darkens the note as it fades.

The route lines are Decay, Colour and Level, which has no knob. Once a route aims at Level, the gate follows the Level routes instead of the ping. Level follows the gate’s compressed curve, where −6 dB needs about 19 %, and it darkens the sound too unless Colour is at 100 %.

Output

ControlRangeInit
Aux0 % to 100 %0 %
Spread0 % to 100 %0 %

Each engine makes a second sound, a variation of its main one. Aux blends the main sound into the second, and Spread moves the main sound to the left and the second to the right. At 100 % Spread, Aux does nothing.

The route lines are Aux, Pan and Amplitude, and the last two have no knobs. Pan is a balance, at full level in both channels at the centre. Amplitude scales the output from silence to double.

Routes

Sixteen route slots connect 19 sources to 32 targets. There is no routing page: each target has a line on the card of the control it moves, and that line offers ‹ modulate ›. At Init no slot is in use.

With routes added, the cards take two pages. The first page, with Velocity on Envelope 1's Time With routes added, the cards take two pages. The first page, with Velocity on Envelope 1's Time
With routes added, the cards take two pages. The first page, with Velocity on Envelope 1's Time · click for full size

Choose a source and it takes a free slot, the one this target had before if there is one, so a removed source comes back at its old depth. The route appears as a row named after its source, with an amount slider and a ×. The × switches the source off and keeps the depth. ‹ modulate › only offers sources not yet on that target. When all sixteen slots are in use, every line reads all 16 in use until you remove a route.

The second page, with LFO 1 on Timbre and Env 1 on Level The second page, with LFO 1 on Timbre and Env 1 on Level
The second page, with LFO 1 on Timbre and Env 1 on Level · click for full size

The sources are:

CardTargets
EnginePitch, Model
ShapingHarmonics, Timbre, Morph
Low-pass gateDecay, Colour, Level
OutputAux, Pan, Amplitude
LFO 1, 2 and 3Rate
Envelope 1, 2 and 3Rise, Fall, Time, Cycle, Trigger, Input

Amounts run from −100 % to 100 % of the target’s reach:

TargetFull reach
Pitch±12 st
Model±24 engines
Harmonics, Timbre, Morph, Decay, Colour, Aux, Pan, Levelthe whole range
Amplitudefrom silence to double
Rate±4 octaves
Time16 times shorter or longer; positive shortens
Rise, Fallthe whole range, in seconds; positive slows
Cycle, Trigger, Inputthe source’s own value

Key routes reach per octave. An amount of 100 % on Rise or Fall adds 30 seconds, so for small changes use Time. Cycle and Trigger are high while the routes on them add up to more than half. Two slots with the same source and target add up. A loop, such as an envelope triggering itself, runs one 0.25 ms step late and behaves the same way every time.

A few pairs take a slot and move nothing: a playing source such as the wheel or velocity into Cycle or Trigger, and Key or Random into Level. Velocity into Level only works upwards.

Playing notes

The engines run at 48 kHz, and one converter takes the mix to the host’s rate. At 48 kHz there is no latency. At other rates the converter adds a fixed latency, reported to the host: 78 samples at 44.1 kHz, 88 at 96 kHz and 176 at 192 kHz.

MXM Thanks EG answers notes with velocity, pitch bend, the mod wheel (CC 1), channel pressure and, in a CLAP host, per-note tuning. MIDI CC 120 cuts every note at once, and CC 123 releases every held key.

A cycling envelope in Gate mode, or an LFO on Level, can sound with no key held, so the instrument keeps running while anything sounds. A Follow envelope whose input stays above zero after the note, such as Key above middle C, never rests, and its voice never goes idle.