NEWMOD Web GUI User Guide
Contents
- 1 Introduction
- 2 Navigating the Interface
- 3 Creating & Managing Pedalboards
- 4 Assigning Controls & Expanding Functionality
- 5 CV Usage & Modulation
- 6 Advanced Features & Settings
- 7 Troubleshooting & Support
- 8 Appendix: Keyboard Shortcuts, Tips, and Links
Introduction
Welcome to the MOD Web GUI User Guide!
This guide will help you navigate the web-based interface used to control and configure your MOD devices, including the MOD Duo, MOD Duo X, MOD Dwarf, and MOD Desktop.
Whether you're a new user exploring the system for the first time or an experienced musician looking to refine your workflow, this manual provides step-by-step instructions to help you make the most of your MOD experience.
What is the MOD Web GUI?
The MOD Web GUI is a powerful, browser-based interface that allows you to:
- Create and manage pedalboards using a fully modular approach.
- Install, remove, and organize plugins from the MOD Plugin Shop.
- Assign physical controls (knobs, footswitches, MIDI devices, etc.) to parameters for hands-free operation.
- Save and organize banks & snapshots for seamless performance transitions.
- Adjust system settings, monitor CPU usage, and update your device firmware.
How Does It Work?
MOD devices run a dedicated audio engine that includes an embedded web server. This web server hosts the MOD Web GUI, which can be accessed from a web browser on a connected computer. The engine processes audio in real-time while allowing users to visually configure and manipulate their signal chain via the Web GUI.
For hardware devices (MOD Duo, MOD Duo X, and MOD Dwarf), the web server runs inside the device itself. Users connect to it over a network (via USB, Ethernet, or Bluetooth) to access the interface. The connection to the network is not made using the Control Chain port (the RJ45 port) on the device.
For MOD Desktop, the MOD audio engine and web server both run on the same computer as the web browser, allowing direct access to the Web GUI without external connections. Despite this difference, the underlying topology remains the same across all platforms.
Compatible Devices
The MOD Web GUI is shared across the following platforms:
- MOD Duo – Classic dual-footswitch multi-effects processor.
- MOD Duo X – Advanced performance-focused device with more controls.
- MOD Dwarf – Compact and versatile effects processor.
- MOD Desktop – A software-based version of the MOD environment, running on a computer.
While the interface remains consistent across devices, some features, buttons, and objects may differ depending on the device you are connected to. Each MOD device offers different hardware capabilities, which may influence the available GUI elements.
Accessing the WebGUI
To access the Web GUI:
- Connect your MOD device to your computer, tablet, or smartphone via USB or Bluetooth (for supported devices).
- Open your web browser and navigate to the appropriate address:
- MOD Duo: http://modduo.local or http://192.168.51.1
- MOD Duo X: http://modduox.local or http://192.168.51.1
- MOD Dwarf: http://moddwarf.local or http://192.168.51.1
- MOD Desktop: http://127.0.0.1:18181/
- Bluetooth connection (for MOD Duo, MOD Duo X and MOD Dwarf): http://192.168.50.1 (See Bluetooth Setup for details)
- Start building and customizing your setup!
If you experience connection issues, visit the Troubleshooting section for assistance.
Web GUI Layout
The MOD Web GUI consists of several key sections that help you manage and configure your device efficiently:
- Constructor: main view where you can visualise and manage your signal chain, access different menus and overall set your device
- Pedalboards Library: Quick access to saved pedalboards
- Banks: organize banks for easy access while using the device in standalone mode
- File Manager: access to files stored in your device
- Plugin Store: plugin store where you can install new effects and utilities
- Snapshots: manage the snapshots of your pedalboard
- System Status & Settings: Access system settings, monitor CPU usage, and adjust device preferences
Each of these sections is designed to be intuitive, offering drag-and-drop functionality and real-time parameter adjustments.
Constructor
The Constructor view can be divided into 8 subsections, as you can see in the image above:
- Pedalboard name: shows the name of the loaded pedalboard and snapshot
- Pedalboard actions bar: access to actions like saving or sharing the pedalboard, managing the snapshots from the current loaded pedalboard, etc.
- Inputs: shows a virtual representation of all the physical inputs available on your device hardware
- Virtual Pedalboard: visual representation of your signal chain.
- Outputs: shows a virtual representation of all the outputs available on your device hardware
- Plugins bar: list of installed plugins that can be dragged into the pedalboard.
- Mode selector: gives access to the different screens of the WebGUI (Constructor, Pedalboards Library, Banks, File Manager and Plugin Store)
- Status bar: gives you access to device actions (like set the tempo, MIDI ports or access the WebGUI settings for your device) and shows you some relevant information about the current status of your device (like CPU and RAM consumption)
Pedalboards Library
To access the pedalboards library, click on
in the mode selection bar.
In the Pedalboards Library view, you can:
- check all the MOD pedalboards stored in your device
- load a pedalboard: by clicking on the preview image of the desired pedalboard
- delete pedalboards
The Pedalboards Library is divided into two categories:
- User Pedalboards: the pedalboards created and saved by the device users
- Factory Pedalboards: Pedalboards that come pre-loaded on the device from the factory
Please note that the User Pedalboards can be deleted by using the
icon on the top right corner of each pedalboard preview.
On the other hand, Factory Pedalboards cannot be deleted by the users.
Banks
To access Banks, click on
in the mode selection bar.
Banks allow you to group pedalboards for quick switching while the device is disconnected from the WebGUI.
The MOD devices come loaded with a few Banks from the factory. These banks are not accessible to the users and are only visible on the device.
Yet, the users are welcome and encouraged to create their own banks of pedalboards according to their needs.
Creating and organizing Banks
Use the
button to create a new bank and name it as you like.
Once created, a new bank is empty and ready to receive your pedalboards. To add pedalboards to your bank, drag them from the right lateral panel into the center of the screen. You can add as many pedalboards as you want. It is also possible to add multiple instances of the same pedalboard to your bank.
You can now navigate through your banks using the Device Menu on the MOD Duo and MOD Duo X and the Navigation Mode on the MOD Dwarf.
On the MOD Duo, you can also use the Footswitches to navigate through the pedalboards of a bank. To do it, activate the option "Foot Nav" on the Settings of your MOD Duo.
File Manager
To access the File Manager, click on
in the mode selection bar.
MOD devices allow file storage for:
- Audio Loops & Samples
- Impulse Response (IR) files
- MIDI sequences
- Instruments
- Models
You can learn more about the supported file formats on our File Handling page for MOD devices.
The management of your stored data is done from the File Manager. There, you can upload, download, and delete files or create and download folders.
Note that some plugins can also generate files internally in your device. From the file manager, you can download those files for use in your DAW or on other systems.
How to upload files
- Open the File Manager in the Web GUI.
- Open the folder for the correct file type (Audio, MIDI, Impulse Response, AIDA DSP Model, etc.) and click on the
button at the top of the window. - A file browser window with access to your host device file system will open. From there, select the file that you wish to upload.
- Use stored files with compatible plugins (a list of plugins using the different types of files can be found here).
How to download a file or a folder
- Open the File Manager in the Web GUI.
- Locate the file or folder that you wish to download in the MOD file system.
- On the list of files and folders, you can find a button with an arrow pointing down for each entry. Just like the following:
- Click on that button, and a file browser window with access to your host device's file system will open.
- On that window, select the location on your host device where you wish to store the file.
How to delete a file or a folder
- Open the File Manager in the Web GUI.
- Locate the file or folder that you wish to delete in the MOD file system.
- On the list of files and folders, you can find a button with an "X" for each entry. Just like the following:
- Click on that button, and a new screen will appear asking you to confirm if you want to delete that file or folder. Just like the following:
- On that screen, click "Yes" if you want to proceed by deleting the file or folder from the internal storage of your MOD device; or "Cancel" if you wish to abort.
How to create a folder
It's not possible to create or delete folders in the main folder of the MOD File system. In other words, you can not create any folder on the root for Audio Files, MIDI Files, Impulse Response Files, Instruments, or Plugin Resources.
Yet, you can create in sub-directories.
Please note that it's important to load the correct type of files into each folder. If you want to create a folder where you will load MIDI Files, you should not create it inside the "Audio Samples" folder, nor load MIDI files there.
Let's take as an example the "Audio Samples" folder in Audio files and create a folder called "Water samples".
- Navigate into the folder into which you want to create a new sub-folder (in our example, the "Audio Samples" folder)
- Click on the
button - A new screen will appear where you will be requested to type the name of the new folder. Following our example, we will type "Water samples"
- Click on the "Create" button if you wish to create the new folder or "Cancel" if you wish to abort the process.
After creating the new folder, you will immediately be redirected inside, and you can start uploading your files. In our example, it should be audio files (check here the supported audio formats) and preferably with water sounds.
Plugin Store
To access the Plugin Store, click on
in the mode selection bar.
By default, the MOD devices come with lots of plugins installed, but there are many more available in the Plugin Store. These plugins are created either by the MOD team or by independent developers.
We frequently add new plugins to the MOD Plugin Store (either normal releases or in beta), so make sure to give it a look from time to time to check out the new "cool stuff" that can make your MOD even better.
Installing New plugins
Installing plugins in your MOD is really simple.
Let's take, as an example for this guide, the "GxQuack"
- Open the Store from the Web GUI
- Browse available plugins or use the search bar in the bottom left corner of the Plugin Store screen
In our example, we will use the search bar and type "GxQuack"
- Click on the plugin that you wish to install (in our case, the "GxQuack"), and the following screen will show up:
- On the plugin screen, click on the
button - After installation, the plugin will be added to the Plugins Bar. You can find it either in the "All" tab or the one corresponding to the plugin category (in our example, "GxQuack" is categorized as a "Filter" plugin.
Plugin Info
You can access any plugin info/details page using one of the following paths:
- Click on the Plugin in the Plugin Store;
- Click on the plugin in the Plugins bar;
- Click the
button at the top of the Constructor.
On the Plugin Info screen, you can check data related to the Plugin, like:
- URI
- Category (of the plugin - indicates where the plugin will be listed in the Plugin Bar)
- Author
- Homepage (for the plugin)
- Latest / Installed version
- Plugin Description
- External links (See it in action, See online, See discussion, See documentation)
- Control Ports (a table with the default, minimum and maximum value per control)
See it in action: opens the MOD Pedalboard Feed, filtering only pedalboards with the respective plugin - requires an internet connection
See online: opens the online page for the plugin (from the MOD Plugins page) - requires an internet connection
See discussion: opens the MOD Forum thread where community members discuss the plugin - requires an internet connection
See documentation: opens a PDF containing documentation for the plugin.
Note: not all the plugins have all the external link buttons available
Buying plugins
Most of the plugins available in the MOD plugin store are free; however, there are a few that require a purchase to unlock their full potential.
To purchase a plugin:
- Navigate to the desired plugin in the MOD Plugin Store of your WebGUI, either by using the plugin highlights, scrolling through the store, or searching for the plugin in the search bar of the plugin store.
- Just like you would do to install a plugin, once you find it, you click on it.
- Here you can install a trial version, which will allow you to test the plugin before purchasing it.
Please note that trial versions of paid plugins will randomly drop off the audio of your pedalboard while you use it.
- Once you decide that the plugin fits your needs and you want to purchase it, you should repeat the steps 1 to 3 to open the plugin description page on the plugin store
- Click the
button. - From here, a pop-up on the right of your WebGUI screen will appear with your shopping cart for the MOD Plugin Store.
- Repeat the process until here for any other plugins that you wish to purchase
- Once you have all the plugins that you wish to purchase in your cart, click on the "Checkout" button from the cart menu.
- A new tab in your browser with the MOD Checkout. There, you should insert your data and payment method and finalize the process.
As soon as your payment is successfully processed, the license for the corresponding plugin(s) will be added to the device from which you purchased it.
Please note that, although you can access the WebGUI without an internet connection, to purchase plugins, an internet connection is required.
MOD Pedalboard Feed
Another great feature that the MOD devices have is allowing you to share and load pedalboards from the existing MOD online community on the MOD Pedalboard Feed.
Load a pedalboard on your MOD device
To load pedalboards from another MOD user, you should:
- Access the Pedalboard Library by clicking on
in the Mode Selector bar; - On the top right corner of the Pedalboard Library, you will find the button:
, click on it; - Listen to the samples and once you find a pedalboard you like, click on the Try Now button.
You can replace the first two steps by visiting the MOD Pedalboard Feed
Note that to load an online pedalboard, you need the MOD GUI open.
If you want to learn more about the pedalboard, you can use the View More button at the bottom of each shared pedalboard in the MOD Pedalboard Feed. There, you can (for example) check every single plugin used to create that pedalboard.
If you like the pedalboard that you just loaded and want to keep it, you should save it just like you would do with your own pedalboards.
You can list the pedalboards that were made using a specific plugin. To do this:
- open the plugin description dialog (for example, by clicking on the
info button on the top of the plugin on the MOD WebGUI); - click on the See it in action button.
- Go to the pedalboard constructor and click on
in the pedalboard actions bar. - Fill in the sharing dialog and (optionally) record a sample by clicking on the red circle.
- After finishing the recording, you can listen to it or record again.
- When you are done, click on the Share button.
Settings
The
button by the status bar (bottom right of the WebGUI constructor page) opens the WebGUI Settings page.
On this page, you can:
- Check information regarding your MOD device
- Define user settings
- Backup, restore and modify data in your MOD device
- Start the update process for your MOD device system or MOD Control Chain devices
System Information
On the right side, you will find information about your device's current configuration:
- Audio
- Buffer Size
- Sample Rate
- DSP Load
- System
- Unit (your MOD device model/version)
- Build Date
- OS Version
- Kernel
- Machine
- Release
- Version
Basic
Personal
Use custom Bluetooth device name: If you are connecting to your device via Bluetooth, you can define the name you want your device to have.
Backup & Restore
Here you can back up or restore all your data for later recovery.
By default, that includes:
- Banks
- Pedalboards
By checking the respective boxes, you can also back up or restore:
- Device configuration (such as audio gains, Bluetooth config, etc.)
- All the plugins you have downloaded
Creating a Backup
- Insert a USB stick in the USB Host port (A) of your device. (Make sure the USB stick has enough disk space. Preferably, use a storage device with a FAT32 file system.)
- Check all boxes corresponding to the data that you want to back up
- Click "Backup user data..."
- Wait for the process to finish
Restoring a backup
- Insert the USB stick in which you stored the backup for your MOD device in the USB Host port (A) of your device.
- Check all boxes corresponding to the data that you want to restore
- Click "Restore user data..."
- Wait for the process to finish
Note: You may have to reboot your device to load the recovered data.
Reboot & Update
Here you can reboot your device and also restart it into restore/update mode for maintenance and manual updating.
Advanced
The Advanced Settings of the MOD WebGUI allow you to define device and interface settings important for developers or advanced users.
Audio Server
On the Audio Server section you can:
- Duplicate a mono pedalboard output into both device physical outputs
- Separate S/PDIF outputs (only for available for MOD Duo X)
- Use 256 frames as Buffer Size
This section is mostly related with the needs of your pedalboard and how you want to use your MOD device in your setup.
You can for example duplicate a mono output to be used for both device outputs, add two extra and completely independent outptus on the MOD Duo X (using the S/PDIF out port) or increase your Buffer size in case your pedalboards run heavy plugins and the extra latency doesn't disturb your setup and needs.
Services
In this section, you can activate services to use with some experimental features available on your MOD device.
User interface
On the user interface sction you can:
- Turn on the "Developer Mode". This will show you some extra meters and option in your MOD WebGUI
- Show beta plugins in the MOD Plugin Store of your device. You will be able to see listed and install beta plugins available in the MOD Plugin Store. These are plugins that have not been fully tested in the MOD platform and can have bugs and cause issues.
Workarounds
On this section you can activate some workarounds for known bugs in your device which our development team still didn't manage to find a more viable solution.
Device Updates
On this page, you can find the latest firmware versions for the MOD peripherals connected to your MOD device (which use the Control Chain port), such as the XF4 MOD Footswitch.
Dangerous
On the Dangerous section of the WebGUI settings, you can perform irreversible actions on your device, such as:
- Clear favorite plugin list
- Clear device settings
- Clear plugin license keys
- Delete all Banks
- Delete all Pedalboards
- Delete all Plugins
You can also reflash the controller board on your device.
This section is primarily intended for support purposes.
Creating & Managing Pedalboards
Please note that on the WebGUI the signals flow from left to right of the Constructor.
Despite that, on the physical devices, the signal flows as traditionally from right to left.
Creating a New Pedalboard
To create a new pedalboard:
- Drag and drop plugins from the Plugins Bar to the Pedalboard View.
- Connect plugins by clicking on their input/output nodes and drawing a connection.
- Repeat the first steps as many times needed to build your pedalboard.
Have fun with the endless possibilities of the MOD platform and enjoy finding your sound!
Plugin Connectivity
The plugins on the MOD platform can send and receive 3 types of data:
- Audio
- MIDI
- Control Voltage (CV)
Audio Connectivity
The virtual audio cables on the MOD WebGUI have a purple colour.
Audio connections transmit virtually all audio between the plugins in your virtual chain, just like a jack cable would send audio from a pedal to another in a physical pedalboard.
Please note that there are plugins with a single audio input and a single audio output.
Other plugins have two audio inputs and two audio outputs, meaning they both receive and send audio in stereo.
Lastly, some plugins have a single audio input but two audio outputs. That means that, internally, the plugin receives the audio in mono, but can transform that same audio into a stereo signal.
MIDI Connectivity
The virtual MIDI cables on the MOD WebGUI have a cyan colour.
MIDI connections transmit MIDI signals between the plugins in your virtual chain, just like a MIDI cable would send MIDI from one device to another in a physical setup.
Some plugins receive and send MIDI. Normally, those plugins are capable of transforming the received MIDI signal in a certain way.
Some other plugins only have a MIDI output. This means that they generate MIDI internally that can be sent to other plugins or devices in your chain.
Plugins like Generators or the MIDI to CV Converters receive a MIDI signal and convert it into some other type of signal. In the case of Generators, MIDI is typically converted into audio. Conversely, in the case of MIDI to CV Converters, the MIDI signal is converted into a Control Voltage signal.
Control Voltage Connectivity
The virtual Control Voltage cables on the MOD WebGUI have an orange colour.
CV allows modular-like control over plugin parameters.
You can use CV plugins connected and generate values that can be used to control most of the parameters from any Audio or MIDI plugins inside any of the MOD devices.
The MOD Duo X includes hardware CV inputs/outputs, which allows you to use CV communication also with external gear like modular synthesizers.
The hardware inputs and outputs on the MOD Duo X are represented in the inputs and outputs sections (respectively) of the MOD WebGUI constructor.
Gain Staging and Meter Plugins
Proper gain staging helps maintain optimal sound quality. Use utility plugins to:
- Monitor signal levels
- Adjust gain before and after processing stages
- Prevent clipping and unwanted distortion
Using meter plugins for gain staging purposes
Plugins that indicate how "hot" or "cold" your signal is in between some effects in your pedalboard - like the Level Meter- may be useful to help you with gain staging. Proper gain staging may help you avoid noise issues and get better quality sound.
For this reason, meter plugins may come in quite handy to help you understand if a plugin is reducing or increasing your signal, so you can compensate for that.
Using meter plugins effectively and save on CPU resources
The best approach to using meters is to place them in parallel in your chain instead of in series. This will help not only clean your pedalboard and have a better view of what is happening, but also save CPU resources on your device.
When you place the meter plugins in series, like the following:
plugin1 -> plugin2 -> meter -> plugin3
the meter has to wait for plugin2, and plugin3 needs to wait for the meter plugin.
If instead, you place it in parallel, like the following:
plugin1 -> plugin2 |-> plugin3 -> more plugins
|-> meter
you can have a meter in the pedalboard without it causing less time for the important plugins.
It is for this exact reason that the Level Meter only has an audio input port and no outputs.
Dealing with "too hot" audio signals
Certain plugins in the MOD platform - especially Distortion, Dynamics or Simulator plugins - may increase the internal gain staging levels beyond the advisable. That can happen especially when multiple plugins of these types are used together in series.
This can lead to unwanted noise issues and a lack of control over your signal. In some cases, it can even activate the safety mechanism built into the MOD devices that automatically shuts down any audio output!
To protect your MOD pedalboards from such issues, we suggest that after using meter plugins to check your level, especially after any potentially problematic plugin, and dial down the level control (when available) on that particular plugin.
If the plugin doesn't possess a "level" control, you can place a gain or volume plugin (like Gain, tinyGain or Volume) after that plugin (in series) and dial down the level to compensate. In this case, place the meter plugin after the gain or volume plugin to have an accurate result.
Either use a built-in level control or an external plugin to dial down the level until your meter plugin indicates a reasonable output value coming from the plugin.
You may need to repeat this process between other plugins in your entire chain to achieve a stable gain staging on your virtual pedalboard.
Dealing with "too cold" audio signals
Sometimes your signal may be too quiet, which makes it barely listenable.
Increasing the level at the wrong stages may boost mostly unwanted noise that can almost even blend with the desirable sound.
We recommend that you use a meter plugin to check the stage where your signal is getting quiet. It may be a plugin with the level set too low or with other parameters that are causing that issue.
After finding the source of the issue, re-dial the level controls (and if needed, also other parameters) in order to have a better signal.
You can also always use gain or volume plugin (like Gain, tinyGain or Volume) to increase your level. Another option is to use Dynamics plugins.
In any of these cases, do it with caution to not increase the ground floor noise.
If you are using an external sound source via the input of MOD, make sure that the output of that source is strong enough. In this case, take also a look at your input gain levels.
Final notes on gain staging
- If you are using a physical MOD device, they all possess LEDs that help you check the incoming and outgoing signals.
- Make sure that your output LEDs stay mostly green and maximum turn yellow at times. Never going red!
- Gain levels between other devices in your setup may not be uniform. When available, use the gain LEDs from the devices (just like on the MOD devices) to help you balance your signal. If you use some other device connected to your MOD inputs, make sure that the MOD inputs also stay in green and never go red.
- Make sure that the final output in your chain doesn't exceed 0dB.
Snapshots
What is a Snapshot?
In the "MOD world", a Snapshot works like a picture of the parameters on the plugins in your pedalboard at a specific moment.
They save parameter states within a pedalboard.
Snapshots allow you to quickly switch between different settings without reloading pedalboards.
This comes quite handy, especially when you consider that pedalboards take some time to load (depending on the amount and "heaviness" of the plugins in that specific pedalboard) and, for performance reasons, you may need an immediate change of multiple settings.
Let's say that you want to have different effects turned on and off in between different parts of a song and you also want to have certain parameters of each plugin in your chain dialed with other values. Snapshots are perfect for this job! They allow you to turn on/off as many effects as you want and simultaneously dial as many parameters as you want. They do it all for you, so you don't need to be an octopus to push hundreds of switches and dial thousands of knobs between your song's chorus and bridge.
Saving / loading pedalboard snapshots
Access the pedalboard snapshot menu by clicking on
. Find it on the pedalboard actions bar.
To save the changes to the current pedalboard snapshot, choose the option Save. To save a new snapshot use the option Save as and give it a name. To load, delete or rename a saved snapshot, use the option Load / Manage.
Please note that the snapshots live inside the pedalboards; therefore, you must save your pedalboard after saving a new snapshot, otherwise that snapshot will be lost.
On the MOD WebGUI, a single click on the name of the snapshot will load it. You also have the option to assign the snapshots list to a physical interface on your device by using the Assign all button.
Another way to navigate the snapshots is through an external MIDI controller connected to your MOD device. For more info on how to set up your device for that, check the link to your device:
NOTE for MOD Dwarf users: on the MOD Dwarf, you can also save snapshots from the device itself. Please take a look here to learn how to do it.
NOTE: the snapshot list currently cannot be reordered, so some care must be taken when saving new snapshots to be effectively navigated with an actuator or via MIDI.
Saving and Managing Pedalboards
To save a pedalboard, use the buttons Save or Save as on the pedalboard actions bar.
Save saves the current state of your pedalboard under the same name.
Save as saves a new pedalboard file under a new name.
NOTE: on the MOD Dwarf, you can also save pedalboards from the device itself. Please take a look here to learn how to do it.
All previously saved pedalboards can be found and loaded from the Pedalboards Library.
Assigning Controls & Expanding Functionality
One of the most powerful features of MOD devices is the possibility to assign pretty much any parameter to any control, either from your device or from peripheral devices.
To create an assignment:
- click on
above the plugin from the parameter that you want to assign - click on the
icon, found on the bottom-right corner of each parameter box, to open the assignment dialog box.
Note: For the presets list, you should click "Assign All" and you must have your list populated with more than one preset.
- a window with multiple tabs will pop-up, similar to the following:
- select the tab corresponding to the source controller for your assignment.
Note: Any parameter can be assigned, but some parameters can only be assigned to a specific type of actuator. The interface will not show the actuator as an option if it cannot be assigned to. Note that preset lists can also be assigned to actuators.
On the device
MOD Duo
If you want to make an assignment to one of the endless knobs or footswitches of your MOD DUO select the tab "Device".
Afterward, select the control you would like to assign the parameter to from the corresponding lists.
Note: the knobs of the MOD DUO can hold multiple assignments, but footswitches can only hold one.
MOD Duo X
If you want to assign an action to one of the endless knobs, knobs, or buttons of your MOD DUO X, select the "Device" tab.
On the MOD DUO X, you have a pagination system (learn more about it on Pagination and Switching Pages) that allows you to assign multiple parameters to each of the controls (endless knobs, knobs and buttons).
Select the control in this window that you want to assign to the corresponding page.
Take a look at the MOD Duo X User Guide to learn how to switch pages.
MOD Dwarf
If you want to make an assignment to one of the encoders or footswitches of your MOD Dwarf select the tab "Device".
Similar to the MOD Duo X, the MOD Dwarf has a pagination system. Yet, on the MOD Dwarf you also have a sub-pagination system.
The sub-pagination system is only available for encoders, allowing them to be mapped to multiple parameters on a single assignment page. The footswitches are only available on the pagination system and not the sub-pagination.
Check the MOD Dwarf User Guide to learn how to switch between pages and sub-pages.
MIDI controllers
The MOD devices have excellent MIDI capabilities, supporting both traditional MIDI connections and USB MIDI.
Check the type of connectors available on each device:
You can use both types of connections to input or output MIDI data, allowing you to assign MIDI Control Change messages to any parameter of your pedalboard, control Virtual Instruments (Generators) running inside your MOD system, among other possibilities.
Assigning plugin parameters to MIDI controllers
If you want to assign a parameter to an interface on a MIDI controller connected to your MOD device, after you access the assignment dialog box (which you can learn how to do at the beginning of this chapter), you must:
- select the "MIDI" tab,
- press save
- interact with the desired actuator (for example: push the button or turn the knob).
As soon as you interact with your MIDI controller and the assignment is successfully established, a pop-up message will appear in the top-right corner of your MOD WebGUI. Similar to the following:
Note: This assignment method is valid both for MIDI controllers connected via the MIDI input port or the USB-A port of your device.
MIDI Output
Some plugins have MIDI output ports, which generate MIDI output data, such as MIDI Control Change or MIDI Note On/Off messages. You can use this output to send this data to other gear in your setup.
MIDI ports setup
The WebGUI MIDI setup is relevant to setting which and how the MIDI ports are displayed on the MOD WebGUI Constructor (inputs and outputs sections).
Note that you do not have to enable a specific MIDI port to be able to use MIDI learn. For MIDI learn, all MIDI devices will work as soon as they are connected to your MOD device.
The MOD devices recognize your MIDI Controller when it is plugged in and add it to the MIDI ports list.
Yet, they are not directly visible in the input and output sections of the Constructor by default. To make them visible, you will have to enable them first by clicking on
button on the Status Bar.
Here you can select between two modes:
- Aggregate mode
- Separated mode
Please note that controllers connected via the MIDI input (and not the USB A port) will not be differentiated, even when used with MIDI Thru, due to the limitations of traditional MIDI ports.
Aggregated mode
If you select the Aggregated mode all the MIDI ports from all the connected MIDI controllers will appear as a single MIDI Input and single MIDI Output.
This will not allow you to differentiate between controllers if, for example, you have two instruments loaded and want to use one MIDI keyboard to play a bass sound and another to play a lead sound.
Separated mode
If you select the Separated mode and activate multiple controllers on the MIDI ports list, those active controllers will appear with different MIDI input and output ports on the respective sections of the Contructor window.
To enable only the necessary MIDI controllers, select the ports that you want to enable and click on the Save button.
Now you should see the new ports added to the constructor screen.
Virtual MIDI Loopback
If you check the Enable Virtual MIDI Loopback box, yet another new port will become available on the output section of the WebGUI.
This port allows you to send messages back into your MOD device, similar to what would happen if you physically connected the MIDI out of your MOD device to the MIDI in.
Control Chain devices
Control Chain is an open standard developed by MOD Devices. For more info, check the Control Chain page.
In general, Control Chain devices (like the MOD Footswitch or the Arduino Shield) can give you a longer control range and also better visual feedback about what you are controlling directly in your Control Chain device.
Assigning parameters to Control Chain devices
To assign a parameter from your MOD pedalboard to a control chain device, select the tab "Control Chain".
You will get a dropdown list with all the interfaces available via the Control Chain port connected to your MOD device. Select the one that you wish to assign.
Note: if you have no control chain devices connected to your MOD device, you will get the following message:
Using CV
- Plugin parameter assignments (knobs, MIDI, CV, Control Chain).
- MIDI learn and mapping.
- Using Control Chain devices.
CV Usage & Modulation
- Introduction to Control Voltage (CV) in the MOD system.
- Using CV internally vs. hardware CV (Duo X only).
- Assigning CV to parameters & modulation control.
- Setting up macro-controls with CV.
Advanced Features & Settings
- True Bypass feature.
- Monitoring CPU Usage & Performance.
- System Settings & Backup/Restore.
Troubleshooting & Support
- Common connection issues.
- MIDI and plugin troubleshooting.
- Factory reset & firmware updates.
Appendix: Keyboard Shortcuts, Tips, and Links
- List of useful shortcuts for the Web GUI.
- Direct links to MOD community resources.

