Machinewerks Editor: User Guide

Download and Install the Software

You can download the latest version of the Machinewerks Editor from http://www.machinewerks.co.uk/category/support.

Windows (8, 7, Vista, XP) – Launch the setup file and follow the onscreen instructions to complete the installation process. Once complete, you can launch the program from the Start menu and selecting “Machinewerks / Machinewerks Editor”.

Mac OSX – The Mac OSX version is provided in a single .zip file. Unpack the .zip file and copy the program to a safe place on your computer, this can be the Applications folder. Once complete, you can launch the program by selecting “Machinewerks Editor”.

Connecting To Your Device

Editor - ConnectIn order to connect and configure your device, you must select the USB MIDI In and Out ports from the lists provided. If you have only just connected your device, it may not have automatically shown up in the list. Use the Refresh button to recheck all of the MIDI ports available and update the lists. Once you’ve selected the correct MIDI In and Out ports, press Connect.

On some computers (Windows PCs in particular) you may need to close down other MIDI or DAW software before the Editor can connect. In many situations, only one piece of software can connect to a single MIDI port at any time.

The User Interaface

Editor - User InterfaceOnce connected, the editor load the current settings from your device and the display can be identified with several key areas:

1. Device Layout

This displays all of the available controls and allows you to select which one you would like to edit. Clicking on any of these will highlight this control and show the current settings in the “Controls” section.

2. Controls

This will display the current settings for each option related to the selected control. The options displayed will vary depending on the exact type of control you have selected. We’ll describe those options in detail later in this document.

3. Monitor

When you operate a control on your device, the monitor section will automatically update to show you the last data received. This gives you an easy way to check that any changes made are working as expected.

4. Machine

These buttons allow you to run certain actions on your device:

Load From CS X51 – Reloads all settings from the device.
Save To CS X51 – This commits all your changes to the memory on your device. If you do not click this, then any changes will be lost when the device is switched off!
Disconnect CS X51 – Closes the MIDI ports.
Reset To Default – This will reload the factory settings from the device and remove all changes.

Once you are happy with all your changes, always remember to click the “Save To CS X51” button to store the settings on your device. If you don’t, the settings will revert to the last saved version when the device is powered down!

5. Computer

These buttons allow you to run actions on your computer:

Open – Open a previously saved file with custom settings.
Save – Save your current settings as a file.
Save As – Save your current settings with a new file name.
About – Information about the Machinewerks Editor and your device firmware.

Options for Rotaries and Sliders

All analogue controls, such as rotaries and sliders have the following settings that can be adjusted:

MIDI Channel – The MIDI Channel to send data on (1-16).
Control ID – The MIDI Control Change ID (0-127).
Range Min – The lowest value to be sent.
Range Max – The highest value to be sent.
Range Invert – Reverses the range so that is goes Max to Min.

Options for the Buttons

The buttons can send MIDI messages based on the following settings:

MIDI Channel – The MIDI Channel to send data on (1-16)
Message Type – Selects the type of MIDI message to be sent (Note or CC)
Toggle – When set “Off”, the button will transmit the “On” command when pressed and the “Off” command when released. When set to “On” the button will alternate between the “On” and “Off” commands for each subsequent press.
Control ID – The MIDI Control Change ID (0-127).
On Value – The value sent to signal On.
Off Value – The value sent to signal Off.

Options for LED Feedback

The LEDs do not respond directly to the buttons on the controller but are in fact operated by MIDI signals from either your computer or another piece of MIDI equipment. Each LED can be set to listen and respond based on the following settings:

MIDI Channel – The MIDI Channel to send data on (1-16).
Message Type – Selects the type of MIDI message to be sent (Note or CC).
Ableton Mode – When On the LED can be made to flash in response to the default behaviour in Ableton Live’s Session Mode. While Off, the LEDs will simply switch on or off.
Control ID – The MIDI Control Change ID (0-127).

About Ableton Mode (for Ableton Live users)
Rather than just setting the LED to be on or off with a MIDI signal, Ableton Mode actually allows you to have several different LED states. The exact state is defined by the Note or CC value sent to the device:

Value = 0 – LED off
Value = 1 to 125 – LED slow flash
Value = 126 – LED fast flash
Value = 127 – LED on

This follows the default behaviour of Ableton Live so these values are preset.