47 lines
2.7 KiB
Markdown
47 lines
2.7 KiB
Markdown
# midiRebind
|
|
Was originally designed to get/send midi commands to a GrandMA but can be configured to bind any custom SysEx or midi (or whatever actually) message
|
|
|
|
To do so add a custom patch (or use a currently defined one, but chances are patches made for one SysEx won't work on another) and add a parser in the mapping directory
|
|
|
|
# Depends
|
|
* Mostly mido (pip install mido) for the midi binding and rtmidi (sudo apt install python-rtmidi)
|
|
* test.py depends on the submodule minitest witch also depends on blessings (pip install blessings). test.py is not a core part of the program
|
|
* This program is python3 compliant (as long as you install the python3 dependencies instead (pip3 install mido and install python3-rtmidi))
|
|
|
|
# Config Syntax
|
|
|
|
* [interface] : All important information concerning the midi interface
|
|
* input : Choose which Midi interface to listen to
|
|
* output1 : Choose which Midi interface to output to; an arbitrary number can be specified that way
|
|
* inputchanel : Which midi channel to listen to
|
|
* outputchannel1 : Which midi channel to output to
|
|
* mapping : The python file in mapping to setup all the mapping between input and output
|
|
* [set/1] patch the first layer of set commands, what is defined as the first layer is in the mapping file
|
|
* Basic usage : incomming note = interface/commandtype/note/intensity
|
|
* Exemples:
|
|
* 5-50 = 1/cc/11 #Map the faders 5-50 to the control change 11-45 (Straight patch) on output 1
|
|
* 57-67 = 1/cc/12-32 # Will map linearly 57 to 12; 58 to 14 etc on output 1
|
|
* 56 = 2/note/152 #Map fader 56 to note 152 on output 2
|
|
* Advanced usage: Can add logic to the notes. NB: they must be defined first
|
|
* 56/cond = lambda x: x==50 # Function choosing conditions on the value to send
|
|
* 57/toggle = 0/127: Toggle the val between 127 and 0 every time the note is received
|
|
* 68/func = functionMappedInTheMappingInterface(note,intensity,parameters)
|
|
|
|
# Adding another mapping interface
|
|
* TODO: Explain it better than just "look at the ones I made"
|
|
|
|
# Improvements
|
|
* Better note / cc / pc notation
|
|
* Add Fade (in ms) from one value to another
|
|
* Have a way to know last value for the note/cc (the last one sent/received)
|
|
* Make toggles a function modifying a variable/state and sending result
|
|
* Allow for a multi-in interfaces
|
|
* TODO: More testing for null interface out
|
|
* URGENT : /funct with an existing trigger might not work, should be with an empty trigger anyway.
|
|
* Add asynchroneous mode ?
|
|
* URGENT : Crash when assigning to an existing trigger
|
|
* TODO: Make a @armtake decorator
|
|
* TODO: Async and Disconnection protect for VPs
|
|
* TODO: Disconnect: 'NoneType' object has no attribute 'groups' : Should handle disconnct & Crashes
|
|
* TODO: Color and uncolor VP as it connects
|