NuEVI Config — User Guide

This tool lets you read, edit, and write the configuration of your NuEVI or NuRAD instrument directly from your browser. No software installation is required.

Browser compatibility

This tool uses the Web MIDI API to communicate with your instrument. The following browsers are supported:

Chrome — recommended
Firefox (version 99 and later)
Microsoft Edge
Opera

Safari is not supported. Apple has not implemented the Web MIDI API in Safari. Use one of the browsers listed above instead.

The page must be served over HTTPS, or from localhost (e.g. a local web server on your computer). Opening the file directly from disk will not work for MIDI features.

Putting the instrument in config mode

Before the instrument can communicate with this tool, it must be in config mode. In this mode, the instrument acts as a USB MIDI device and will not play notes.

Connect the instrument to your computer with a USB cable.

Hold down both the Up and Down buttons on the instrument.

While holding the buttons, turn the power switch on (or cycle power if already on).

Tip: Because the instrument powers up when USB is connected, it can be tricky to hold the buttons while plugging in. An easier approach: turn the instrument on first, then connect the USB cable, then hold the up and down buttons and switch the power off. The instrument will reboot as it switches to USB power and will enter config mode.

To exit config mode, simply restart the instrument normally (without holding the buttons).

Connecting in the browser

Open the config tool in your browser. The MIDI device bar appears below the name and save/load buttons.

The first time you use the tool, your browser will ask for permission to access MIDI devices. Click Allow.

If your instrument is in config mode, it will appear in the device dropdown — and will be selected automatically if it is the only NuEVI/NuRAD connected.

Once a device is selected, the tool queries it automatically. You should see a green Connected to … message showing the firmware version and config version.

If no device appears, click the ↻ button to refresh the device list. Make sure the instrument is in config mode and the USB cable is securely connected.

Downloading config from the instrument

To read the current configuration stored on the instrument:

Select your instrument in the device dropdown (it should already be selected).

Click Get from instrument. The status will show Waiting for response…

After a moment, all config values will be populated from the instrument and the status will show Config loaded from instrument.

You can now view and edit all settings.

Editing settings

Settings are grouped into sections such as Breath, Pitch Bend, MIDI, Keys, and so on. Each section can be expanded or collapsed by clicking its heading.

Sliders — drag left or right, or click to set a value. The number can also be typed directly.
Dropdowns — click to choose from a list of named options.
Checkboxes — click to toggle on or off.

Settings that do not apply to your instrument's firmware version are hidden automatically.

Sending config to the instrument

Make sure your instrument is connected and shown as Connected in the MIDI bar.

Click Send to instrument.

The status will briefly show Sent. The instrument receives and stores the new configuration immediately.

Version mismatch: If the config version in the editor does not match the version reported by the instrument, you will be warned before sending. Sending a mismatched config may cause unexpected behaviour. It is safest to always start from a config downloaded from the instrument itself.

Saving and loading config files

You can save your configuration to a file as a backup, or to share with others. Three formats are available:

Save JSON — saves a human-readable file. Can be loaded back into this tool. Best for archiving and sharing.
Save MIDI — saves a standard MIDI file (.mid) containing the config as a sysex message. Can be sent to the instrument with any MIDI utility that supports sysex.
Save SysEx — saves a raw sysex file (.syx). Compatible with most MIDI sysex utilities.

To load a previously saved file, click Load and select a .json, .mid, or .syx file.

The Config name field (top of the page) and the optional Comment field are saved with JSON files. Use them to keep track of different setups.

Typical workflow

Put the instrument in config mode and connect via USB.
Open the config tool in Chrome (or Firefox/Edge/Opera).
Click Get from instrument to load the current settings.
Optionally save a backup with Save JSON.
Adjust any settings you want to change.
Click Send to instrument.
Restart the instrument to return to normal playing mode.