Difference between revisions of "MOD Web GUI User Guide"

From MOD Wiki
Jump to navigation Jump to search
 
(124 intermediate revisions by 8 users not shown)
Line 1: Line 1:
This chapter describes the graphical user interface (GUI) that is used for installing and removing plugins, setting up your pedalboards and banks, sharing pedalboards and more.
+
This page describes the graphical user interface (GUI) that is used for installing and removing plugins, setting up your pedalboards and banks, sharing pedalboards, updating your MOD devices and more.
  
[[File:webinterface_example_guitar.jpg|450px|thumb|Example pedalboard of a guitar player:  [https://pedalboards.moddevices.com/pedalboards/57e109ef2564d426b976d740 See it in action]]]
+
= Accessing the GUI =
[[File:webinterface_example_midi.jpg|450px|thumb|Example pedalboard with a MIDI sequencer: [https://pedalboards.moddevices.com/pedalboards/57fe65a42564d40b876f1235 See it in action]]]
+
Connect your MOD device to your PC or Mac using the USB cable which you received with your device. The operating system should recognize your unit as a network device and configure it automatically. However, this process may fail in certain Windows versions, if that is your case please check the [[Troubleshooting|troubleshooting page]].
  
=Accessing the GUI=
+
Then open your favorite browser and navigate to:<br />
In order to access the GUI, the MOD Duo needs to be hooked up to your device(*), either through USB or through Bluetooth.  
+
For the MOD Duo: http://modduo.local or http://192.168.51.1.<br />
 +
For the MOD Duo X: http://modduox.local or http://192.168.51.1. <br />
 +
For the MOD Dwarf: http://moddwarf.local or http://192.168.51.1. <br />
  
Follow the steps below to access the GUI.
+
If you are [[Bluetooth|connecting via BlueTooth]], visit http://192.168.50.1.
  
(*) the device can be anything that has access to a web browser, and has a USB host port, or Bluetooth connectivity. We recommend using a PC or laptop, because the interface is not yet optimized for smaller screen sizes.
+
=Creating a pedalboard=
  
==USB==
+
Once you have accessed the GUI you should see a screen like these:
# Power up the MOD Duo
+
 
# Connect the USB-B port of the MOD Duo to a USB port on your device
+
<div style="display:inline-block">
# Open your favorite browser, and navigate to 192.168.51.1
+
{|
 +
|-
 +
! MOD Duo
 +
|-
 +
| [[File:DUO_PedalboardView.png|800px]]
 +
|}
 +
</div>
 +
<div style="display:inline-block">
 +
{|
 +
|-
 +
! MOD Duo X
 +
|-
 +
| [[File:DUOX_PedalboardView.png|800px]]
 +
|}
 +
</div>
 +
 
 +
{|
 +
|-
 +
! MOD Dwarf
 +
|-
 +
| [[File:Dwarf_Pedalboard.png|800px]]
 +
|}
 +
</div>
 +
 
 +
 
 +
The numbered areas on the interface are:
 +
 
 +
# Pedalboard name
 +
# Pedalboard actions bar
 +
# Inputs
 +
# Pedalboard constructor
 +
# Outputs
 +
# Plugins bar
 +
# Mode selector (Constructor, Pedalboards, Banks and Store)
 +
# Status bar (Device actions and information)
 +
 
 +
{| class="wikitable"
 +
|-
 +
! MOD DUO !! MOD DUO X
 +
|-
 +
| On the left edge of the constructor area (section 3) of the MOD DUO Web GUI there are 3 connectors: 2 audio inputs and 1 MIDI input. || On the left edge of the constructor area (section 3) of the MOD DUO X Web GUI there are 5 connectors: 2 audio inputs, 1 MIDI input, 2 CV inputs and 1 expression pedal input.
 +
|-
 +
| On the right edge (section 5) there are another 3 connectors: 2 audio outputs and 1 MIDI output. All those connectors represent the real inputs and outputs of your MOD DUO. || On the right edge (section 5) there are 5 connectors: 2 audio outputs, 1 MIDI output and 2 CV outputs. All those connectors represent the real inputs and outputs of your MOD DUO X.
 +
|}
 +
 
 +
'''Be aware that on the interface''':
 +
* the signal flows from left to right;
 +
* purple cables transport audio signals;
 +
* cyan cables transport MIDI signals;
 +
* orange cables transport CV signals.
 +
 
 +
==New pedalboard==
 +
 
 +
To create a new pedalboard click on the [[File:gui-new-pedalboard.png|New pedalboard]] button in the pedalboard actions bar. This action will load the default pedalboard, which is a stereo gain connecting the audio inputs to the outputs.
 +
 
 +
'''This is a standard behaviour both for the MOD DUO and the DUO X'''
 +
 
 +
[[File:NewPedalboard.png|780px]]
 +
 
 +
==Adding and connecting plugins==
 +
 
 +
To add plugins, drag-and-drop one from the plugins bar to the pedalboard constructor area. To make a new connection, click on the plugin’s output jack and drag it to where you want to connect it. To unmake a connection, click on the connected jack, then drag and release it to any empty area on the constructor.
 +
 
 +
[[File:Adding_and_connecting.png|780px]]
 +
 
 +
Note that the inputs and outputs of your device are completely independent and can process multiple audio paths. The MOD devices allow you to create multiple connections coming out from the same output and also allows multiple connections to come in the same input. This feature allows the user to create complex pedalboards.
 +
 
 +
==Adjusting plugins parameters==
 +
 
 +
Each plugin has 3 icons on its top: info [[File:gui-info.png]], settings [[File:gui-settgins.png]] and delete [[File:gui-delete.png]]. To adjust the parameters of the plugin click on the settings icon.
 +
 
 +
[[File:gui-4.png]]
 +
 
 +
Each knob, list and switch represents a parameter of the plugin and can be adjusted as desired. The combination of all parameter values can be saved/loaded as a user preset and, for the cases in which they are available, factory presets can be loaded.
 +
 
 +
[[File:gui-5.png]]
 +
 
 +
==Assigning plugins parameters==
 +
 
 +
 
 +
One of the most powerful features that MOD devices offer is the ability to assign plugin parameters and preset lists to physical actuators, like knobs, buttons and footswitches.
 +
 
 +
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 is not allowed to be assigned to. Note that preset lists can also be assigned to actuators.
 +
 
 +
To create an assignment, first click on the fader icon [[File:gui-assign.png]], found on the bottom-right corner of each parameter box, to open the assignment dialog box. For the presets list you should click "Assign All" and you must have your list populated with more than one preset.
 +
 
 +
It will popup a window with multiple lists, similar with the following:
 +
 +
[[File:AssignmentsWindow.png|500px]]
 +
 
 +
===Removing an assignment===
 +
If you want to remove an assignment just select "None" tab and press save.
 +
 
 +
[[File:RemovingAssignment.png|500px]]
 +
 
 +
 
 +
===Making an assignment to a '''MOD DUO''' actuator===
 +
If you want to make an assignment to one of the endless knobs or footswitches of your MOD DUO select the tab "Device".
 +
 
 +
Afterwards, select the actuator you would like to assign the parameter to from the correspondent lists.
 +
 
 +
'''Note''': the knobs of the MOD DUO can hold multiple assignments but footswitches can only hold one.
 +
 
 +
 
 +
[[File:DUO_AssigningPluginsParametersToActuators1.png|500px]]
 +
[[File:DUO_AssigningPluginsParametersToActuators2.png|500px]]
 +
 
 +
 
 +
===Making an assignment to a '''MOD DUO X''' actuator===
 +
If you want to make an assignment to one of the endless knobs, knobs or buttons of your MOD DUO X select the tab "Device".
 +
 
 +
On the MOD DUO X, you have a pagination system (learn more about it on [[Duo_X_User_Guide#Pagination|Pagination]] and [[Duo_X_User_Guide#Switching_pages|Switching Pages]]) that allows you to assign multiple parameters to each of the actuators (endless knobs, knobs and buttons).
 +
 
 +
To switch between these pages you should use the [[Duo_X_User_Guide#Performance_buttons|performance buttons]].
 +
 
 +
Select on this window the actuator that you want to assign on the correspondent page.
 +
 
 +
[[File:DUOX_AssigningPluginsParametersToActuators1.png|500px]]
 +
[[File:DUOX_AssigningPluginsParametersToActuators2.png|500px]]
 +
 
 +
===Making an assignment to a MIDI Controller===
 +
If you want to assign any type of parameter to an actuator of a MIDI Controller connected to your MOD device you must select the "MIDI" tab, press save and interact with the desired actuator (for example: push the button or turn the knob).
 +
 
 +
[[File:AssigmentToMIDIController.png|500px]]
 +
 
 +
Learn more on [[MOD_Web_GUI_User_Guide#MIDI_devices|Expanding controls / MIDI devices]].
 +
 
 +
===Making an assignment to a Control Chain Device===
 +
If you want to assign a parameter to a control chain device (like the [https://www.moddevices.com/products/mod-footswitch MOD Footswitch] or the [https://www.moddevices.com/products/arduino-shield Arduino Shield]) select the tab "Control Chain".
 +
 
 +
You will get a dropdown list with all the actuators that you have on the control chain connected to your MOD device. Select the one that you wish to assign.
 +
 
 +
[[File:AssigningToControlChain.png|600px]]
 +
 
 +
 
 +
'''Note''': if you have no control chain devices connected to your MOD device you will get the following message:
 +
 
 +
[[File:AssigningToNOControlChain.png|500px]]
 +
 
 +
For more info check [[Control Chain]]
 +
 
 +
===Making an assignment to a CV controller===
 +
If you want to assign a parameter to one CV controller connected to your MOD device select the tab "CV".
 +
 
 +
 
 +
====MOD DUO X====
 +
For the MOD DUO X users, on the CV window you will have a dropdown list already filled with the hardware CV/EXP input showing up as a CV addressing source.
 +
 
 +
Select from there if you want to use an expression pedal or one of the two CV inputs.
 +
 
 +
[[File:DUOX_AssignToCV.png|500px]]
 +
 
 +
====Other MOD devices====
 +
For other MOD devices it is necessary to create an internal CV addressing source.
 +
 
 +
[[File:NoCV.png|500px]]
 +
 
 +
 
 +
* For that you need to load one CV plugin from your plugins bar.
 +
 
 +
[[File:CVPlugins.png|500px]]
 +
 
 +
 
 +
'''Note''': if you have no Control Voltage plugins available on your plugins bar, head over to the shop and you will find pretty cool ones for free.
 +
 
 +
* Drag and drop one of those plugins into your pedalboard and click on [[File:ManageCVPortsButton.png|150px]]
 +
 
 +
* Check boxes will appear next to the outputs of the CV plugin that you've just loaded. Select and label the ones that you want to use.
 +
 
 +
[[File:LabelCV.png|300px]]
 +
 
 +
* This way you just created an internal CV controller. Go back to the CV tab of the control you want to assign and now you will be able to see a dropdown menu with the labels that you just created on your CV plugins.
 +
 
 +
[[File:InternalCV.png|500px]]
 +
 
 +
===Advanced Settings===
 +
There is also the possibility to adjust further options by clicking on the "Advanced" button.
 +
 
 +
By clicking on it your assignment window will stretch.  
 +
 
 +
[[File:AdvancedAssignSettings.png|200px]]
 +
 
 +
On the stretched window you can:
 +
 
 +
* Define a different label that you would like to be displayed on the displays of your device;
 +
* Enter the range that you want the mapped actuator to sweep within;
 +
* Set the sensitivity (amount of steps from minimum to maximum) of the actuator from the dropdown menu;
 +
* Set the operational mode polarity of your CV control.
  
==Bluetooth==
 
# Power up the MOD Duo
 
# [[Chapter_1:_Device#Bluetooth|Make the Bluetooth connection]]
 
# Open your favorite browser, and navigate to 192.168.50.1
 
  
=Bottom bar=
+
Once you have done the adjustments, click on the '''save''' button to execute the assignment. At this point you should see the assigned information on the display and be able to operate the parameter through the actuator you have chosen.
The bar at the bottom of the web interface allows you to:
 
*Navigate to different sections of the web interface: use the buttons on the left
 
**From left to right: pedalboard builder, pedalboard library, banks, plugin store
 
*Add/remove MIDI devices: click the "MIDI PORTS" button
 
*Bypass the effects chain for each individual input: click the bypass buttons
 
*Monitor the CPU and RAM usage
 
*Keep your MOD Duo up to date: hover over the rightmost button
 
  
[[File:Webinterface_bottombar.jpg|thumb|none|700px|The navigation bar at the bottom of the web interface]]
+
[[File:dwarf screen blue.png|500px]]
  
=Pedalboard builder=
+
TODO: Get version of this image on the DUO X and replace this one with other background
[[File:Webinterface_pbbuilder.jpg|thumb|none|700px|The pedalboard builder]]
 
  
==Inputs and outputs==
+
==Saving / loading pedalboard snapshots==
The inputs can be found on the left side of the interface, the outputs can be found on the right side of the interface. The signal flow goes from left to right.
 
  
The top two inputs are the physical audio inputs on your device. The other(*) inputs on the left side are [[#Bottom bar|the MIDI devices that you have added]], together with the DIN-MIDI in port that is always shown.
+
You have the possibility to save the combination of parameter adjustments as a pedalboard snapshot. In order to do so, turn on the pedalboard snapshot mode by clicking on [[File:SnapshotsButton.png|150px]]. Find it on the pedalboard actions bar.  
  
Likewise, the top two outputs are the physical audio outputs of your device. The other(*) outputs on the right side are [[#Bottom bar|the MIDI devices that you have added]], together with the DIN-MIDI out port that is always shown.
+
[[File:SnapshotsMenu.png|800px]]
  
(*) hover over the input/output to see to which MIDI device it belongs.
+
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'''.
  
==Plugin descriptions==
+
[[File:LoadManageSnapshots.png|500px]]
In order to see a brief overview of the plugin controls, as well as a short description of what the plugin does, simply click on the respective plugin in the bar at the bottom of the screen.
 
  
==Adding/removing plugins to/from your pedalboard==
+
A single click on the name of the snapshot will load it. You also have the option to assign the snapshots list to an actuator by using the '''Assign all''' button.
Adding a new plugin to your pedalboard is very intuitive, simply select a plugin from the bar in the bottom of the screen, then drag and drop it onto the wooden background and connect it. The canvas will automatically resize when you drag a plugin to the edge of the display.  
 
  
To remove a plugin, simply press the garbage bin icon in the upper right-hand side of the plugin. This will also remove the connections to that plugin.
+
Another way to navigate the snapshots [[Device_Settings#Sync_.26_MIDI|through an external MIDI controller]] connected to your MOD device.
  
==Making/removing connections==
+
'''NOTE:''' the snapshot list currently cannot be reordered, so some care must be taken when saving new shapshots in ordered to be effectively navigated with an actuator or via MIDI.
The MOD Duo has different types of cables that can be connected to different ports:
 
*Purple for audio
 
*Blue for MIDI
 
*Orange for CV
 
  
Connections can be made starting from signal sources (your inputs on the left or the outputs of plugins) to signal inputs (your outputs on the right, or the inputs of plugins)
+
==Saving a pedalboard==
  
Click, hold and drag the plug to the desired input port, and a connection is made.
+
To save a pedalboard use the buttons '''Save''' or '''Save as''' on the pedalboard actions bar. All previously saved pedalboards can be found and loaded from the pedalboards library. To access the pedalboards library click on its button [[File:gui-pedalboards.png|Pedalboards]] in the mode selection bar.
  
You will notice that even after a connection has been made, you can still make more connections from the same output. The same goes for the inputs, you can connect as many outputs as you want, to a single input. Experiment and come up with the craziest ideas!
+
[[File:Dwarf_Pedalboard_Library.png|800px]]
  
To remove a connection: click, hold and drag the plug away from the input, the connection will disappear immediately.
+
A single click on the pedalboard image or name will load it to the constructor. To delete a pedalboard click on its trash icon [[File:gui-trash.png|Trash]] on the right of the pedalboard name.
  
==Accessing plugin configuration screen==
+
==Organizing Banks==
In case you want to tweak the different parameters that are not directly shown in the interface, create presets for the plugin or set up physical controls for changing parameters (actuator mapping), you need to access the plugin configuration screen.
 
  
Simply press the gear icon in the upper right-hand side of the plugin to enter the configuration screen.
+
In order to make it easy to access your pedalboards while the MOD device is disconnected from your PC, Mac or tablet, you can organize your pedalboards in banks. To access the banks configuration click on the banks icon [[File:gui-banks.png|Banks]] in the mode selection bar.  
  
[[File:Webinterface_pluginconfig.jpg|thumb|none|700px|The plugin configuration screen]]
+
[[File:Dwarf_OrganizingBanks.png|900px]]
  
===Setting up actuator mapping===
+
In the banks configuration mode, use the [[File:gui-add-bank.png|Add bank]] button to create a new bank and name it as you like. At this point your 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.
# Press the fader icon next to a parameter in the plugin configuration screen
 
# Select an actuator(*) from the drop-down list and press save
 
# If "MIDI Learn" was selected, send the desired MIDI command, it will be detected by the system
 
  
Now you can test the actuator mapping. The parameter is now greyed out, and unable to be changed through the web interface, you have successfully mapped an actuator!
+
You can now navigate through your banks using the [[Device_Settings#Banks|Device Menu]].
  
(*) the actuators can be mapped to parameters based on the following matrix:
+
'''On the MOD Duo,''' you can also [[Device_Settings#MOD_Duo:_Changing_pedalboards_using_the_footswitches|use the Footswitches]] to navigate through the pedalboards of a bank. In order to do it just active the option "Foot Nav" on the Settings of your MOD Duo.
  
{| class="wikitable" style="text-align:center;"
+
==Installing new plugins==
! X !! Footswitch !! Knob !! MIDI Learn
+
 
|-
+
By default, MOD devices come with many plugins installed, but you can install even more. The plugins available for download for MOD devices are created either by the MOD team or by independent developers.
! Bypass
+
 
| style="background: green;" | Yes || No  || style="background: green;" | Yes
+
In order to install new plugins, you need to access the plugin store by clicking on its icon [[File:gui-store.png|Plugin store]] in the mode selection bar. After you have accessed the store you can look for the plugin you want by filtering by category or typing a keyword in the search box.
|-
+
 
! Toggle
+
[[File: Dwarf_Shop.png|800px]]
| style="background: green;" | Yes || No || style="background: green;" | Yes
+
 
|-
+
Once you have decided which plugin you want to '''install''', click on it to open the description dialog, and then click on the install button. The plugin will be automatically downloaded and installed on your device. You can also '''remove''' or '''upgrade''' an already installed plugin by clicking on the corresponding button.
! Trigger
+
 
| style="background: green;" | Yes || No || style="background: green;" | Yes
+
[[File:gui-14.png]]
 +
 
 +
==Sharing a pedalboard==
 +
 
 +
Another great feature that the MOD devices have is allowing you to share and load pedalboards from the existing MOD online community. To share a pedalboard, go to the pedalboard constructor and click on [[File:gui-share.png|Share pedalboard]] 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 it again. When you are done, click on the '''Share''' button.
 +
 
 +
[[File:gui-15.png]]
 +
 
 +
To load pedalboards from another MOD user, visit: https://pedalboards.moddevices.com or click [[File:PedalboardLibraryIcon.png|50px]] on the Mode Selector bar and then [[File:BrowseOnlinePedalboards.png|200px]] on the top right of your screen. Listen to the samples and once you find a pedalboard you like, click on the '''Try Now''' button. Note that in order to load an online pedalboard, you need to have the MOD GUI opened.
 +
 
 +
[[File:gui-16.png|thumb|none|680px|Example of a pedalboard shared on pedalboards.moddevices.com]]
 +
 
 +
Use the '''View More''' button to see what plugins were used to create the pedalboard. Additionally you can list the pedalboards that were made using a specific plugin. In order to do this, open the plugin description dialog (for example by clicking on the
 +
[[File:gui-info-2.png|Info]] info button on the top of the plugin), and then click on the '''See it in action''' button.
 +
 
 +
[[File:gui-17.png]]
 +
 
 +
=Expanding Controls=
 +
 
 +
==MIDI devices==
 +
 
 +
There are two ways to connect MIDI devices, via the classic MIDI DIN connector and via USB.
 +
 
 +
===MIDI DIN - Input===
 +
 
 +
To use the MIDI DIN simply connect your device to the MIDI Input of your MOD device and use the '''MIDI Learn''' function to assign a control to a plugin parameter (see [[MOD_Web_GUI_User_Guide#Making_an_assignment_to_a_MIDI_Controller|Making an assignment to a MIDI controller]]).
 +
 
 +
[[File:AssigmentToMIDIController.png|500px]]
 +
 
 +
In order to map a parameter to a MIDI device, click save on the MIDI tab of your assignments and interact with the actuator that you want to assign.
 +
 
 +
===MIDI DIN - Output===
 +
 
 +
Some plugins have MIDI output ports, which generate MIDI output data like control change messages and notes. You can use this output to send this data to your other equipment.
 +
 
 +
===MIDI USB===
 +
 
 +
In addition to the classic MIDI ports you can also use the USB port to connect your MIDI controllers. Your MOD device will recognize your MIDI device when it is plugged in and add it to the MIDI ports list. Because a single MIDI device can have multiple ports, they are not visible in the assembler by default. To make them visible you will have to enable them first by clicking on [[File:gui-midi-ports.png]].
 +
 
 +
[[File:MIDIPorts.png|500px]]
 +
 
 +
If you select the '''Aggregate 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.
 +
 
 +
[[File: AggregatedMIDIPorts.png|800px]]
 +
 
 +
If you select '''Separated mode''' each single port of each single controller that you have connected to your MOD device and have active on your MIDI ports list will appear with different MIDI input and output.
 +
   
 +
On the MIDI ports list 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.
 +
 
 +
[[File: SeparatedMIDIPorts.png|800px]]
 +
 
 +
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.
 +
 
 +
=True Bypass=
 +
 
 +
The MOD devices have a true bypass circuit for each pair of input/output. This allows you to physically connect input 1 to output 1, and input 2 to output 2. The true bypass is enabled when the device is off and it is automatically disabled after the current pedalboard is loaded.
 +
 
 +
You can enable or disable the true bypass via the GUI using the two bypass buttons
 +
[[File:gui-bypass.png]] in the status bar. As a second option, you can control the true bypass using a special plugin called '''Hardware Bypass'''.
 +
 
 +
[[File:duo-bypass-plugin.png]]
 +
 
 +
If you can't find it in your Plugins Bar, install it from the plugins store (search for '''Hardware Bypass''') (see [[MOD_Web_GUI_User_Guide#Installing_new_plugins|Installing new plugins section]]) and add it to your pedalboard. Now you can assign the ON/OFF parameter to any physical actuator (see [[MOD_Web_GUI_User_Guide#Assigning_plugins_parameters_to_actuators|Assigning plugins parameters to actuators]]) and control the true bypass with it.
 +
 
 +
=CPU Usage=
 +
 
 +
In the status bar of the GUI there are CPU and RAM meters. It is useful to monitor these resources when you are creating your pedalboard. It’s recommended to keep the CPU usage lower than 80%. Note that each plugin consumes a different amount of CPU and RAM.
 +
 
 +
[[File:gui-23.png]]
 +
 
 +
=Settings=
 +
 
 +
The "engine" button at the status bar will open the Settings page.
 +
 
 +
{|
 
|-
 
|-
! List
+
! MOD DUO !! MOD DUO X
| style="background: green;" | Yes || style="background: green;" | Yes || style="background: orange;" | Only for lists with 2 values
 
 
|-
 
|-
! Value
+
| [[File:Duo_Settings.png|850px]] || [[File:DuoX_Settings.png|850px]]
| style="background: orange;" | Only for Tap Tempo || style="background: green;" | Yes || style="background: green;" | Yes
 
 
|}
 
|}
  
If you would like to dive in further, click "ADVANCED", and more options will show up
+
==System Information==
# Enter the label that you would like to be displayed on the displays of the MOD Duo
 
# Enter the range that you want the mapped actuator to sweep within, inverted ranges are also possible by setting the first parameter higher than the second parameter
 
# Set the sensitivity (amount of steps from minimum to maximum) of the actuator from the dropdown menu
 
  
===Setting up and using plugin presets===
+
At the right hand side you will find information about your device configuration. Audio settings, system specification and software versions.
TODO: explain routine, etc
 
  
==Saving your pedalboard==
+
==Basic Settings==
In the bar on the top there are two buttons that you can press to save your pedalboard.
 
  
*Press the "Save" button for saving to the current pedalboard while keeping the same name
+
===Personal===
*Press the "Save as" button for saving the current pedalboard with a different name
 
  
==Sharing your pedalboard==
+
* '''Use custom Bluetooth device name:''' If you are connecting to your device through a Bluetooth network, you may choose here the name you want your device to have.
In the bar on the top there is a button named "Share" which allows you to share your current pedalboard with the world!
 
  
Press the button, fill in the small form and press the "Just share" button if you want to share your pedalboard without a sound-sample.
+
===Backup & Restore===
  
Alternatively, press the record icon to start recording a short sound segment. Once you are done, the "Just share" button will have changed to "Share", press it to finalize the process.
+
This feature allows you to make a backup of all your data to later recovery. You can backup Banks, Pedalboards, Device configuration (such as audio gains, Bluetooth config, etc) and all the plugins you have downloaded.
  
==Auto update==
+
'''Creating a Backup'''
When an update becomes available for the MOD Duo, a message pops up from the icon in the bottom-right of the screen, prompting you to update your device. Simply press the "Get update" text, and the process will start.
 
  
=Pedalboard library=
+
Insert a USB stick in the USB Host port (A) in the back of your unit. Make sure the USB stick has enough disk space, preferably with a fat32 file system.
This screen shows all the pedalboards that are currently saved on the device. Simply click on a pedalboard to make it the active pedalboard.  
 
  
You are also able to remove the boards that you no longer use from the device by pressing their respective bin icons.
+
By default, user configuration, pedalboards, and banks are included in the backup. Mark the correspondent checkboxes if you want to also backup the plugins you have installed and all the device settings, such as input and output gain.
  
[[File:Webinterface_pblibrary.jpg|thumb|none|700px|The pedalboard library]]
+
Finally, click "Backup user data..."
  
=Banks=
+
'''Restoring a backup'''
In the banks window you can manage your collection of banks (groups of pedalboards).
 
[[File:Webinterface_banks.jpg|thumb|none|700px|Screenshot of the banks section]]
 
  
==Creating a new bank==
+
Insert the USB stick in which you did the backup in the USB Host port (A) in the back of your unit.
# Press "ADD BANK"
 
# Enter a name for your new bank
 
# [[#Bank_navigation|Choose your means of navigation]]
 
# [[#Adding_pedalboards|Add the pedalboards that you want]]
 
# Put them in the order that you want
 
  
==Bank navigation==
+
Click "Restore user data..." and wait for the process to finish.
You can cycle through the pedalboards in the bank in two ways:
 
# Using the footswitches on the MOD Duo: left footswitch is previous, right footswitch is next pedalboard
 
# Using MIDI program changes: enter the MIDI channel that you want to receive the program changes over. When sending a program change = N message, the Nth board in your bank will be loaded. For example, by sending MIDI program change = 1, the first board in your bank will be loaded.  
 
  
==Adding pedalboards==
+
'''Note:''' You may have to reboot your device to be able to load the recovered data.
Adding pedalboards is easy, simply find the pedalboard you would like to add in the section on the right, and drag-and-drop it into the bank (the big empty space in the middle for empty banks).
 
  
=Plugin store=
+
===Reboot & Update===
In the plugin store you can install, remove and update the plugins on your device.
 
[[File:Webinterface_store.jpg|thumb|none|700px|Screenshot of the plugin store]]
 
  
==Installing plugins==
+
Here you can reboot your device and also restart it into restore/update mode for maintenance and manual updating.
# Find the plugin you would like to install by browsing through the store
 
# Click on it, a popup will open
 
# Press the "INSTALL" button
 
# The plugin(*) will now be installed
 
  
(*) Some plugins come in bundles, installing one plugin from that bundle will install the complete bundle.
+
==Advanced Settings==
  
==Updating plugins==
+
{|
# If an update is available, the plugin label that normally shows "INSTALLED" will change to "NEW VERSION"
+
|-
# Click on the plugin, a popup will open
+
! MOD DUO !! MOD DUO X
# Press the "UPGRADE" button
+
|-
# The plugin will now be upgraded to the new version
+
|[[File:Duo_AdvancedSettings.png|850px]] ||[[File:DuoX_AdvancedSettings.png|850px]]
 
+
|}
There is also an "Update All" button at the top-right corner of the page, press this button to update all plugins that have new versions available.
 
 
 
==Removing plugins==
 
# Click on the plugin that you would like to remove, a popup will open
 
# Press the "REMOVE" button
 
# The plugin(*) will now be removed
 
 
 
(*) Some plugins come in bundles, removing one plugin from that bundle will uninstall the complete bundle.
 
  
----
+
On the Advance settings you can:
 +
* define audio parameters such as buffer size and behaviour of the audio outputs;
 +
* additional services available on your MOD device;
 +
* user interface settings such as developer view (that shows you a bit more info about the state of the processors) or show beta plugins on the store (this plugins are still in development, so we can find out bugs or unexpected behaviours);
 +
* other tools like workarounds to help solve some bugs experienced with some devices.
  
[[Chapter_1:_Device|< Previous chapter]] | [[Chapter_3:_Plugins|Next chapter >]]
+
==Device Updates==
 +
[[File:device-updates.png|700px]]
  
* [[Chapter 1: Device]]
+
On the Device updates menu you can find the latest firmware versions for control chain devices such as the [https://www.moddevices.com/products/mod-footswitch MOD footswitch] or the [https://www.moddevices.com/products/arduino-shield Arduino Shield].
* [[Chapter 2: Web interface]]
 
* [[Chapter 3: Plugins]]
 
* [[Chapter 4: Warnings]]
 
* [[Chapter 5: Resources]]
 

Latest revision as of 10:49, 29 April 2021

This page describes the graphical user interface (GUI) that is used for installing and removing plugins, setting up your pedalboards and banks, sharing pedalboards, updating your MOD devices and more.

Accessing the GUI

Connect your MOD device to your PC or Mac using the USB cable which you received with your device. The operating system should recognize your unit as a network device and configure it automatically. However, this process may fail in certain Windows versions, if that is your case please check the troubleshooting page.

Then open your favorite browser and navigate to:
For the MOD Duo: http://modduo.local or http://192.168.51.1.
For the MOD Duo X: http://modduox.local or http://192.168.51.1.
For the MOD Dwarf: http://moddwarf.local or http://192.168.51.1.

If you are connecting via BlueTooth, visit http://192.168.50.1.

Creating a pedalboard

Once you have accessed the GUI you should see a screen like these:

MOD Duo
DUO PedalboardView.png
MOD Duo X
DUOX PedalboardView.png
MOD Dwarf
Dwarf Pedalboard.png


The numbered areas on the interface are:

  1. Pedalboard name
  2. Pedalboard actions bar
  3. Inputs
  4. Pedalboard constructor
  5. Outputs
  6. Plugins bar
  7. Mode selector (Constructor, Pedalboards, Banks and Store)
  8. Status bar (Device actions and information)
MOD DUO MOD DUO X
On the left edge of the constructor area (section 3) of the MOD DUO Web GUI there are 3 connectors: 2 audio inputs and 1 MIDI input. On the left edge of the constructor area (section 3) of the MOD DUO X Web GUI there are 5 connectors: 2 audio inputs, 1 MIDI input, 2 CV inputs and 1 expression pedal input.
On the right edge (section 5) there are another 3 connectors: 2 audio outputs and 1 MIDI output. All those connectors represent the real inputs and outputs of your MOD DUO. On the right edge (section 5) there are 5 connectors: 2 audio outputs, 1 MIDI output and 2 CV outputs. All those connectors represent the real inputs and outputs of your MOD DUO X.

Be aware that on the interface:

  • the signal flows from left to right;
  • purple cables transport audio signals;
  • cyan cables transport MIDI signals;
  • orange cables transport CV signals.

New pedalboard

To create a new pedalboard click on the New pedalboard button in the pedalboard actions bar. This action will load the default pedalboard, which is a stereo gain connecting the audio inputs to the outputs.

This is a standard behaviour both for the MOD DUO and the DUO X

NewPedalboard.png

Adding and connecting plugins

To add plugins, drag-and-drop one from the plugins bar to the pedalboard constructor area. To make a new connection, click on the plugin’s output jack and drag it to where you want to connect it. To unmake a connection, click on the connected jack, then drag and release it to any empty area on the constructor.

Adding and connecting.png

Note that the inputs and outputs of your device are completely independent and can process multiple audio paths. The MOD devices allow you to create multiple connections coming out from the same output and also allows multiple connections to come in the same input. This feature allows the user to create complex pedalboards.

Adjusting plugins parameters

Each plugin has 3 icons on its top: info Gui-info.png, settings Gui-settgins.png and delete Gui-delete.png. To adjust the parameters of the plugin click on the settings icon.

Gui-4.png

Each knob, list and switch represents a parameter of the plugin and can be adjusted as desired. The combination of all parameter values can be saved/loaded as a user preset and, for the cases in which they are available, factory presets can be loaded.

Gui-5.png

Assigning plugins parameters

One of the most powerful features that MOD devices offer is the ability to assign plugin parameters and preset lists to physical actuators, like knobs, buttons and footswitches.

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 is not allowed to be assigned to. Note that preset lists can also be assigned to actuators.

To create an assignment, first click on the fader icon Gui-assign.png, found on the bottom-right corner of each parameter box, to open the assignment dialog box. For the presets list you should click "Assign All" and you must have your list populated with more than one preset.

It will popup a window with multiple lists, similar with the following:

AssignmentsWindow.png

Removing an assignment

If you want to remove an assignment just select "None" tab and press save.

RemovingAssignment.png


Making an assignment to a MOD DUO actuator

If you want to make an assignment to one of the endless knobs or footswitches of your MOD DUO select the tab "Device".

Afterwards, select the actuator you would like to assign the parameter to from the correspondent lists.

Note: the knobs of the MOD DUO can hold multiple assignments but footswitches can only hold one.


DUO AssigningPluginsParametersToActuators1.png DUO AssigningPluginsParametersToActuators2.png


Making an assignment to a MOD DUO X actuator

If you want to make an assignment to one of the endless knobs, knobs or buttons of your MOD DUO X select the tab "Device".

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 actuators (endless knobs, knobs and buttons).

To switch between these pages you should use the performance buttons.

Select on this window the actuator that you want to assign on the correspondent page.

DUOX AssigningPluginsParametersToActuators1.png DUOX AssigningPluginsParametersToActuators2.png

Making an assignment to a MIDI Controller

If you want to assign any type of parameter to an actuator of a MIDI Controller connected to your MOD device you must select the "MIDI" tab, press save and interact with the desired actuator (for example: push the button or turn the knob).

AssigmentToMIDIController.png

Learn more on Expanding controls / MIDI devices.

Making an assignment to a Control Chain Device

If you want to assign a parameter to a control chain device (like the MOD Footswitch or the Arduino Shield) select the tab "Control Chain".

You will get a dropdown list with all the actuators that you have on the control chain connected to your MOD device. Select the one that you wish to assign.

AssigningToControlChain.png


Note: if you have no control chain devices connected to your MOD device you will get the following message:

AssigningToNOControlChain.png

For more info check Control Chain

Making an assignment to a CV controller

If you want to assign a parameter to one CV controller connected to your MOD device select the tab "CV".


MOD DUO X

For the MOD DUO X users, on the CV window you will have a dropdown list already filled with the hardware CV/EXP input showing up as a CV addressing source.

Select from there if you want to use an expression pedal or one of the two CV inputs.

DUOX AssignToCV.png

Other MOD devices

For other MOD devices it is necessary to create an internal CV addressing source.

NoCV.png


  • For that you need to load one CV plugin from your plugins bar.

CVPlugins.png


Note: if you have no Control Voltage plugins available on your plugins bar, head over to the shop and you will find pretty cool ones for free.

  • Drag and drop one of those plugins into your pedalboard and click on ManageCVPortsButton.png
  • Check boxes will appear next to the outputs of the CV plugin that you've just loaded. Select and label the ones that you want to use.

LabelCV.png

  • This way you just created an internal CV controller. Go back to the CV tab of the control you want to assign and now you will be able to see a dropdown menu with the labels that you just created on your CV plugins.

InternalCV.png

Advanced Settings

There is also the possibility to adjust further options by clicking on the "Advanced" button.

By clicking on it your assignment window will stretch.

AdvancedAssignSettings.png

On the stretched window you can:

  • Define a different label that you would like to be displayed on the displays of your device;
  • Enter the range that you want the mapped actuator to sweep within;
  • Set the sensitivity (amount of steps from minimum to maximum) of the actuator from the dropdown menu;
  • Set the operational mode polarity of your CV control.


Once you have done the adjustments, click on the save button to execute the assignment. At this point you should see the assigned information on the display and be able to operate the parameter through the actuator you have chosen.

Dwarf screen blue.png

TODO: Get version of this image on the DUO X and replace this one with other background

Saving / loading pedalboard snapshots

You have the possibility to save the combination of parameter adjustments as a pedalboard snapshot. In order to do so, turn on the pedalboard snapshot mode by clicking on SnapshotsButton.png. Find it on the pedalboard actions bar.

SnapshotsMenu.png

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.

LoadManageSnapshots.png

A single click on the name of the snapshot will load it. You also have the option to assign the snapshots list to an actuator by using the Assign all button.

Another way to navigate the snapshots through an external MIDI controller connected to your MOD device.

NOTE: the snapshot list currently cannot be reordered, so some care must be taken when saving new shapshots in ordered to be effectively navigated with an actuator or via MIDI.

Saving a pedalboard

To save a pedalboard use the buttons Save or Save as on the pedalboard actions bar. All previously saved pedalboards can be found and loaded from the pedalboards library. To access the pedalboards library click on its button Pedalboards in the mode selection bar.

Dwarf Pedalboard Library.png

A single click on the pedalboard image or name will load it to the constructor. To delete a pedalboard click on its trash icon Trash on the right of the pedalboard name.

Organizing Banks

In order to make it easy to access your pedalboards while the MOD device is disconnected from your PC, Mac or tablet, you can organize your pedalboards in banks. To access the banks configuration click on the banks icon Banks in the mode selection bar.

Dwarf OrganizingBanks.png

In the banks configuration mode, use the Add bank button to create a new bank and name it as you like. At this point your 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, you can also use the Footswitches to navigate through the pedalboards of a bank. In order to do it just active the option "Foot Nav" on the Settings of your MOD Duo.

Installing new plugins

By default, MOD devices come with many plugins installed, but you can install even more. The plugins available for download for MOD devices are created either by the MOD team or by independent developers.

In order to install new plugins, you need to access the plugin store by clicking on its icon Plugin store in the mode selection bar. After you have accessed the store you can look for the plugin you want by filtering by category or typing a keyword in the search box.

Dwarf Shop.png

Once you have decided which plugin you want to install, click on it to open the description dialog, and then click on the install button. The plugin will be automatically downloaded and installed on your device. You can also remove or upgrade an already installed plugin by clicking on the corresponding button.

Gui-14.png

Sharing a pedalboard

Another great feature that the MOD devices have is allowing you to share and load pedalboards from the existing MOD online community. To share a pedalboard, go to the pedalboard constructor and click on Share pedalboard 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 it again. When you are done, click on the Share button.

Gui-15.png

To load pedalboards from another MOD user, visit: https://pedalboards.moddevices.com or click PedalboardLibraryIcon.png on the Mode Selector bar and then BrowseOnlinePedalboards.png on the top right of your screen. Listen to the samples and once you find a pedalboard you like, click on the Try Now button. Note that in order to load an online pedalboard, you need to have the MOD GUI opened.

Example of a pedalboard shared on pedalboards.moddevices.com

Use the View More button to see what plugins were used to create the pedalboard. Additionally you can list the pedalboards that were made using a specific plugin. In order to do this, open the plugin description dialog (for example by clicking on the Info info button on the top of the plugin), and then click on the See it in action button.

Gui-17.png

Expanding Controls

MIDI devices

There are two ways to connect MIDI devices, via the classic MIDI DIN connector and via USB.

MIDI DIN - Input

To use the MIDI DIN simply connect your device to the MIDI Input of your MOD device and use the MIDI Learn function to assign a control to a plugin parameter (see Making an assignment to a MIDI controller).

AssigmentToMIDIController.png

In order to map a parameter to a MIDI device, click save on the MIDI tab of your assignments and interact with the actuator that you want to assign.

MIDI DIN - Output

Some plugins have MIDI output ports, which generate MIDI output data like control change messages and notes. You can use this output to send this data to your other equipment.

MIDI USB

In addition to the classic MIDI ports you can also use the USB port to connect your MIDI controllers. Your MOD device will recognize your MIDI device when it is plugged in and add it to the MIDI ports list. Because a single MIDI device can have multiple ports, they are not visible in the assembler by default. To make them visible you will have to enable them first by clicking on Gui-midi-ports.png.

MIDIPorts.png

If you select the Aggregate 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.

AggregatedMIDIPorts.png

If you select Separated mode each single port of each single controller that you have connected to your MOD device and have active on your MIDI ports list will appear with different MIDI input and output.

On the MIDI ports list 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.

SeparatedMIDIPorts.png

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.

True Bypass

The MOD devices have a true bypass circuit for each pair of input/output. This allows you to physically connect input 1 to output 1, and input 2 to output 2. The true bypass is enabled when the device is off and it is automatically disabled after the current pedalboard is loaded.

You can enable or disable the true bypass via the GUI using the two bypass buttons Gui-bypass.png in the status bar. As a second option, you can control the true bypass using a special plugin called Hardware Bypass.

Duo-bypass-plugin.png

If you can't find it in your Plugins Bar, install it from the plugins store (search for Hardware Bypass) (see Installing new plugins section) and add it to your pedalboard. Now you can assign the ON/OFF parameter to any physical actuator (see Assigning plugins parameters to actuators) and control the true bypass with it.

CPU Usage

In the status bar of the GUI there are CPU and RAM meters. It is useful to monitor these resources when you are creating your pedalboard. It’s recommended to keep the CPU usage lower than 80%. Note that each plugin consumes a different amount of CPU and RAM.

Gui-23.png

Settings

The "engine" button at the status bar will open the Settings page.

MOD DUO MOD DUO X
Duo Settings.png DuoX Settings.png

System Information

At the right hand side you will find information about your device configuration. Audio settings, system specification and software versions.

Basic Settings

Personal

  • Use custom Bluetooth device name: If you are connecting to your device through a Bluetooth network, you may choose here the name you want your device to have.

Backup & Restore

This feature allows you to make a backup of all your data to later recovery. You can backup Banks, Pedalboards, Device configuration (such as audio gains, Bluetooth config, etc) and all the plugins you have downloaded.

Creating a Backup

Insert a USB stick in the USB Host port (A) in the back of your unit. Make sure the USB stick has enough disk space, preferably with a fat32 file system.

By default, user configuration, pedalboards, and banks are included in the backup. Mark the correspondent checkboxes if you want to also backup the plugins you have installed and all the device settings, such as input and output gain.

Finally, click "Backup user data..."

Restoring a backup

Insert the USB stick in which you did the backup in the USB Host port (A) in the back of your unit.

Click "Restore user data..." and wait for the process to finish.

Note: You may have to reboot your device to be able 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 Settings

MOD DUO MOD DUO X
Duo AdvancedSettings.png DuoX AdvancedSettings.png

On the Advance settings you can:

  • define audio parameters such as buffer size and behaviour of the audio outputs;
  • additional services available on your MOD device;
  • user interface settings such as developer view (that shows you a bit more info about the state of the processors) or show beta plugins on the store (this plugins are still in development, so we can find out bugs or unexpected behaviours);
  • other tools like workarounds to help solve some bugs experienced with some devices.

Device Updates

Device-updates.png

On the Device updates menu you can find the latest firmware versions for control chain devices such as the MOD footswitch or the Arduino Shield.