How To Use v0.95 - matthew-alex-hill/Transupposer GitHub Wiki

Select Input and Output Files

Use the 'Browse' buttons to select an input file and select/create an output file if needed

Select Roots and Modes

Enter a key in the input root and output root boxes and click 'Submit' for both. You should get a confirmation message in the status area saying that the input or output root is updated. A valid key is any note name followed by any number of #s or bs for example "C###", "Abb", "D", "E#b#b". Then select the input mode and output mode on the sliders. Make your your input mode is correct to the piece as otherwise you will not transpose to the expected output mode.

Select a Custom Scale

Enable the 'Diatonic Note Customisation' and 'Chromatic Note Customisation' check boxes. Two series of dropdown menus will appear for the scale notes and accidentals of the input scale. These will be filled with the calculated output mode scale by default and can be changed to whatever notes you please. These values will be saved until either the output root or mode settings are changed or the program is restarted. If you enable only one of the check boxes, you can customise either the scale notes or the accidentals and leave the other notes as default.

Play Midi Preview

Click the play button to play the midi preview after selecting an input file. Press the >> and << buttons to modify playback speed. Press the -> or <- buttons to jump forward or backwards 10 seconds. Press stop to stop playback. Press pause to stop playback and save current position. You will have to press play every time you change a transposer setting in this current build. Note: Windows users may have a problem where midi files are played at the wrong speed in this version.

Changing Key Mid Piece

To change key mid piece simply adjust your settings and then press the 'Update Scales' button, the piece will now be transposed again and played from the current position in the new key. There may be a small delay as the transposing process has to restart. You can also enable auto-updating of the transposer by checking the 'Auto Update Transposer' box in settings. This will update the transposer every time a setting is changed.

Create a Transposed File

Hit 'Transpose' to create your transposed file, and locate it in the output file path you selected earlier.

Record a Transposed File With Key Changes

Select an output file following the 'Select Input and Output Files' section. Hit "Record to File", update keys as you please whilst the midi playback is playing. Hit stop to stop the recording, the current key will continue to the end of the piece. NOTE: This current version only correctly record if the piece is stopped BEFORE the midi sequence comes to an end, so make sure to hit the stop button before your piece ends.

Settings

In the settings panel there are a number of options which alter the view of the program. These options are as follows:

  • View File Select - Enable or disable view of the input and output file setters
  • View Root Setting - Enable or disable view of the input and output root setters
  • View Midi Controls - Enable or disable view of midi playback buttons
  • Diatonic Note Customisation - Enable or disable view of diatonic note selectors and enable or disable use of these custom notes
  • Chromatic Note Customisation - Enable or disable view of chromatic note selectors and enable or disable use of these custom notes
  • Auto Update Transposer - Enables or disables auto-updating (See 'Changing Key Mid Piece')
  • Enable File Output - Enables or disables output to file, either through the 'Transpose to File' or 'Record to File' buttons