Using the MXM editors
Source code on GitHub · Questions on Discord
Every MXM plugin is built on the same editor. What follows works the same way in all 25, and the manuals for each plugin only cover what is its own.
Cards and pages
The editor is an app bar along the top and a set of cards below it. A card holds one job, such as an oscillator, a filter or an output. Cards always come in the same order of categories: Performance, Modulators, Sequencers, Generators, Tone, Effects. Within a category they follow the signal.
How many cards you see at once depends on the size of the window. When they don’t all fit, the editor splits them into pages and puts tabs above them, named after what each page holds, such as “Performance + Modulators”. If the tabs would take too much room, a row with Previous, the page number and Next replaces them. When everything fits on one page, there is no tab row at all.
Two editors don’t use cards this way. MXM FX Curve is a drawing canvas, and MXM FX EQ N is a graph with a column of cards beside it.
Size and scale
Drag the window’s edge to resize it, and the cards move into rows and pages to fit. Each editor opens at a size worked out to fill a quarter of a 4K screen, which is only a starting point. The smallest size is one card wide.
Scale, in the app bar, draws everything larger or smaller: 75 %, 100 %, 125 %, 150 % or 200 %. The layout stays the same and the window grows or shrinks to match. In a narrow window, Scale and Theme move into the … menu.
Theme
Theme offers Light, Dark and System. The choice applies at once, and the editor remembers it for every MXM plugin, not one at a time. A preset never changes it. The first time you open an MXM editor it is Light. Inside some DAWs, System can show Dark whatever your computer is set to.
Presets
The preset row is on the left of the app bar. ‹ and › step through the presets, ☆ marks the loaded one as a favourite, and Save preset saves it. The … menu holds Rename, Delete and Init patch, which sets every control back to its default.
The bar shows the name of the loaded preset. A dot after the name means you have changed something since loading it. It disappears if you turn the control back. After Init, the bar reads No preset.
Click the name to open the browser. It has three columns:
- Banks: All, Factory, Yours (the presets you saved) and any banks you made or imported.
- Categories: All, Favourites, then categories such as Bass, Lead, Pad, Keys or Percussion.
- Presets, with a search box. Init is always the first row.
The arrow keys work in the browser too: left and right move between the columns, up and down load the next bank, category or preset as you go. Enter, Escape or a click outside closes it. ‹ and › in the bar follow whatever the browser is filtered to.
Save preset asks for a name and a category. Keep the name to replace your own preset, or type a new one. Factory presets can’t be overwritten: saving one makes a copy that is yours. Starred presets sort to the top of the browser.
At the foot of the browser, Export… packs the presets you see into one bank file, Import… unpacks one, New bank… makes an empty bank to save into, and Open folder shows where bank files go. A CLAP host can also list and load the factory presets in its own browser.
Mouse
Drag a control to change it, and hold Shift while dragging for finer steps. Double-click sets it back to its default. Right-click and choose Type a value to enter a number. Press Escape in the middle of a drag and the control goes back to where it started. Hover over any control to see its name, its exact value and a sentence on what it does. The editors print no help text on the panel itself, so the tooltips are where to look.
Keys
The whole editor works from the keyboard, with the same keys as every other MXM editor. Press F1 to see a sheet of the keys this editor answers to, and Escape to close it. The keyboard cursor appears once you press a key and hides again when you use the mouse.
| Key | What it does |
|---|---|
| Arrow keys | Move to the next control in that direction |
| Shift or C with the arrows | Move from card to card, and on to the next page |
| D or E with ↑ ↓ | Change the value by 1 % of its range, or a semitone |
| S with ↑ ↓ | 10 %, or an octave |
| F with ↑ ↓ | 0.1 %, or a cent |
| Tab | Keep the change |
| Escape | Cancel the change, or close a menu or sheet |
| Delete | Back to the default |
| Enter | Choose a button, or type a value |
| R | The control’s menu |
| Home, End | Lowest or highest value |
| F1 | Show or hide the keys |
You can hold the keys of a combination together or press them one after the other. Keys the editor doesn’t use go on to the DAW, so a note key still plays a note and Space still starts the transport. We tried this in Ableton Live 11 and Bitwig 5. The keys come from one keymap file you can edit, in %APPDATA%\mxm\keymaps on Windows, ~/Library/Application Support/mxm/keymaps on macOS and ~/.config/mxm/keymaps on Linux.
Output and meters
Instruments have their Output level as a slider in the app bar, beside a level meter. Effects keep Mix and their output level in their own Output card. A meter is green below −12 dB, yellow up to −3 dB and red above that. Its clip light stays on until you click it.
Where things are
On Windows:
| What | Folder |
|---|---|
| CLAP plugins | C:\Program Files\Common Files\CLAP\MXM |
| VST3 plugins | C:\Program Files\Common Files\VST3\MXM |
| Factory presets | %LOCALAPPDATA%\mxm\<plugin id>\factory\<version> |
| Your presets and favourites | %APPDATA%\mxm\<plugin id>\presets |
| Bank files | %APPDATA%\mxm\<plugin id>\banks |
| Impulse responses | %LOCALAPPDATA%\mxm\impulses |
| Theme and keymaps | %APPDATA%\mxm |
On macOS:
| What | Folder |
|---|---|
| CLAP plugins | ~/Library/Audio/Plug-Ins/CLAP/MXM |
| VST3 plugins | ~/Library/Audio/Plug-Ins/VST3/MXM |
| Factory presets | ~/Library/Application Support/mxm/<plugin id>/factory/<version> |
| Your presets and favourites | ~/Library/Application Support/mxm/<plugin id>/presets |
| Bank files | ~/Library/Application Support/mxm/<plugin id>/banks |
| Impulse responses | ~/Library/Application Support/mxm/impulses |
| Theme and keymaps | ~/Library/Application Support/mxm |
On Linux:
| What | Folder |
|---|---|
| CLAP plugins | ~/.clap/MXM |
| VST3 plugins | ~/.vst3/MXM |
| Factory presets | ~/.local/share/mxm/<plugin id>/factory/<version> |
| Your presets and favourites | ~/.config/mxm/<plugin id>/presets |
| Bank files | ~/.config/mxm/<plugin id>/banks |
| Impulse responses | ~/.local/share/mxm/impulses |
| Theme and keymaps | ~/.config/mxm |
A plugin id looks like dk.mxm.mxm-mono-01. Factory presets get a folder per version, so each version keeps the set it shipped with, and your own presets survive every update.