2.9 KiB
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 disconnect & Crashes
-
TODO: Color and uncolor VP as it connects
-
TODO: Unified verbose printing & usage
-
TODO: Pagehandler: make a note handler
-
TODO: Color management, get colors associated to all statuses
-
TODO: General decorators @armtake
-
TODO: Do a cleaner page printl
-
TODO: Do all page tests