# Read Me for BSmart Reaper MIDI Controller effects, developed by Bryan Smart.

These are JS plug-ins for Reaper that provide quick access to commonly needed MIDI parameters. Most importantly, they provide controls for changing bank/patch on supported synths. The simple user interface should work with any screen reader.

All controls in the plug-ins support automation. This means that you can access their parameters from the OSARA Parameters dialog, as well as from inside the regular Reaper effects dialog. In some cases, you might wish to use the regular Reaper effects dialog, as you'll encounter combo boxes with named values and other nice touches that aren't available anywhere else.

This is public domain software. Please feel free to copy these plug-ins and/or re-use parts of the code in your own projects.
If you find them useful, I'd love to hear from you. You can reach me via e-mail at BryanSmart@BryanSmart.com.
 
## Advantages over ReaControlMIDI
1. ReaControl can send bank/patch change messages. However, if you enable that parameter in ReaControl, the current state of the bank/patch parameters will be sent on project load. If you've customized the patch of a softsynth by editing its parameters, sending it a bank/patch command on project load has the potential of recalling the preset version, throwing out your customizations. Note that some softsynths won't reload a patch if they're asked to load one that is already loaded, but some will, so it's best to only send bank/patch when the parameter is changed by the user.
2. ReaControl will let you select a few MIDI CCs to use as automatable parameters. My plug-ins automatically provide most common CCs, and the values for the parameters are named in many cases. I also provide a customizable CC parameter that you can configure per instance.


## How to use:

1. Download the plug-in you want to use. Note that these files don't have any extension like .exe or anything, REAPER will know how to use them so long as you put them in the right place.
2. Go to your REAPER resource path, paste the plug-in in the Effects folder.
3. Now either restart REAPER or re-scan for new plug-ins.
4. Insert one of these plug-ins on your effects chain prior to the synth that it should operate. The order is important. The synth you're trying to control has to be afterward in the FX chain, or it won't receive messages from the plug-in.

### Details on General MIDI Controller.

This plug-in exposes some of the most common GM controllers. Besides changing bank/patch, you can change simple mix values (volume, pan, reverb, and chorus), can adjust filter cut-off and resonance, modify the voices basic envelope times (attack, decay, and sustain), as well as control mono/poly mode, portamento/glide parameters, and more.

### Hypersonic MIDI Controller

This version of the MIDI Controller plug-in has a customized set of controls to support Steinberg's Hypersonic II.

1. Hypersonic uses a fixed number of banks. The MSB/LSB controls have been modified to show only what's available, and label the banks by name.

2. Hypersonic supports non-standard MIDI controllers, including 6 CC messages that work voice-specific editing (Hyperknobs), extra CCs for changing voice tone characteristics, for controlling the arpeggiator, etc. These controls have been added.

3. Unsupported General MIDI CCs have been removed.

### Details on BSmart Oscillator:
This is an itteration on REAPER's stock js tone generator, with added Features.