PDF version Edit on GitHub 

Command line

Polyphone can be run with a command line to convert soundfonts in the format sf2, sf3 or sfz. Supported file formats for the conversion are sf2, sf3, sfz, sfArk and organ.

An option can also be called for opening Polyphone in synth mode.

Conversion to sf2

Command line

polyphone -1 -i <file/to/convert> -d <output/directory> -o <output_file_name>

Note: with Windows you need to write the full path of Polyphone instead of just polyphone, which is for example C:/Program files/Polyphone/polyphone.exe.

Arguments

-1

Mode “1” is “convert to sf2”.

-d

Output directory in which the input file will be converted. This argument is optional, by default this is the same directory than the input file.

-o

Output name of the converted file without the extension (the extension “.sf2” will be automatically added). This argument is optional, by default this is the same name than the input file.

Example

polyphone -1 -i /path/to/file.sfArk

Conversion to sf3

Command line

polyphone -2 -i <file/to/convert> -d <output/directory> -o <output_file_name> -c <configuration>

Note: with Windows you need to write the full path of Polyphone instead of just polyphone, which is for example C:/Program files/Polyphone/polyphone.exe.

Arguments

-2

Mode “2” is “convert to sf3”.

-d

Output directory in which the input file will be converted. This argument is optional, by default this is the same directory than the input file.

-o

Output name of the converted file without the extension (the extension “.sf3” will be automatically added). This argument is optional, by default this is the same name than the input file.

-c

Conversion configuration. It is possible to specify the compression quality: “0” is low, “1” is medium, “2” is high. This argument is optional, by default this is “1” (medium quality).

Example

polyphone -2 -i /path/to/file.sf2 -c 2

Conversion to sfz

Command line

polyphone -3 -i <file/to/convert> -d <output/directory> -o <output_file_name> -c <configuration>

Note: with Windows you need to write the full path of Polyphone instead of just polyphone, which is for example C:/Program files/Polyphone/polyphone.exe.

Arguments

-3

Mode “3” is “convert to sfz”.

-d

Output directory in which the input file will be converted. This argument is optional, by default this is the same directory than the input file.

-o

Output name of the converted file without the extension (the extension “.sfz” will be automatically added). This argument is optional, by default this is the same name than the input file.

-c

Conversion configuration made of 3 values separated by the “|” character. This argument is optional, by default this is “0|0|0”.

• The first value is “1” if each preset must be prefixed by its preset number, “0” otherwise.
• The second value is “1” if a directory per bank must be created, “0” otherwise.
• The third value is “1” if the General MIDI classification must be used to sort presets, “0” otherwise.

Example

polyphone -3 -i /path/to/file.sf3 -c '0|1|1'

Synth mode

Command line

polyphone -s -i <file/to/read> -c <configuration>

Note: with Windows you need to write the full path of Polyphone instead of just polyphone, which is for example C:/Program files/Polyphone/polyphone.exe.

Arguments

-s

Mode “s” is “open Polyphone in synth mode”.

-c

Synth configuration made of 3 values separated by the “|” character. This argument is optional, by default this is “0|off|off”. These parameters can then be changed via the graphical interface.

• The first value is the MIDI channel number (between 1 and 16) to be listened to for playing. A value of 0 or “all” to indicates that all channels will be used and processed as one channel. A value of -1 or “each” listens to each channel separately, which is a prerequisite for playing MIDI files for instance.
• The second value is “off” or “on”, enabling or disabling the selection of multiple presets for playing.
• The third value is “off”, “on”, or “toggle”, enabling or disabling the selection of presets by the keys corresponding to the preset number (key 0 activates preset 0, for example).

Example

polyphone -s -i /path/to/file.sf2 -c '1|on|toggle'