POLYPHONE(1) Polyphone Manual Page POLYPHONE(1)

polyphone - soundfont editor

polyphone
polyphone [FILE]
polyphone [FILE_1] [FILE_2] ...
polyphone -1 [-i INPUT_FILEPATH] [-d OUTPUT_DIR] [-o OUTPUT_NAME]
polyphone -2 [-i INPUT_FILEPATH] [-d OUTPUT_DIR] [-o OUTPUT_NAME] [-c CONFIG]
polyphone -3 [-i INPUT_FILEPATH] [-d OUTPUT_DIR] [-o OUTPUT_NAME] [-c CONFIG]
polyphone -s [-i INPUT_FILEPATH] [-c CONFIG]

polyphone provides a simple and efficient interface for creating and editing .sf2 files. This software comprises tools to facilitate and automate the editing of different parameters, making it possible to handle a large amount of data.

sf2, sf3, sfz (import / export), sfArk (import only) and GrandOrgue (import only) formats are supported. Command lines can be used to convert files, open Polyphone in synthesizer mode or reset configurations in case of trouble.

More information can be found at https://www.polyphone.io .

Specifies the file to open when polyphone starts. Multiple files can be loaded if they are separated by spaces. sf2 (version 2.01 or 2.04), sf3, sfz, sfArk (version 1 or 2) and GrandOrgue formats are supported.
-1
Use polyphone to convert a file into the sf2 format.
-2
Use polyphone to convert a file into the sf3 format.
-3
Use polyphone to convert a file into the sfz format.
Open polyphone in synthesizer mode.
[-i INPUT_FILEPATH]
Input file path to convert or open. The input file format must be sf2, sf3, sfz, sfArk or organ.
[-d OUTPUT_DIR]
Output directory in which the input file will be converted. By default, this is the same directory than the input file.
[-o OUTPUT_NAME]
Output name of the converted file. The extension will be automatically added depending on the conversion. By default, this is the same name than the input file.
[-c CONFIG]
Conversion configuration, the content being dependent on the conversion type. -r Remove the existing configuration.

* sf2 conversion
No configuration for this conversion.

* sf3 conversion
The configuration is made of one character indicating the compression quality. '0' for low, '1' for medium and '2' for high quality. Default is '1'.

* sfz conversion
The configuration is made of three characters. The first character is '1' if each preset must be prefixed by its preset number, '0' otherwise. The second character is '1' if a directory per bank must be created, '0' otherwise. The third character is '1' if the general midi classification must be used to sort presets, '0' otherwise. Default is '000'.

* synthesizer mode
The configuration is made up of 3 parts separated by a '/'. The first part specifies the MIDI channel to be listened to, which can be a value from 1 to 16 or 'all'. The second part is 'on' or 'off' to enable playback of several presets at the same time. The third part is 'on', 'off' or 'toggle' to enable presets to be activated or deactivated by the lowest notes on the keyboard.


* Conversion from sfArk to sf2:
polyphone -1 -i /path/to/file.sfArk

* Conversion from sf2 to sf3 (good quality):
polyphone -2 -i /path/to/file.sf2 -c 2

* Conversion from sf3 to sfz (sub-directories for bank and gm classification):
polyphone -3 -i /path/to/file.sf3 -c 011

* Open Polyphone in synthesizer mode, allowing use of the bass keys to select the ensemble to be played with a MIDI keyboard:
polyphone -s -i /path/to/file.sf2 -c 'all/off/toggle'

Davy Triponney (davy.triponney@gmail.com)

September 3rd, 2019 polyphone 2.4