Set up the readme ?

This commit is contained in:
Maximilien Rigaut 2019-05-04 19:15:37 +02:00
parent bc247794cf
commit fa6c987629
2 changed files with 27 additions and 19 deletions

View File

@ -1,4 +1,4 @@
# gmaPy
# midiRebind
Get/send midi commands to a GrandMA but can be configured to bind any custom SysEx 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
@ -9,23 +9,20 @@ To do so add a custom patch (or use a currently defined one, but chances are pat
# 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] #Patches layer 1 patch:2 would patch layer 2 and so on
1 = 1/cc/10 #Send (midi) control change (10) with value mapped to the fader (1) value (fader 1 => cc 10) on output 1
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
56/cond = lambda x: x==50 # Function choosing conditions on the value to send
[fire] #No layer specified
13 = 1/note/10
15 = 1/cc/44/127 #Send control change with value 127
17-27 = cc/45/127 # Send control change 45-55 with value 127
38 = 1/cc/65/124;2/cc/79/100;note/25 (Stack the action to link to)
* 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
# Adding another mapping interface
*
* Good luck

View File

@ -21,6 +21,17 @@
# Function choosing the value to send, depending on the intensity received
56/val = lambda x: min(x,50)
[set]
2 = 1/cc/2;2/note/19/127
#Map the faders 5-50 to the control change 11-45 (Straight patch) on output 1
5-50 = 1/cc/11
# Will map linearly 57 to 12; 58 to 14 etc on output 1
57-67 = 1/cc/12-32
#Map fader 56 to note 152 on output 2
56 = 7/note/152
# Function choosing the value to send, depending on the intensity received
56/val = lambda x: min(x,50)
#No layer specified
[fire]