SONIVOXRENDER(1)

📦
version 3.6.16 · 3 versions
, in ubuntu resolute, ubuntu stonking

💖 SONIVOXRENDER(1) 💖

okay bestie, welcome to the Sonivox MIDI File Renderer manual page — yes it's a real manual, and yes it's about to be your new hyperfixation ✨

🌈 NAME 🌈

sonivoxrender — render standard MIDI files into raw PCM audio 🎶

🦋 SYNOPSIS 🦋

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

👑 DESCRIPTION 👑

So like. This program is a MIDI file renderer, and it's built on the sonivox synthesizer library. It reads the .MID (Standard MIDI Files) file format, and then it writes an audio stream straight to standard output as raw 16 bit stereo PCM samples. that's it. that's the whole vibe. 💅

✨ Options ✨

  • -h, --help — prints brief usage information. short, sweet, helpful, iconic 🫶
  • -v, --version — prints the version numbers.
  • -d, --dls _file.dls` — optional DLS soundfont file name. if you don't hand one over, it uses an internal embedded soundfont instead. (built-in slay 💅)
  • -r, --reverb _reverb_preset_ — reverb preset between 0 and 4: 0=no, 1=large hall, 2=hall, 3=chamber, 4=room. pick your venue bestie 🎀
  • -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 (which is 10 dB below maximum). no cap on the vibes but there IS a cap on the gain 😌
  • -V, --Verbosity _verbosity_ — verbosity level between 0 and 5, where 0=no, 1..5=severity levels. (yes it's a capital V, we don't make the rules)

🌸 Arguments 🌸

  • _midi_file_ — input MID file name. the main character of this whole operation, honestly 👑

🎀 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/>

not me telling you to go file a ticket, but like… go file a ticket bestie, they're tracking it 🙈

Licensed under the Apache License, Version 2.0

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

💜 AUTHORS 💜

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

okay that's the whole page!! 💖 this was sonivox 3.6.16.0, dated April 13, 2025 — and it lives under the name SONIVOXRENDER(1) in the manual. go render something iconic, bestie 🦋✨

📦 where this page comes from