midiRebind/README.md

2.4 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

  • Add Fix values
  • 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
  • Allow for a null interface out
  • URGENT : /funct with an existing trigger might not work, should be with an empty trigger anyway.
  • Add asynchroneous mode ?