midiRebind/README.md

31 lines
2.0 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
[![Tests](https://github.com/Malphaet/midiRebind/actions/workflows/tests.yml/badge.svg)](https://github.com/Malphaet/midiRebind/actions/workflows/tests.yml)
# 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 dependant (on linux you must 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 set up 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 : incoming note = interface/commandtype/note/intensity
* Examples:
* 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)