NAME

peta-synth - MIDI files to sound, with the synthesizer of Peta::Synth

VERSION

version 0.2610180

SYNOPSIS

peta-synth render song.mid song.flac                  # wav, flac, mp3, ogg, opus
peta-synth render song.mid song.mp3 --quality V2 --workers 4
peta-synth play song.mid                              # as it renders
peta-synth live                                       # what keyboards and sequencers send
peta-synth serve --midi ~/music --bank my-bank.json   # behind a web page
peta-synth inputs
peta-synth info song.mid
peta-synth profile song.mid
peta-synth engines
peta-synth --help                                     # every command's options

DESCRIPTION

render

A MIDI file into a sound file, its peak normalized; the format from the name's extension. --partials sets the quality (and the cost), --workers shares the notes among processes. --fidelity (low, mid, high) what may be left out that is hardly heard: high, as ever, by default; play, live and serve take mid, for playing as it renders on a machine that might not keep up.

play

Plays a MIDI file on the sound server (PipeWire, or the PulseAudio protocol) as it renders, giving new notes fewer partials when the machine falls behind (unless --fixed).

live

Plays MIDI as it comes in: from the ALSA sequencer's sources (keyboards, sequencers, other programs), a raw MIDI device or a pipe.

serve

The synthesizer behind a web page (Peta::Synth::Server): played from the page's keyboard or Web MIDI, its patches, channels, reverb and equalizers changed while it sounds. It listens on 127.0.0.1 unless --host says otherwise. MIDI files are played from, and those dropped on the page saved into, --midi: by default examples/midi beside the script where it is there (a checkout), else the directory it is run in.

inputs, info, profile, engines

The MIDI sources there are; what a MIDI file holds; what rendering it will cost, step by step (Peta::Synth::Profile); what this perl and machine have, the engines measured.

--bank takes the instrument changes the web page saves.

SEE ALSO

Peta::Synth, Peta::Synth::Server, peta-analyze.

AUTHOR

PetaMem s.r.o. <info@petamem.com>

COPYRIGHT

Copyright (c) 2026 PetaMem s.r.o.

LICENSE

This package is free software, dual-licensed under the Artistic License 2.0 and the BSD 2-Clause License. See the LICENSE file of the distribution.