POLYPHONE(1)

💅 POLYPHONE(1) — soundfont editor, but make it cute

okay so welcome to the Polyphone Manual Page, bestie. This is the whole vibe: polyphone is a soundfont editor, and this manual is here to help you not get lost. It’s giving manual but make it group chat. 🎀

💖 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 -4 [-i INPUT_FILEPATH] [-d OUTPUT_DIR] [-o OUTPUT_NAME] [-c CONFIG]
polyphone -s [-i INPUT_FILEPATH] [-c CONFIG]

🌸 DESCRIPTION

polyphone gives you a simple and efficient interface for creating and editing .sf2 files. No cap, this software comprises tools to facilitate and automate the editing of different parameters, making it possible to handle a large amount of data. 🦋

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

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

🎛️ OPTIONS (the main character section, lowkey) 🎛️

• FILE — specifies the file to open when polyphone starts. Multiple files can be loaded if they are separated by spaces. Supported formats are sf2 (version 2.01 or 2.04), sf3, sfz, sfArk (version 1 or 2) and GrandOrgue. 💖
• -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.
• -4 — use polyphone to convert a file into the csv format.
• -s — open polyphone in synthesizer mode. synth girl summer, literally. 🎹
• [-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 as 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 as the input file.
• [-c CONFIG] — conversion configuration; the content depends 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'.
  • csv conversion — the option 'raw' can be used to export raw values (as they are stored in the soundfont file) rather than values with physical, measurable units. For example, the exported release time will be 0.491 (milliseconds) or -1229 in its raw form. By default, values with physical units are exported.
  • 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” 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 (copy-paste era) 🌈

1. Conversion from sfArk to sf2:

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

2. Conversion from sf2 to sf3 (good quality):

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

3. Conversion from sf3 to sfz (sub-directories for bank and gm classification):

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

4. 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) — fr fr, the icon behind this. 💜

---

🫶 cute sign-off, bestie: this page is from polyphone 2.5, dated Decembre 22nd, 2024. slay and bye! 💅✨