0.5 Add auto split mode

Author: euwbah

.github/workflows/build.yml

@@ -39,15 +39,15 @@ jobs:
           - os: macos-latest
             TARGET: macos
             CMD_BUILD: >
-              pyinstaller -F microtonal-seaboard.spec &&
+              pyinstaller microtonal-seaboard.spec &&
               cd dist/ &&
               zip -r9 microtonal-seaboard-macos.zip ../mappings microtonal-seaboard
             OUT_FILE_NAME: microtonal-seaboard-macos.zip
             ASSET_MIME: application/zip
           - os: windows-latest
             TARGET: windows
             CMD_BUILD: >
-              pyinstaller -F microtonal-seaboard.spec &&
+              pyinstaller microtonal-seaboard.spec &&
               cd dist/ &&
               tar -a -c -f microtonal-seaboard-windows.zip ../mappings microtonal-seaboard.exe
             OUT_FILE_NAME: microtonal-seaboard-windows.zip

README.md

@@ -147,8 +147,8 @@ notes across different MIDI channels to achieve a larger range using
 multiple VST instances or using a VST's internal multi-channel mapping
 ability.
 
-Pianoteq 6+ natively supports multi-channel midi inputs to obtain a larger range.
-[Follow these steps instead for Pianoteq](#microtuning-on-pianoteq).
+Pianoteq 6+ natively supports multi-channel midi inputs to obtain a larger range for big EDOs.
+[**Follow these simpler instructions instead for pianoteq.**](#microtuning-on-pianoteq).
 
 Otherwise, to get more range out of microtunable synths,
 you can open multiple instances of them and set them at different
@@ -194,48 +194,25 @@ Pianoteq offers [multi-channel keyboard mappings](https://forum.modartt.com/view
 which bypasses the need for opening multiple instances of pianoteq in order to get the
 full range.
 
-There is little official documentation on this feature, so here's how it works:
-- Under Pianoteq's microtuning screen, there's a button on the top right
-  to change the keyboard mapping. Click on it and you will see an option
-  titled 'Extended layout for up to 16*128 notes'
+To make use of this in the seaboard mapper:
+
+1. enter `autosplit` in the console to turn auto split mode on
+
+2. Under Pianoteq's microtuning screen, there's a button on the top right
+  to change the **keyboard mapping**. Click on it and you will see an option
+  titled '**Extended layout for up to 16*128 notes**'. Open the drop down and select **MIDI channel 5**
 
 ![img.png](imgs/extended-layout-pianoteq.png)
 
-- If you toggle the 'Multi-channel MIDI layout' option and activate it,
-  it will cause the notes received on each subsequent MIDI channel 
+- This will cause the notes received on each subsequent MIDI channel 
   to sound one octave higher than the previous MIDI channel.
-- The Main MIDI Channel setting determines the MIDI channel that will not
-  be transposed at all.
-- E.g. if MIDI channel 4 is selected as the main channel,
-  channel 3 will be transposed one octave below, channel 5 will be transposed
-  an octave up, etc...
-- Note that if the scala tuning file imported denotes a non-octave tuning
+- The checked midi channel (5) denotes the MIDI channel that will not have any octave/equave transposition at all.
+- E.g. if MIDI channel 5 is selected as the main channel,
+  Notes played on channel 4 will sound one octave below what's played, notes played on channel 6 will sound one octave up, etc...
+- Note that if the scala tuning file imported on Pianoteq denotes a non-octave tuning
   (e.g. Bohlen-pierce/Wendy Carlos's alpha/beta), then Pianoteq will
   transpose according to the tuning system's [period](https://en.xen.wiki/w/Periods_and_generators).
 
-
-Here's how to obtain the full 8 octave range on the piano in
-the default 31 edo mapping using Pianoteq and the seaboard mapper:
-
-1. Turn on Multi=channel MIDI layout mode 
-   (Microtuning > Keyboard Mapping > Extended layout for up to... >
-   Multi-channel MIDI layout)
-2. Set Main MIDI channel to channel 4. This opens up 3 more octaves below.
-3. Enter the `split` command in the seaboard mapping program
-4. Input the following (see above section for
-   explanation):
-    1. `C2 C3 C4 C5 C6 C7`
-    2. `93`
-    3. `62`
-    4. `31`
-    5. `0`
-    6. `-31`
-    7. `-62`
-    8. `-93`
-5. Enter the [`save` command](#save) so you don't have to do this every time.
-
-Now you can play all the way down to A0 and up to C8 and beyond!
-
 ## Other Settings/Commands
 
 ### Save

__pycache__/configs.cpython-39.pyc

@@ -1,10 +1,10 @@
 py -m pip install --upgrade pip
 py -m pip install --user virtualenv
-py -m venv venv
-.\venv\Scripts\activate
+py -m venv .venv
+.\.venv\Scripts\activate
 pip install --upgrade setuptools
 pip install -r requirements.txt
-pyinstaller -F microtonal-seaboard.spec &&^
+pyinstaller microtonal-seaboard.spec &&^
     cd dist/ &&^
     tar -a -c -f microtonal-seaboard-windows.zip ../mappings microtonal-seaboard.exe
 deactivate

__pycache__/convert.cpython-39.pyc

@@ -1,7 +1,7 @@
 python3 -m pip install --user --upgrade pip
 python3 -m pip install --user virtualenv
-python3 -m venv venv
-source venv/bin/activate
+python3 -m venv .venv
+source .venv/bin/activate
 python3 -m pip install -r requirements.txt
 pyinstaller -F ./microtonal-seaboard.spec &&\
     cd dist/ &&\

__pycache__/handler.cpython-39.pyc

@@ -1,5 +1,6 @@
 import os
 from enum import Enum
+from typing import Optional
 
 import dill
 
@@ -16,10 +17,20 @@ class SlideMode(Enum):
 
 
 class CONFIGS:
+    '''
+    Static Singleton class for storing global configuration data.
+    '''
     MPE_MODE = True
     SLIDE_MODE = SlideMode.RELATIVE
     SLIDE_FIXED_N = 64
     SPLITS = SplitData()
+    AUTO_SPLIT: Optional[SplitData] = None
+    '''
+    If true, MIDI mode will output each octave in its own channel, and SPLITS will be ignored.
+    The interval between C4 and C5 in the mapping will be used to determine octave offset in edosteps.
+    This is useful for Pianoteq which allows multi-channel mode where channel N+1 is pitched
+    one octave higher than channel N. (useful for very large edos)
+    '''
     PITCH_BEND_RANGE = 24
     MAPPING: Mapping = None
     TOGGLE_SUSTAIN = False
@@ -42,6 +53,7 @@ def read_configs() -> bool:
             CONFIGS.SLIDE_MODE = c['SLIDE_MODE']
             CONFIGS.SLIDE_FIXED_N = c['SLIDE_FIXED_N']
             CONFIGS.SPLITS = c['SPLITS']
+            CONFIGS.AUTO_SPLIT = c['AUTO_SPLIT']
             CONFIGS.PITCH_BEND_RANGE = c['PITCH_BEND_RANGE']
             CONFIGS.MAPPING = c['MAPPING']
             CONFIGS.TOGGLE_SUSTAIN = c['TOGGLE_SUSTAIN']
@@ -62,6 +74,7 @@ def save_configs():
             'SLIDE_MODE': CONFIGS.SLIDE_MODE,
             'SLIDE_FIXED_N': CONFIGS.SLIDE_FIXED_N,
             'SPLITS': CONFIGS.SPLITS,
+            'AUTO_SPLIT': CONFIGS.AUTO_SPLIT,
             'PITCH_BEND_RANGE': CONFIGS.PITCH_BEND_RANGE,
             'MAPPING': CONFIGS.MAPPING,
             'TOGGLE_SUSTAIN': CONFIGS.TOGGLE_SUSTAIN

__pycache__/keytracker.cpython-39.pyc

@@ -1,3 +1,6 @@
+from typing import Tuple
+
+
 __NOTENAMES = {
     0: 'C',
     1: 'C#',
@@ -84,7 +87,7 @@ def raw_pitch_msg_to_pitch_bend(ls7, ms7):
     return 2**7 * ms7 + ls7
 
 
-def pitch_bend_to_raw_pitch_msg(pb) -> (int, int):
+def pitch_bend_to_raw_pitch_msg(pb) -> Tuple[int, int]:
     """
     :param pb: pitch bend amount (will be bounded to 0-16383 if it exceeds range)
     :return: (lsb, msb)

__pycache__/main.cpython-39.pyc

@@ -47,7 +47,11 @@ def tune_and_send_note(note, vel, cc74):
                 # otherwise strobe 2 complete disregards it
                 self.send_pitch_bend(channel, pitchbend)
             else:
-                send_ch, send_note_offset = CONFIGS.SPLITS.get_split_range(note)
+                if CONFIGS.AUTO_SPLIT is not None:
+                    send_ch, send_note_offset = CONFIGS.AUTO_SPLIT.get_split_range(note)
+                else:
+                    send_ch, send_note_offset = CONFIGS.SPLITS.get_split_range(note)
+                
                 send_note = edosteps_from_a4 + MIDI_NOTE_A4 + send_note_offset
 
                 if 0 > send_note > 127:

__pycache__/mapping.cpython-39.pyc

@@ -138,7 +138,7 @@ def intable(s):
 
 
 if __name__ == '__main__':
-    print('microtonal seaboard retuner v0.4.5d')
+    print('microtonal seaboard retuner v0.5')
 
     has_read_configs = configs.read_configs()
 
@@ -179,10 +179,11 @@ def intable(s):
                                     abs: emulate absolute slide mode
                                     bip: (default) emulate bipolar mode
     split                       set split points (for midi mode)
+    autosplit                   toggle auto-split for Pianoteq (for midi mode)
     map                         select new .sbmap file
     pb                          change pitch bend amount
     sus                         toggles sustain pedal polarity
-    save                        saves all current settings
+    save                        saves all current settings (not automatic)
     exit                        exit the program""")
 
     while True:
@@ -239,6 +240,12 @@ def intable(s):
                     pass
         elif s == 'split':
             select_splits()
+        elif s == 'autosplit':
+            if CONFIGS.AUTO_SPLIT is not None:
+                CONFIGS.AUTO_SPLIT = None
+            else:
+                CONFIGS.AUTO_SPLIT = SplitData(CONFIGS.MAPPING)
+            print(f'Auto Split: {"on" if CONFIGS.AUTO_SPLIT is not None else "off"}')
         elif s == 'map':
             select_mapping()
         elif s == 'pb':

__pycache__/split.cpython-39.pyc

@@ -34,6 +34,14 @@ def __init__(self, sbm_file_path):
         """
 
         self.load_mapping(sbm_file_path)
+        
+        
+        # Add heuristic for how many edosteps per octave (assumes octaves are mapped all the same on the seaboard)
+        # Calculate step offset difference between lowest split of C4 to C5 to get EDO
+        self.edo = self.__keys[convert.notename_to_midinum('c5')][0][2] - self.__keys[convert.notename_to_midinum('c4')][0][2]
+        '''
+        A heuristic guess on how many steps correspond to an octave. Used for auto splitting in MIDI mode.
+        '''
 
     def load_mapping(self, sbm_file_path):
         self.__keys = {}
@@ -70,7 +78,7 @@ def load_mapping(self, sbm_file_path):
 
                 previous_cc74 = 0
 
-                split_points = []
+                vert_split_points = []
                 last_split_point = 0
                 for cc74, cents, steps in segments:
                     try:
@@ -96,13 +104,13 @@ def load_mapping(self, sbm_file_path):
                     except Exception:
                         raise MapParsingError(f'line {linecount}: invalid steps value: {steps}')
 
-                    split_points.append((cc74, cents, steps))
+                    vert_split_points.append((cc74, cents, steps))
                     last_split_point = cc74
 
                 if last_split_point != 128:
                     raise MapParsingError(f'line {linecount}: last cc74 split point of a key must be 128')
 
-                self.__keys[midinote] = split_points
+                self.__keys[midinote] = vert_split_points
 
         print('Mapping loaded!')