Monomodule
Monomodule is a free, open-source, chip-level emulation of the Elektron Monomachine (SFX-6 / SFX-60)
as plugins for your DAW. Monomodule doesn't approximate the synth with new DSP code. It runs the
Monomachine's own sound engine inside an emulated Motorola DSP56300, so it matches the hardware sample for sample.
Monomodule is not affiliated with, endorsed by or sponsored by Elektron. "Elektron" and "Monomachine" are
trademarks of Elektron Music Machines MAQ AB, used here only to describe what Monomodule emulates. Monomodule
contains no Elektron software. To make sound it needs the Monomachine OS file, which you download from Elektron
yourself (see Getting the OS file).
What's included
|
Type |
What it does |
| Monomodule One |
Instrument (AU, VST3, standalone) |
One Monomachine track. Plays all 22 machines: GND, SWAVE, SID, DPRO, FM+, VO-6 and the FX machines. The editor recreates the hardware's LCD pages, with the SYN, AMP, FILT and EFX pages plus three LFOs. FX machines process the side-chain input. |
| Monomodule Six |
Instrument (AU, VST3, standalone) |
All six tracks in one instance. MIDI channels 1-6 play tracks 1-6. It has six stereo outputs, and each track has its own routing: OUT BUS AB/CD/EF, and for FX machines an input of NEIBOR, INP A/B/AB or BUS AB/CD/EF. |
| Monomodule FX |
Effect (AU, VST3) |
The FX machines as an audio effect: THRU, REVERB, CHORUS, DYNAMIX, RINGMOD, PHASER and FLANGER. |
| Monomodule Library |
Standalone app |
A library for Monomachine sysex dumps. It imports .syx files without losing any data, keeps a version history for each Monomachine you own, and lets you browse presets, kits and patterns with audio previews. You can drag items into the plugins or your DAW. |
Every parameter is a raw 0-127 value, just like on the hardware, so a track's settings are the same as a kit track
in a sysex dump. The plugins and the Library app share presets, kits and patterns.
Getting the OS file
Monomodule needs Monomachine OS 1.32B, which Elektron provides as a free download:
- Download Elektron_SFX6-60_OS1.32B.zip
from Elektron's website.
- Unzip it. Inside is
Elektron_SFX6-60_OS1.32B.syx.
- Open any Monomodule plugin (or the Library app), click Select OS File... and choose that
.syx file.
You only have to do this once. All Monomodule plugins and the Library app share the setting. The file stays where
you put it: Monomodule reads it each time it starts and never copies it or redistributes it.
Installing a release
Pre-built downloads for macOS, Windows and Linux are on the project's Releases page.
| Platform |
Plugins |
Library app |
| macOS 12+ (Apple Silicon and Intel) |
Run the installer. It installs the AU and VST3 plugins in /Library/Audio/Plug-Ins/. |
/Applications/Monomodule Library.app |
| Windows 10+ (x64) |
Run the installer. It installs the VST3 plugins in C:\Program Files\Common Files\VST3\. Or use the zip and copy the .vst3 folders there yourself. |
C:\Program Files\Shnolk\Monomodule\Monomodule Library.exe |
| Linux (x64) |
Copy the .vst3 folders to ~/.vst3/ |
~/.local/bin/Monomodule Library |
The plugin's library panel opens the Library app from these locations.
Building from source
Requirements
- CMake 3.22 or newer, Git, and a C++17 compiler
- An internet connection for the first configure. CMake downloads JUCE
8.0.9 and dsp56300, pinned to a fixed commit, and applies
ext/patches/0001-dsp56300-mnm.patch to it.
macOS
Needs Xcode or the Xcode command line tools (xcode-select --install). Ninja is optional
but faster.
cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build
The build copies the AU and VST3 plugins to ~/Library/Audio/Plug-Ins/. For a universal (Apple Silicon and
Intel) build, add -DCMAKE_OSX_ARCHITECTURES="arm64;x86_64" to the first command.
Linux
On Debian or Ubuntu:
sudo apt install build-essential cmake git ninja-build pkg-config \
libasound2-dev libjack-jackd2-dev libfreetype-dev libfontconfig1-dev \
libx11-dev libxcomposite-dev libxcursor-dev libxext-dev libxinerama-dev libxrandr-dev libxrender-dev \
libgl1-mesa-dev libcurl4-openssl-dev libgtk-3-dev libwebkit2gtk-4.1-dev
cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build
The emulator keeps its memory in /dev/shm. On a normal desktop that folder is large enough, but a Docker container gets
only 64 MB by default, which crashes the engine. In a container, start it with --shm-size=1g or more.
The build copies the VST3 plugins to ~/.vst3/. The standalone versions of One and Six and the Library app are in
build/src/plugin/*_artefacts/Release/Standalone/ and build/src/app/MnmLibraryApp_artefacts/Release/.
Windows
Needs Visual Studio 2022 with the Desktop development with C++ workload. Run these in a Developer PowerShell for VS
2022:
cmake -S . -B build -G "Visual Studio 17 2022" -A x64
cmake --build build --config Release
The VST3 plugins are in build\src\plugin\*_artefacts\Release\VST3\. Copy them to
C:\Program Files\Common Files\VST3\, or configure with -DMNM_COPY_PLUGINS=ON from an administrator prompt so the
build copies them for you.
Build options
| Option |
Default |
Meaning |
MNM_BUILD_PLUGIN |
ON |
Build the plugins and the Library app. OFF builds only the engine, the tests and mnm-render. |
MNM_BUILD_TESTS |
ON |
Build the unit tests. |
MNM_COPY_PLUGINS |
ON (OFF on Windows) |
Copy the plugins to the plugin folders after each build. |
MNM_OS_SYX |
(empty) |
Path to your OS file. Used by the tests and the command-line tools. |
MNM_DSP56300_DIR |
(empty) |
Use an existing, already patched dsp56300 checkout instead of downloading one. |
Tests
cmake -S . -B build -DMNM_OS_SYX=/path/to/Elektron_SFX6-60_OS1.32B.syx
cmake --build build --target mnm-tests
ctest --test-dir build --output-on-failure
The tests that run the emulated DSP need the OS file. You can pass it through MNM_OS_SYX as above, or through the
MNM_OS environment variable. Without it, those tests are reported as skipped and the rest still run.
Command-line tools
mnm-render plays one note on one machine and writes a WAV file, e.g.
mnm-render --fw OS.syx --machine "FM+ PAR" --note 69 --dur 1 --out a4.wav. Run it without arguments to see every
option.mnm-libtool is the Library from the terminal: import, list, show, export, verify (a byte-for-byte
round trip of a dump), preview (renders an audio preview to a WAV file) and more.
How it works
- OS file.
src/core/firmware unpacks the user's OS file: the sysex transport, the flash container and the
compressed sections. From these it takes the DSP program and data.
- DSP.
src/core/dsp loads that program into the dsp56300 emulator. Its JIT compiles the DSP code to native
code. A small harness replaces the hardware's audio I/O: every 16 samples it sends in a 52-word parameter block
for one track and reads out 16 stereo frames.
- Host model. On the hardware, the main processor builds those parameter blocks.
src/core/host does the same
job: note and trigger handling, tempo, parameter smoothing and the three LFOs of each track.
- Plugins.
src/plugin holds the plugins. One, Six and FX share one processor and one editor. The editor draws
the LCD with the fonts and icons from your OS file. Without an OS file it falls back to a built-in stand-in font.
- Library.
src/core/library and src/library hold the sysex codec, the catalogue that merges identical items
across dumps, the project and version store, and offline preview rendering. The app is in src/app.
Known limitations
- DPRO-DDRW and DPRO-DENS read the Digibank waveforms, which live in the Monomachine's +Drive memory and are not
part of the OS file. Monomodule builds a stand-in bank instead: the 32 DPRO-WAVE waveforms plus 32 classic
single-cycle shapes.
- The delay time of the EFX page does not yet follow DTIM and the tempo the way the hardware does.
- A machine change triggers the machine once, as on the hardware. Because of this, a new instance plays a short
blip right after the OS loads.
- MIDI transfer to and from the hardware isn't implemented yet. To move dumps, use
.syx files with Elektron's C6
or Transfer tools.
Settings and data
Monomodule stores its settings and its library in the user application-data folder:
- macOS:
~/Library/Application Support/Shnolk/Monomachine/
- Windows:
%APPDATA%\Shnolk\Monomachine\
- Linux:
~/.config/Shnolk/Monomachine/
Licence
Monomodule is free software: you can redistribute it and/or modify it under the terms of the
GNU Affero General Public License v3.0 (see LICENSE). Anyone who distributes Monomodule, modified or
not, must pass on these same rights and make the corresponding source code available.
It is built on JUCE (AGPLv3) and
dsp56300 (GPLv3), among others.
THIRD_PARTY_NOTICES.md lists every dependency, its licence and the changes Monomodule makes to
dsp56300.
Credits
Monomodule is made by Shnolk. Contact: @shnolk on Instagram, or
[email protected].
Monomodule stands on the work of:
- dsp56300, the DSP56300 emulator at the heart of the sound engine
- JUCE, the plugin and UI framework
- AsmJit, the JIT back end of dsp56300
- MCL, whose documentation of the Monomachine sysex formats guided the Library's codec
- elektron-firmware-tool, for its work on the Elektron OS file
format
Bug reports and pull requests are welcome.
