NAME

       sonivoxrender — Render standard MIDI files into raw PCM audio

SYNOPSIS

       sonivoxrender  [-h|--help]  [-v|--version]  [-d|--dls  file.dls]  [-r|--reverb  0..4] [-w|--wet 0..32767]
       [-n|--dry 0..32767] [-c|--chorus 0..4] [-l|--level 0..32767] [-g|--gain 0..100] midi_file

DESCRIPTION

       This program is a MIDI file renderer based on the sonivox synthesizer library.  It reads  .MID  (Standard
       MIDI  Files) file format, and writes an audio stream to the standard output as raw 16 bit stereo PCM sam‐
       ples.

   Options
       -h, --help
              Prints brief usage information.

       -v, --version
              Prints the version numbers.

       -d, --dls file.dls
              Optional DLS soundfont file name.  If not provided, it uses an internal embedded soundfont.

       -r, --reverb reverb_preset
              Reverb preset between 0 and 4: 0=no, 1=large hall, 2=hall, 3=chamber, 4=room.

       -w, --wet reverb_wet
              Reverb wet level between 0 and 32767.

       -n, --dry reverb_dry
              Reverb dry level between 0 and 32767.

       -c, --chorus chorus_preset
              Chorus preset between 0 and 4: 0=no, 1..4=presets.

       -l, --level chorus_level
              Chorus level between 0 and 32767.

       -g, --gain master_gain
              Master gain between 0 and 100, default is 90 (10 dB below maximum).

   Arguments
       midi_file
              Input MID file name.

EXAMPLES

       The following examples assume the default option USE_44KHZ=ON, which means an output sample rate =  44100
       Hz.

       Example 1: Render a MIDI file and save the rendered audio as a raw audio file:

              $ sonivoxrender ants.mid > ants.pcm

       Example 2: pipe the rendered audio thru the Linux ALSA aplay utility:

              $ sonivoxrender ants.mid | aplay -c 2 -f S16_LE -r 44100

       is equivalent to:

              $ sonivoxrender ants.mid | aplay -f cd

       Example 3: pipe the rendered audio thru the lame utility creating a MP3 file:

              $ sonivoxrender ants.mid | lame -r -s 44100 - ants.mp3

       Example 4: pipe the rendered audio thru the sox utility creating a WAV file:

              $ sonivoxrender ants.mid | sox -t s16 -c 2 -r 44100 - ants.wav

       Example 5: pipe the rendered audio thru the PulseAudio’s pacat utility:

              $ sonivoxrender ants.mid | pacat

BUGS

       See Tickets at GitHub <https://github.com/pedrolcl/sonivox/issues/>

LICENSE AND COPYRIGHT

       Licensed under the Apache License, Version 2.0

       Copyright (c) 2022-2024 Pedro López-Cabanillas and contributors

AUTHORS

       Pedro López-Cabanillas <plcl@users.sf.net>.

sonivox 3.6.15.0                                December 14, 2024                               SONIVOXRENDER(1)