POLYPHONE(1)

NAME
polyphone - soundfont editor

SYNOPSIS
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]

DESCRIPTION
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 .

OPTIONS

FILE
    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.

-s  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 up of 3 values separated by a '|'. 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. Default is '0|0|0'.
     * synthesizer mode
    The configuration is made up of 3 values separated by a '|'. The first value specifies the MIDI channel to be listened to, which can be a value from 1 to 16. 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 'on' or 'off' to enable playback of several presets at the same time. The third value is 'on', 'off' or 'toggle' to enable presets to be activated or deactivated by the lowest notes on the keyboard. Default is 'all|off|off'.

EXAMPLES
 * 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 '0|1|1'
 * 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'

AUTHOR
Davy Triponney (contact@polyphone.io)