Интерфейс командной строки Polyphone
Polyphone можно запускать из командной строки для преобразования SoundFont в формат sf2, sf3, sfz, csv или dls. Для преобразования поддерживаются форматы файлов sf2, sf3, sfz, dls, sfArk и organ.
MIDI-файл можно воспроизвести с SoundFont и записать в wav-файл. Также можно указать параметры для открытия Polyphone в режиме синтезатора или с запущенным сервером MCP.
Файлы и каталоги можно передавать в качестве аргументов, чтобы открыть их в графическом интерфейсе, например polyphone file1.sf2 file2.sf3 /path/to/directory (каталог открывается в обозревателе SoundFont). Если Polyphone уже открыт, файлы открываются в запущенном экземпляре. Есть и несколько других параметров для сброса конфигурации или вывода справки и версии.
Список всех параметров выводится командой polyphone --help. Порядок аргументов не имеет значения. Параметры предыдущих версий по-прежнему поддерживаются.
Примечание: в Windows вместо polyphone нужно указать полный путь к Polyphone, например C:/Program files/Polyphone/polyphone.exe.
Преобразование
Командная строка
polyphone --convert <формат> <файлы/для/преобразования> -d <выходной/каталог> -o <выходной/файл> -f
Аргументы
- --convert
- Формат преобразования: «sf2», «sf3», «sfz», «csv» или «dls»; параметры, специфичные для каждого формата, описаны ниже. Этот аргумент необязателен, если выходной файл указан с расширением, например polyphone file.sf2 -o file.sf3.
- -d, --output-dir
- Выходной каталог, который должен существовать. Этот аргумент необязателен; по умолчанию используется каталог каждого входного файла.
- -o, --output
- Выходной файл, с расширением или без него (расширение формата добавляется автоматически). Этот аргумент необязателен; по умолчанию выходной файл получает имя входного файла. Имя без пути записывается в выходной каталог, относительный путь отсчитывается от текущего каталога (или от выходного каталога, если используется -d). Этот аргумент нельзя использовать, если преобразуется несколько файлов.
- -f, --force
- Заменяет существующий выходной файл. Без этого аргумента преобразование завершается с ошибкой, если выходной файл уже существует. Входной файл можно заменить результатом его преобразования, например polyphone --convert sf2 file.sf2 -f перезаписывает file.sf2.
Одной командой можно преобразовать несколько файлов, при этом каждый выходной файл получает имя своего входного файла. В случае ошибки остальные файлы всё равно преобразуются.
Примеры
polyphone --convert sf2 /path/to/file.sfArk
polyphone /path/to/file.sf2 -o /path/to/converted.sf3
polyphone --convert sf3 *.sf2 -d /path/to/directory
Преобразование в sf2
Для этого преобразования особые параметры не используются.
polyphone --convert sf2 /path/to/file.dls
Преобразование в sf3
- --quality
- Качество сжатия: «low» (низкое), «medium» (среднее) или «high» (высокое). Этот аргумент необязателен; по умолчанию используется «medium».
polyphone --convert sf3 /path/to/file.sf2 --quality high
Преобразование в sfz
- --preset-prefix
- К имени каждого пресета в начале добавляется его номер.
- --bank-dir
- Для каждого банка создаётся отдельный каталог.
- --gm-sort
- Для сортировки пресетов используется классификация General MIDI.
polyphone --convert sfz /path/to/file.sf3 --bank-dir --gm-sort
При преобразовании создаётся каталог (с именем выходного файла), содержащий файлы sfz и подкаталог samples. Если этот каталог уже существует, к его имени добавляется номер: ничего не заменяется, даже с -f.
Преобразование в .csv
- --raw
- Экспортируются необработанные значения (в том виде, в каком они хранятся в файле SoundFont), а не значения в физических измеримых единицах. Например, экспортированное время затухания будет 0,491 (секунды) или -1229 в необработанном виде. По умолчанию экспортируются значения в физических единицах.
polyphone --convert csv /path/to/file.sf2 --raw
При преобразовании создаётся каталог (с именем выходного файла), содержащий файл samples.csv, а также по одному файлу на каждый инструмент и каждый пресет. Если этот каталог уже существует, к его имени добавляется номер: ничего не заменяется, даже с -f.
Преобразование в dls
Для этого преобразования особые параметры не используются.
polyphone --convert dls /path/to/file.sf2
Файл записывается в формате DLS уровня 2; ограничения преобразования описаны здесь.
Рендеринг MIDI-файла
Командная строка
polyphone --render <MIDI/файл> <SoundFont> -d <выходной/каталог> -o <выходной/файл> -f
Аргументы
- --render
- Путь к воспроизводимому MIDI-файлу (расширение .mid, .midi, .kar или .rmi): MIDI-файл воспроизводится с SoundFont, а результат записывается в wav-файл.
- -d, --output-dir
- Выходной каталог, в который будет записан wav-файл. Этот аргумент необязателен; по умолчанию используется каталог MIDI-файла.
- -o, --output
- Выходной wav-файл, с расширением или без него. Этот аргумент необязателен; по умолчанию wav-файл получает имя MIDI-файла.
- -f, --force
- Заменяет существующий wav-файл.
Пример
polyphone --render /path/to/song.mid /path/to/file.sf2
Все каналы MIDI-файла играют SoundFont, а пресеты выбираются сообщениями смены программы из файла (банк 128 на канале 10, для ударных). Используются настройки синтезатора: звук (реверберация, хорус, общая громкость), полифония и строй. Результат — стереофонический wav-файл в 32-битном формате с плавающей запятой с частотой 48 000 Гц, который заканчивается, когда звук последних нот затихает. Ноты пресета, которого нет в SoundFont, не воспроизводятся, и для этого пресета выводится предупреждение. В графическом интерфейсе MIDI-файл также можно экспортировать из MIDI-проигрывателя, где каждый канал может играть свой SoundFont или пресет.
Режим синтезатора
Командная строка
polyphone --synth <файл/для/чтения> --channel <канал> --multiple-selection --key-selection <режим>

Аргументы
- -s, --synth
- Polyphone открывается в режиме синтезатора.
- --channel
- Номер MIDI-канала (от 1 до 16), который прослушивается для игры. Значение «all» означает, что используются все каналы, обрабатываемые как один канал (значение по умолчанию). Значение «each» прослушивает каждый канал отдельно, что необходимо, например, для воспроизведения MIDI-выхода секвенсора (MIDI-файл также можно воспроизвести напрямую в MIDI-проигрывателе).
- --multiple-selection
- Для игры можно выбрать несколько пресетов.
- --key-selection
- Со значением «on» пресеты выбираются клавишами, соответствующими номеру пресета (например, клавиша 0 включает пресет 0). Со значением «toggle» клавиша также снимает выбор со своего пресета.
Эти аргументы необязательны, а настройки затем можно изменить в графическом интерфейсе.
Пример
polyphone --synth /path/to/file.sf2 --channel 1 --multiple-selection --key-selection toggle
Сервер MCP
Командная строка
polyphone --mcp <файлы/для/открытия> --mcp-port <порт>
Аргументы
- --mcp
- Сервер MCP, позволяющий ИИ-ассистенту просматривать, редактировать и анализировать открытые SoundFont, запускается для этого сеанса, даже если он отключён в настройках. Адрес сервера выводится в консоль. Открывается новый экземпляр Polyphone, даже если Polyphone уже открыт.
- --mcp-port
- Порт сервера MCP (этот аргумент подразумевает --mcp). Этот аргумент необязателен; по умолчанию используется порт из настроек (8642).
Изменение настроек сервера MCP в графическом интерфейсе заменяет эти параметры.
Пример
polyphone --mcp-port 8700 /path/to/file.sf2
Другие параметры
- -h, --help
- Выводит список всех параметров.
- -v, --version
- Выводит версию Polyphone.
- -r, --reset-config
- Сбрасывает конфигурацию Polyphone (настройки, геометрия окон, история и т. д.). Это может быть полезно при возникновении проблем.
polyphone --reset-config
Сообщения и коды возврата
Ход загрузки и записи выводится в консоль, а ошибки записываются в поток ошибок. Сообщения и справка выводятся на языке, выбранном в настройках.
Код возврата:
- 0
- Успех.
- 1
- Входной файл или выходной каталог не существует, либо выходной файл уже существует (без -f).
- 2
- Аргументы недопустимы: неизвестный параметр, неверное значение, параметр не используется в выбранном режиме, неподдерживаемый формат входного файла и т. д.
- 3
- Входной файл не удаётся прочитать (SoundFont, MIDI-файл).
- 4
- Не удаётся записать результат.
Если преобразуется несколько файлов, возвращается код первой ошибки.
Параметры предыдущих версий
Параметры предыдущих версий Polyphone по-прежнему поддерживаются:
- -1, -2, -3, -4, -6
- Преобразование в sf2, sf3, sfz, csv и dls, как с --convert.
- -5
- Рендеринг MIDI-файла, путь к которому указывается с -c.
- -i
- Входной файл, который можно указать и без этого параметра.
- -c
-
Конфигурация из значений, разделённых символом «|»:
- преобразование в sf3: качество сжатия, «0» — низкое, «1» — среднее, «2» — высокое;
- преобразование в sfz: 3 значения, «1» или «0», для --preset-prefix, --bank-dir и --gm-sort, например «0|1|1»;
- преобразование в csv: «raw» для --raw;
- рендеринг MIDI-файла (-5): путь к MIDI-файлу;
- режим синтезатора: канал («all», «each» или от 1 до 16, причём 0 равнозначен «all», а -1 — «each»), множественный выбор («on» или «off») и выбор клавишами («on», «off» или «toggle»), например «all|on|toggle».
polyphone -2 -i /path/to/file.sf2 -c 2
polyphone -s -i /path/to/file.sf2 -c 'all|on|toggle'
Polyphone бесплатен, но содержание сайта и разработка требуют расходов. Даже небольшое пожертвование очень поможет.
Поддержать