Skip to content

Latest commit

 

History

History
85 lines (52 loc) · 3.51 KB

README.md

File metadata and controls

85 lines (52 loc) · 3.51 KB

Midi to Scaler chord sets

Convert chord progressions from midi files to Plugin Boutique's Scaler 2 sets.

This little tool iterates through all midi files from a given folder and exports the chord progressions in XML files to easily create Scaler 2 chord packs.

Considerations:

  • If a midi file has multiple tracks, only the first track with notes will be used.
  • Tested only with midi files that have no overlaps (further testing and pull requests are welcome!).

Example

Go to the examples folder to see a converted midi file like this one:

converted palette
Original midi file

converted palette
Converted chord set loaded in Scaler 2

Run binaries

  • Download the latest release for your platform (Windows or MacOS) and unzip it.
  • Group your .mid or .midi files in folders and add them to the midis folder. Each folder will be converted to a set (a demo set with a single chord progression is provided for a quick demo).
  • Continue depending on your OS:

Windows

  • Open a Command Prompt (cmd.exe) and navigate to the unzipped folder, for example:

    cd C:/Users/YOUR_USER/Downloads/midi-to-scaler-chord-sets_1.0.0_windows

  • Run the tool by typing in the cmd:

    midi-to-scaler-chord-sets.exe

  • The converted files should be in the sets folder, copy each folder set to the custom sets folder and start using them: C:/Users/Public/Documents/Plugin Boutique/Scaler2/Sets

MacOS

  • Open the Terminal and navigate to the unzipped folder, for example:

    cd /Users/YOUR_USER/Downloads/midi-to-scaler-chord-sets_1.0.0_macos

  • Grant execute permission to the tool by typing in the terminal:

    chmod +x midi-to-scaler-chord-sets

  • Run the tool by typing in the terminal:

    ./midi-to-scaler-chord-sets

  • The converted files should be in the sets folder, copy each folder set to the custom sets folder and start using them: /Users/Shared/Plugin Boutique/Scaler2/Sets

⚠️Warning: Running the tool by double clicking the executable may not work because it will look for the configuration file in the home directory.

Run from source

Be sure to have Node.js installed, then:

  • Download or clone the repo.
  • Run npm install in the root folder to install dependencies.
  • Group your .mid or .midi files in folders and add them to the midis folder. Each folder will be converted to a set.
  • Run npm run convert to run the conversion.
  • The converted files should be in the sets folder, copy each folder set to the custom sets folder and start using them:
    • Windows path: C:/Users/Public/Documents/Plugin Boutique/Scaler2/Sets
    • MacOS path: /Users/Shared/Plugin Boutique/Scaler2/Sets

Configuration

The input, output and threshold for chord detection can be changed in: config.json

Configuration parameters

  • threshold: time interval in MIDI ticks to determine the maximum amount of time between note-on and note-off events for the events to be considered part of the same chord.
  • inFolderPath: folder used to read the midi files, it must contain subfolders with the midi files for each set. The name of each subfolder will name the set.
  • outFolderPath: folder used to save the converted sets.