Hey, thanks for downloading Toms Midi Mangler! :-)

Installation:

To install it, put the file "Toms Midi Mangler.lua" inside the following path in your User folder: 
~Documents\UVI\Falcon\User Presets\EventProcessors\Script Processor
If all is correct, the script should show up in the Falcon Browser in the Event Processor Tab.
The path may not exist at first, in that case you have to create it manually.
Otherwise you can put the script wherever you like and browse for it in the Falcon file browser or just drag and drop it onto the Falcon GUI from Explorer/Finder.

Enjoy!

Documentation:

Toms Midi Mangler is a tool you can use in the "Events" tab to randomize incoming midi. Incoming meaning also the midi generated by other event processors before it - try out an arpeggiator before this script and play with the controlls... :-)

Note Probability allows you to set how probable it is that the note will sound at all. Higher values will only drop a note every now and then, low values will make dense note clusters sparse...

Velocity Probability sets the probability for the velocity to be randomly changed in percent.

Velocity Depth is the maximum amount of the random change in Midi steps from 0-127.

Velocity Direction allows you to select if you want the change only to go up, only down or up and down.

Pan Probability defines how probable it is that Pan will change randomly.

Pan Depth is the amount of random change around the center.

Pitch Probability once more defines the probability of pitch changes in percent.

Pitch_Depth defines the maximum pitch change in halftone steps.

Pitch Direction defines if the pitch change should go up, down, or both.

Scale allows you to apply a scale to the end result of the mangling. Set it to Chromatic if you don't want that.

Key sets the key for the scale.

Play defines what notes go through: 
"Only Notes in Scale" will only play the notes that fit the scale after the mangling, all other will be discarded.
"Transpose to Scale" on the other hand will transpose the notes in a random direction to fit the scale (therefore all notes will sound)

Some tips:

This kind of combination of probability and separate maximum random values sounds the most natural to me and provides the most flexibility in many scenarios.

- If you just want the occasional off-note, put a low probabiliy on pitch. 

- If you want to every now and then lose a note, use a quite high note probability (but below 100).

- You want to only spread out the notes over the stereo field? Set note prob to 100, all other probs to 0 but pan prob to 100, then pan depth to taste.

- If you only want to use the conform to scale part, set note probability to 100, all other probabilities to zero and set your Scale, Key and the Play setting to taste.

Let me know if you encounter any problems!

The tool is free for private use, if you use it for a commercial library, I'd be happy if you sent me a copy :-)

Cheers,

Tom