Update labels to match Ableton

2 files changed, 159 insertions, 84 deletions

diff --git a/README.md b/README.md
index 9a325c6..b2c0a2f 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,82 @@
 # Komplete Kontrol S88 MK2 template for Ableton
 
-Template 1 is for general sounds in my default setup.
-Template 2 is all about triggering tonics.
+## General Layout
 
-## Ableton (main)
+### Main layout (patches and sound morphing)
+
+**Buttons**:
+
+The first 16 buttons (spanning 2 pages) are used to navigate song patches
+located in the `Master` column in Ableton.
+
+The rest remain unallocated for now.
+
+**Knobs**:
+
+My layout allows for 8 simultaneous patches to be played:
+
+1. Keys
+2. Pads
+3. Bass
+4. Lead
+5. Misc. 1
+6. Misc. 2
+7. Misc. 3
+8. Misc. 4
+
+This conveniently gives them 1 screen each (across all 4 pages) which is
+equivalent to 4 knobs:
+
+1. Aux Send 1 Gain (global reverb)
+2. Aux Send 2 Gain (global delay)
+3. Aux Send 3 Gain (global NY compressor)
+4. "Extra" Macro (inside their respective Instrument Rack)
+
+### Tonics and Effects Layout
+
+Tonics are triggers that can toggle a constant sound on or off.
+There is one for every semitone.
+
+1. Mute Aux 1 (global reverb)
+2. Mute Aux 2 (global delay)
+3. Mute Aux 3 (global NY compressor)
+4. Reset Tonics
+5. A
+6. A#/Bb
+7. B
+8. C
+9. C#/Db
+10. D
+11. D#/Eb
+12. E
+13. F
+14. F#/Gb
+15. G
+16. G#/Ab
+
+TODO[^1]
+
+
+## Midi Mappings
+
+Global mappings are as follows:
+
+**Pedal A**: fancy continuous sustain (Roland)
+- Channel 0
+- Midi CC 64
+
+**Pedal B**: Expression Pedal
+- Channel 0
+- Midi CC 11
+
+**TouchStrip**:
+- Channel 0
+- Midi CC 72
+
+Modwheel and PitchBend are locked by the vendor...
+
+
+### Ableton (main)
 
 | Page | Type    | Channel | Midi CCs |
 |------|---------|---------|----------|
@@ -16,7 +89,7 @@ Template 2 is all about triggering tonics.
 | 3    | Knobs   | 0       | 101-108  |
 | 3    | Buttons | 1       | 101-108  |
 
-## Tonics (& effects)
+### Tonics (& effects)
 
 | Page | Type    | Channel | Midi CCs |
 |------|---------|---------|----------|
@@ -28,3 +101,5 @@ Template 2 is all about triggering tonics.
 | 2    | Buttons | 3       | 81-88    |
 | 3    | Knobs   | 2       | 101-108  |
 | 3    | Buttons | 3       | 101-108  |
+
+[^1]: find a purpose for knobs on the tonics layer
diff --git a/bakup.json b/bakup.json
index 12eec21..55f6e77 100644
--- a/bakup.json
+++ b/bakup.json
@@ -18,7 +18,7 @@
                 "0": {
                     "knobs": {
                         "0": {
-                            "Name": "CC 14",
+                            "Name": "Keys Reverb",
                             "MIDIType": "3",
                             "MIDIId": "21",
                             "Channel": "0",
@@ -28,7 +28,7 @@
                             "Mode": "0"
                         },
                         "1": {
-                            "Name": "CC 15",
+                            "Name": "Keys Delay",
                             "MIDIType": "3",
                             "MIDIId": "22",
                             "Channel": "0",
@@ -38,7 +38,7 @@
                             "Mode": "0"
                         },
                         "2": {
-                            "Name": "CC 16",
+                            "Name": "Keys Comp.",
                             "MIDIType": "3",
                             "MIDIId": "23",
                             "Channel": "0",
@@ -48,7 +48,7 @@
                             "Mode": "0"
                         },
                         "3": {
-                            "Name": "CC 17",
+                            "Name": "Keys Xtra",
                             "MIDIType": "3",
                             "MIDIId": "24",
                             "Channel": "0",
@@ -58,7 +58,7 @@
                             "Mode": "0"
                         },
                         "4": {
-                            "Name": "CC 18",
+                            "Name": "Pads Reverb",
                             "MIDIType": "3",
                             "MIDIId": "25",
                             "Channel": "0",
@@ -68,7 +68,7 @@
                             "Mode": "0"
                         },
                         "5": {
-                            "Name": "CC 19",
+                            "Name": "Pads Delay",
                             "MIDIType": "3",
                             "MIDIId": "26",
                             "Channel": "0",
@@ -78,7 +78,7 @@
                             "Mode": "0"
                         },
                         "6": {
-                            "Name": "CC 20",
+                            "Name": "Pads Comp.",
                             "MIDIType": "3",
                             "MIDIId": "27",
                             "Channel": "0",
@@ -88,7 +88,7 @@
                             "Mode": "0"
                         },
                         "7": {
-                            "Name": "CC 21",
+                            "Name": "Pads Xtra",
                             "MIDIType": "3",
                             "MIDIId": "28",
                             "Channel": "0",
@@ -100,7 +100,7 @@
                     },
                     "buttons": {
                         "0": {
-                            "Name": "CC 112",
+                            "Name": "New Patch",
                             "MIDIType": "3",
                             "MIDIId": "21",
                             "Channel": "1",
@@ -110,7 +110,7 @@
                             "Behavior": "0"
                         },
                         "1": {
-                            "Name": "CC 113",
+                            "Name": "RESET PATCHES",
                             "MIDIType": "3",
                             "MIDIId": "22",
                             "Channel": "1",
@@ -120,7 +120,7 @@
                             "Behavior": "0"
                         },
                         "2": {
-                            "Name": "CC 114",
+                            "Name": "Song 1",
                             "MIDIType": "3",
                             "MIDIId": "23",
                             "Channel": "1",
@@ -130,7 +130,7 @@
                             "Behavior": "0"
                         },
                         "3": {
-                            "Name": "CC 115",
+                            "Name": "Song 2",
                             "MIDIType": "3",
                             "MIDIId": "24",
                             "Channel": "1",
@@ -140,7 +140,7 @@
                             "Behavior": "0"
                         },
                         "4": {
-                            "Name": "CC 116",
+                            "Name": "Song 3",
                             "MIDIType": "3",
                             "MIDIId": "25",
                             "Channel": "1",
@@ -150,7 +150,7 @@
                             "Behavior": "0"
                         },
                         "5": {
-                            "Name": "CC 117",
+                            "Name": "Song 4",
                             "MIDIType": "3",
                             "MIDIId": "26",
                             "Channel": "1",
@@ -160,7 +160,7 @@
                             "Behavior": "0"
                         },
                         "6": {
-                            "Name": "CC 118",
+                            "Name": "Song 5",
                             "MIDIType": "3",
                             "MIDIId": "27",
                             "Channel": "1",
@@ -170,7 +170,7 @@
                             "Behavior": "0"
                         },
                         "7": {
-                            "Name": "CC 119",
+                            "Name": "Song 6",
                             "MIDIType": "3",
                             "MIDIId": "28",
                             "Channel": "1",
@@ -184,7 +184,7 @@
                 "1": {
                     "knobs": {
                         "0": {
-                            "Name": "CC 22",
+                            "Name": "Bass Reverb",
                             "MIDIType": "3",
                             "MIDIId": "51",
                             "Channel": "0",
@@ -194,7 +194,7 @@
                             "Mode": "0"
                         },
                         "1": {
-                            "Name": "CC 23",
+                            "Name": "Bass Delay",
                             "MIDIType": "3",
                             "MIDIId": "52",
                             "Channel": "0",
@@ -204,7 +204,7 @@
                             "Mode": "0"
                         },
                         "2": {
-                            "Name": "CC 24",
+                            "Name": "Bass Comp.",
                             "MIDIType": "3",
                             "MIDIId": "53",
                             "Channel": "0",
@@ -214,7 +214,7 @@
                             "Mode": "0"
                         },
                         "3": {
-                            "Name": "CC 25",
+                            "Name": "Bass Xtra",
                             "MIDIType": "3",
                             "MIDIId": "54",
                             "Channel": "0",
@@ -224,7 +224,7 @@
                             "Mode": "0"
                         },
                         "4": {
-                            "Name": "CC 26",
+                            "Name": "Lead Reverb",
                             "MIDIType": "3",
                             "MIDIId": "55",
                             "Channel": "0",
@@ -234,7 +234,7 @@
                             "Mode": "0"
                         },
                         "5": {
-                            "Name": "CC 27",
+                            "Name": "Lead Delay",
                             "MIDIType": "3",
                             "MIDIId": "56",
                             "Channel": "0",
@@ -244,7 +244,7 @@
                             "Mode": "0"
                         },
                         "6": {
-                            "Name": "CC 28",
+                            "Name": "Lead Comp.",
                             "MIDIType": "3",
                             "MIDIId": "57",
                             "Channel": "0",
@@ -254,7 +254,7 @@
                             "Mode": "0"
                         },
                         "7": {
-                            "Name": "CC 29",
+                            "Name": "Lead Xtra",
                             "MIDIType": "3",
                             "MIDIId": "58",
                             "Channel": "0",
@@ -266,7 +266,7 @@
                     },
                     "buttons": {
                         "0": {
-                            "Name": "CC 112",
+                            "Name": "Song 7",
                             "MIDIType": "3",
                             "MIDIId": "51",
                             "Channel": "1",
@@ -276,7 +276,7 @@
                             "Behavior": "0"
                         },
                         "1": {
-                            "Name": "CC 113",
+                            "Name": "Song 8",
                             "MIDIType": "3",
                             "MIDIId": "52",
                             "Channel": "1",
@@ -286,7 +286,7 @@
                             "Behavior": "0"
                         },
                         "2": {
-                            "Name": "CC 114",
+                            "Name": "Song 9",
                             "MIDIType": "3",
                             "MIDIId": "53",
                             "Channel": "1",
@@ -296,7 +296,7 @@
                             "Behavior": "0"
                         },
                         "3": {
-                            "Name": "CC 115",
+                            "Name": "Song 10",
                             "MIDIType": "3",
                             "MIDIId": "54",
                             "Channel": "1",
@@ -306,7 +306,7 @@
                             "Behavior": "0"
                         },
                         "4": {
-                            "Name": "CC 116",
+                            "Name": "Song 11",
                             "MIDIType": "3",
                             "MIDIId": "55",
                             "Channel": "1",
@@ -316,7 +316,7 @@
                             "Behavior": "0"
                         },
                         "5": {
-                            "Name": "CC 117",
+                            "Name": "Song 12",
                             "MIDIType": "3",
                             "MIDIId": "56",
                             "Channel": "1",
@@ -326,7 +326,7 @@
                             "Behavior": "0"
                         },
                         "6": {
-                            "Name": "CC 118",
+                            "Name": "Song 13",
                             "MIDIType": "3",
                             "MIDIId": "57",
                             "Channel": "1",
@@ -336,7 +336,7 @@
                             "Behavior": "0"
                         },
                         "7": {
-                            "Name": "CC 119",
+                            "Name": "Song 14",
                             "MIDIType": "3",
                             "MIDIId": "58",
                             "Channel": "1",
@@ -350,7 +350,7 @@
                 "2": {
                     "knobs": {
                         "0": {
-                            "Name": "CC 14",
+                            "Name": "Misc1 Reverb",
                             "MIDIType": "3",
                             "MIDIId": "81",
                             "Channel": "0",
@@ -360,7 +360,7 @@
                             "Mode": "0"
                         },
                         "1": {
-                            "Name": "CC 15",
+                            "Name": "Misc1 Delay",
                             "MIDIType": "3",
                             "MIDIId": "82",
                             "Channel": "0",
@@ -370,7 +370,7 @@
                             "Mode": "0"
                         },
                         "2": {
-                            "Name": "CC 16",
+                            "Name": "Misc1 Comp.",
                             "MIDIType": "3",
                             "MIDIId": "83",
                             "Channel": "0",
@@ -380,7 +380,7 @@
                             "Mode": "0"
                         },
                         "3": {
-                            "Name": "CC 17",
+                            "Name": "Misc1 Xtra",
                             "MIDIType": "3",
                             "MIDIId": "84",
                             "Channel": "0",
@@ -390,7 +390,7 @@
                             "Mode": "0"
                         },
                         "4": {
-                            "Name": "CC 18",
+                            "Name": "Misc2 Reverb",
                             "MIDIType": "3",
                             "MIDIId": "85",
                             "Channel": "0",
@@ -400,7 +400,7 @@
                             "Mode": "0"
                         },
                         "5": {
-                            "Name": "CC 19",
+                            "Name": "Misc2 Delay",
                             "MIDIType": "3",
                             "MIDIId": "86",
                             "Channel": "0",
@@ -410,7 +410,7 @@
                             "Mode": "0"
                         },
                         "6": {
-                            "Name": "CC 20",
+                            "Name": "Misc2 Comp.",
                             "MIDIType": "3",
                             "MIDIId": "87",
                             "Channel": "0",
@@ -420,7 +420,7 @@
                             "Mode": "0"
                         },
                         "7": {
-                            "Name": "CC 21",
+                            "Name": "Misc2 Xtra",
                             "MIDIType": "3",
                             "MIDIId": "88",
                             "Channel": "0",
@@ -432,7 +432,7 @@
                     },
                     "buttons": {
                         "0": {
-                            "Name": "CC 112",
+                            "Name": "Song 15",
                             "MIDIType": "3",
                             "MIDIId": "81",
                             "Channel": "1",
@@ -442,7 +442,7 @@
                             "Behavior": "0"
                         },
                         "1": {
-                            "Name": "CC 113",
+                            "Name": "Song 16",
                             "MIDIType": "3",
                             "MIDIId": "82",
                             "Channel": "1",
@@ -452,7 +452,7 @@
                             "Behavior": "0"
                         },
                         "2": {
-                            "Name": "CC 114",
+                            "Name": "Song 17",
                             "MIDIType": "3",
                             "MIDIId": "83",
                             "Channel": "1",
@@ -462,7 +462,7 @@
                             "Behavior": "0"
                         },
                         "3": {
-                            "Name": "CC 115",
+                            "Name": "Song 18",
                             "MIDIType": "3",
                             "MIDIId": "84",
                             "Channel": "1",
@@ -472,7 +472,7 @@
                             "Behavior": "0"
                         },
                         "4": {
-                            "Name": "CC 116",
+                            "Name": "Song 19",
                             "MIDIType": "3",
                             "MIDIId": "85",
                             "Channel": "1",
@@ -482,7 +482,7 @@
                             "Behavior": "0"
                         },
                         "5": {
-                            "Name": "CC 117",
+                            "Name": "Song 20",
                             "MIDIType": "3",
                             "MIDIId": "86",
                             "Channel": "1",
@@ -492,7 +492,7 @@
                             "Behavior": "0"
                         },
                         "6": {
-                            "Name": "CC 118",
+                            "Name": "Song 21",
                             "MIDIType": "3",
                             "MIDIId": "87",
                             "Channel": "1",
@@ -502,7 +502,7 @@
                             "Behavior": "0"
                         },
                         "7": {
-                            "Name": "CC 119",
+                            "Name": "Song 22",
                             "MIDIType": "3",
                             "MIDIId": "88",
                             "Channel": "1",
@@ -516,7 +516,7 @@
                 "3": {
                     "knobs": {
                         "0": {
-                            "Name": "CC 14",
+                            "Name": "Misc3 Reverb",
                             "MIDIType": "3",
                             "MIDIId": "101",
                             "Channel": "0",
@@ -526,7 +526,7 @@
                             "Mode": "0"
                         },
                         "1": {
-                            "Name": "CC 15",
+                            "Name": "Misc3 Delay",
                             "MIDIType": "3",
                             "MIDIId": "102",
                             "Channel": "0",
@@ -536,7 +536,7 @@
                             "Mode": "0"
                         },
                         "2": {
-                            "Name": "CC 16",
+                            "Name": "Misc3 Comp.",
                             "MIDIType": "3",
                             "MIDIId": "103",
                             "Channel": "0",
@@ -546,7 +546,7 @@
                             "Mode": "0"
                         },
                         "3": {
-                            "Name": "CC 17",
+                            "Name": "Misc3 Xtra",
                             "MIDIType": "3",
                             "MIDIId": "104",
                             "Channel": "0",
@@ -556,7 +556,7 @@
                             "Mode": "0"
                         },
                         "4": {
-                            "Name": "CC 18",
+                            "Name": "Misc4 Reverb",
                             "MIDIType": "3",
                             "MIDIId": "105",
                             "Channel": "0",
@@ -566,7 +566,7 @@
                             "Mode": "0"
                         },
                         "5": {
-                            "Name": "CC 19",
+                            "Name": "Misc4 Delay",
                             "MIDIType": "3",
                             "MIDIId": "106",
                             "Channel": "0",
@@ -576,7 +576,7 @@
                             "Mode": "0"
                         },
                         "6": {
-                            "Name": "CC 20",
+                            "Name": "Misc4 Comp.",
                             "MIDIType": "3",
                             "MIDIId": "107",
                             "Channel": "0",
@@ -586,7 +586,7 @@
                             "Mode": "0"
                         },
                         "7": {
-                            "Name": "CC 21",
+                            "Name": "Misc4 Xtra",
                             "MIDIType": "3",
                             "MIDIId": "108",
                             "Channel": "0",
@@ -598,7 +598,7 @@
                     },
                     "buttons": {
                         "0": {
-                            "Name": "CC 112",
+                            "Name": "Song 23",
                             "MIDIType": "3",
                             "MIDIId": "101",
                             "Channel": "1",
@@ -608,7 +608,7 @@
                             "Behavior": "0"
                         },
                         "1": {
-                            "Name": "CC 113",
+                            "Name": "Song 24",
                             "MIDIType": "3",
                             "MIDIId": "102",
                             "Channel": "1",
@@ -618,7 +618,7 @@
                             "Behavior": "0"
                         },
                         "2": {
-                            "Name": "CC 114",
+                            "Name": "Song 25",
                             "MIDIType": "3",
                             "MIDIId": "103",
                             "Channel": "1",
@@ -628,7 +628,7 @@
                             "Behavior": "0"
                         },
                         "3": {
-                            "Name": "CC 115",
+                            "Name": "Song 26",
                             "MIDIType": "3",
                             "MIDIId": "104",
                             "Channel": "1",
@@ -638,7 +638,7 @@
                             "Behavior": "0"
                         },
                         "4": {
-                            "Name": "CC 116",
+                            "Name": "Song 27",
                             "MIDIType": "3",
                             "MIDIId": "105",
                             "Channel": "1",
@@ -648,7 +648,7 @@
                             "Behavior": "0"
                         },
                         "5": {
-                            "Name": "CC 117",
+                            "Name": "Song 28",
                             "MIDIType": "3",
                             "MIDIId": "106",
                             "Channel": "1",
@@ -658,7 +658,7 @@
                             "Behavior": "0"
                         },
                         "6": {
-                            "Name": "CC 118",
+                            "Name": "Song 29",
                             "MIDIType": "3",
                             "MIDIId": "107",
                             "Channel": "1",
@@ -668,7 +668,7 @@
                             "Behavior": "0"
                         },
                         "7": {
-                            "Name": "CC 119",
+                            "Name": "Song 30",
                             "MIDIType": "3",
                             "MIDIId": "108",
                             "Channel": "1",
@@ -778,7 +778,7 @@
                     },
                     "buttons": {
                         "0": {
-                            "Name": "CC 112",
+                            "Name": "Reverb Mute",
                             "MIDIType": "3",
                             "MIDIId": "21",
                             "Channel": "3",
@@ -788,7 +788,7 @@
                             "Behavior": "0"
                         },
                         "1": {
-                            "Name": "CC 113",
+                            "Name": "Delay Mute",
                             "MIDIType": "3",
                             "MIDIId": "22",
                             "Channel": "3",
@@ -798,7 +798,7 @@
                             "Behavior": "0"
                         },
                         "2": {
-                            "Name": "CC 114",
+                            "Name": "Comp. Mute",
                             "MIDIType": "3",
                             "MIDIId": "23",
                             "Channel": "3",
@@ -808,7 +808,7 @@
                             "Behavior": "0"
                         },
                         "3": {
-                            "Name": "CC 115",
+                            "Name": "RESET TONICS",
                             "MIDIType": "3",
                             "MIDIId": "24",
                             "Channel": "3",
@@ -818,7 +818,7 @@
                             "Behavior": "0"
                         },
                         "4": {
-                            "Name": "CC 116",
+                            "Name": "A",
                             "MIDIType": "3",
                             "MIDIId": "25",
                             "Channel": "3",
@@ -828,7 +828,7 @@
                             "Behavior": "0"
                         },
                         "5": {
-                            "Name": "CC 117",
+                            "Name": "A#/Bb",
                             "MIDIType": "3",
                             "MIDIId": "26",
                             "Channel": "3",
@@ -838,7 +838,7 @@
                             "Behavior": "0"
                         },
                         "6": {
-                            "Name": "CC 118",
+                            "Name": "B",
                             "MIDIType": "3",
                             "MIDIId": "27",
                             "Channel": "3",
@@ -848,7 +848,7 @@
                             "Behavior": "0"
                         },
                         "7": {
-                            "Name": "CC 119",
+                            "Name": "C",
                             "MIDIType": "3",
                             "MIDIId": "28",
                             "Channel": "3",
@@ -944,7 +944,7 @@
                     },
                     "buttons": {
                         "0": {
-                            "Name": "CC 112",
+                            "Name": "C#/Db",
                             "MIDIType": "3",
                             "MIDIId": "51",
                             "Channel": "3",
@@ -954,7 +954,7 @@
                             "Behavior": "0"
                         },
                         "1": {
-                            "Name": "CC 113",
+                            "Name": "D",
                             "MIDIType": "3",
                             "MIDIId": "52",
                             "Channel": "3",
@@ -964,7 +964,7 @@
                             "Behavior": "0"
                         },
                         "2": {
-                            "Name": "CC 114",
+                            "Name": "D#/Eb",
                             "MIDIType": "3",
                             "MIDIId": "53",
                             "Channel": "3",
@@ -974,7 +974,7 @@
                             "Behavior": "0"
                         },
                         "3": {
-                            "Name": "CC 115",
+                            "Name": "E",
                             "MIDIType": "3",
                             "MIDIId": "54",
                             "Channel": "3",
@@ -984,7 +984,7 @@
                             "Behavior": "0"
                         },
                         "4": {
-                            "Name": "CC 116",
+                            "Name": "F",
                             "MIDIType": "3",
                             "MIDIId": "55",
                             "Channel": "3",
@@ -994,7 +994,7 @@
                             "Behavior": "0"
                         },
                         "5": {
-                            "Name": "CC 117",
+                            "Name": "F#/Gb",
                             "MIDIType": "3",
                             "MIDIId": "56",
                             "Channel": "3",
@@ -1004,7 +1004,7 @@
                             "Behavior": "0"
                         },
                         "6": {
-                            "Name": "CC 118",
+                            "Name": "G",
                             "MIDIType": "3",
                             "MIDIId": "57",
                             "Channel": "3",
@@ -1014,7 +1014,7 @@
                             "Behavior": "0"
                         },
                         "7": {
-                            "Name": "CC 119",
+                            "Name": "G#/Ab",
                             "MIDIType": "3",
                             "MIDIId": "58",
                             "Channel": "3",