middy
extra add-on to add-on extra functionality for midi controllers.
note: this is a library “add-on.” to use this library you will need to incorporate it into an existing script by adding two lines of code (see Documentation).
this script add-on is something i’ve found very useful to add some extra functionality to midi devices while within other scripts on norns. i made it specifically for using with oooooo and otis but it should work with any script by adding two lines into the init() function of the script (see Documentation).
middy is similar to MAP on norns. the MAP already does 95% of what middy does. so what does midi do? middy does two things:
-
it will map a single midi input to many outputs in a multitude of ways (see “mapping” below). this is very useful if you want to map a single midi controller key to toggle multiple effects, or use a single slider to modulate several different volumes for instance. unlike
MAP, you can also map to arrays of discrete values. another note: if you only need basic midi mapping, first look toPARAMETERS -> MAPwhich is already on your norns. - it can record midi with quanitzation and play it back as a mini midi loop (see “recording midi” below). this is useful for getting ideas from a midi keyboard recorded into norns quickly (in case you don’t have a daw) and also i find it useful for composition and using midi in a non-midi script.
maybe in the future middy will do more things. but right now its very useful for me, and - though i don’t think most people will find it useful - possibly one other person might find it useful too.
Requirements
- norns + norns script to ammend
- midi device
Documentation
to get started, add the following to any norns script, usually in the init() function:
local middy=include("middy/lib/middy")
middy:init()
(see oooooo code for another example). this will add a new menu called MIDDY which you can access the functionality. there are two main functions described below.
mapping
middy lets you map any number of midi inputs to any number of internal parameter in a norns script. the real power here is that, unlike PSET, here you can map a single midi input to multiple parameters.
it uses a config file written in JSON syntax. when loading the config file from the MIDDY menu you will have access to the the midi mapping from your device. an example of the syntax is below.
all config files need to be written and saved to the folder at
~/dust/data/middy/maps/
or alternatively you can start midi with the filename
local middy=include("middy/lib/middy")
local m1 = middy:init()
m1:init_midi()
m1:init_map('/home/we/dust/data/middy/maps/nanokontrol-oooooo.json')
mapping: basic button
to set those commands to do something, you need to create a middy config file file. a simple config file might be like this, which simply toggles the compressor on/off:
[
{
"comment": "toggle compressor",
"button": true,
"cc": 58,
"commands": [
{ "datas": [1, 2], "msg": "/param/compressor"}
]
}
]
in that example, anytime a MIDI cc of 58 comes in, it will turn the compressor on/off, by toggling between the data values. the button directive indicates that these commands are only activated when the midi value comes in as 127 (and it ignores values of 0).
mapping: basic slider
if you leave off the button directive, the commands will act as a slider. by using the datas directive it will map the 0-127 input to one of the discrete data in the array - either 0, 0.5, or 1:
[
{
"comment": "discrete compressor mix",
"button":true,
"cc": 58,
"commands": [
{ "datas": [0,0.5,1], "msg": "/param/comp_mix"}
]
}
]
if you include the bounds instead of datas, then it will map the 0-127 input continously. in this case it needs to be triggered anytime cc comes in, so leave button as false, or don’t include it at all:
[
{
"comment": "continuous compressor mix slider",
"cc": 0,
"commands": [
{ "bounds": [0.2,0.9], "msg": "/param/comp_mix"}
]
}
]
in the case above, any midi input will be mapped to the compressor mix at a level between 0.2 and 0.9.
mapping: chaining midi commands to single input
the nice thing about middy is that you can easily chain MIDI commands. for example, this will extend the previous example to toggle the compressor on and turn the compressor mix up to 1.
[
{
"comment": "toggle compressor",
"button": true,
"cc": 58,
"commands": [
{ "datas": [1, 2], "msg": "/param/compressor"},
{ "data": 1, "msg": "/param/comp_mix"}
]
}
]
the "data" directive tells middy to send a single data no matter, whether the compressor is toggled on or off as before.
repetitive things
for repetitive things you can utilize the X notation:
[{
"comment": "volume X",
"cc": 0,
"add": 1,
"count": 6,
"commands": [
{ "bounds": [0,1], "msg": "/param/Xvol" }
]
}]
in that example the count is set to 6 so it will repeat 6 times and replace the X by the current count (1 through 6 here). on the first time it will start at cc of 0, and each time it will then add the add (1) to the cc. so this code will affect ccs 0-5 which target parameters 1-6.
recording midi
middy is also equipped with a single basic midi looper. it basically lets you play a midi loop directly from any script in norns. to use it follow these steps:
- go to the
MIDDYparams and first selectmidi device, then hitinitialize midi. - select a
recording number(each recording is designated by a number). - set the
measuresfor how long you want the loop to be - start recording by pressing
toggle recording. play something on your midi device. - to playback, simply press
toggle playback. you can keep it looping by turningloop playback.
Download
v0.1.0 - https://github.com/schollz/middy/archive/v0.1.0.zip