zresample(1)

✨ zresample(1) ✨

okay bestie, pull up a chair 🫶 this is zresample, a USER COMMANDS legend from the zita-resampler universe, and she is literally here to resample and change the sample format of your audio files. no cap. let's get into it 💅

---

🎀 NAME 🎀

zresample — resample and change sample format of audio files

---

🦋 SYNOPSIS 🦋

zresample [options] input-file output-file

---

💖 DESCRIPTION 💖

so what she does is: she copies an audio file, but changes the sample rate and/or the sample format while she's at it. main character behavior, honestly. ✨

for 16-bit output she can also dither the audio signal — yes, dither, we love her for that. 💅

your input can be any audio file that the libsndfile library can read, so like, basically anything. the output file type is one of: WAV, WAVEX, CAF, AIFF or FLAC. periodt.

---

🌸 OPTIONS 🌸

• --help — display a short help text. the "hey bestie, here's the vibe" button 💖
• --rate sample-rate — set the output sample rate. ok so this one's important: zresample uses the zita-resampler library, which means not all combinations of input/output sample rate will be accepted. the resample ratio must be reducible to a fraction a/b with both a and b less than or equal to 1000. that's the rule, no exceptions, she's picky and that's iconic of her 🙈
• --gain gain — gain in dB, default zero. that's a literal zero, not "zero vibes", just zero. 💀

🌈 Output file type 🌈

• --wav — produce a WAV file, or for more than 2 channels, a WAVEX file. this is the default. yes queen, she comes pre-loaded. 👑
• --amb — produce a WAVEX file with the Ambisonic GUID. such files should have the .amb filename extension. so like, use .amb, bestie, don't be chaotic. 🌀
• --caf — produce a Core Audio file.
• --aiff — produce an AIFF file.
• --flac — produce a FLAC file. lossless girlie 🍓

⭐ Output sample format ⭐

• --16bit — output sample format is signed 16-bit. this option also enables the use of dithering, described below 👇
• --24bit — output sample format is 24-bit. this is the default. she just shows up like that 💅
• --float — output sample format is 32-bit floating point.

🧚 Dithering 🧚

• --rec — add white dithering noise with a rectangular distribution. this is the best option if the output data is going to be processed again, but in that case it would be advisable to use 24-bit or float. so like — if it's getting reworked later, go big or go home 💖
• --tri — add filtered noise with a triangular distribution. compared to the rectangular dither this reduces the noise density in the lower frequency range. lowkey a glow-up for your low end 🌸
• --lips — this uses the optimal error feedback filter described by Stanley Lipschitz. this is recommended if the output is the final distribution format, e.g. for a CD. final boss energy, she ate 🔥

🦋 Timing 🦋

• --pad — insert zero valued input samples at the start and end so that the output includes the full symmetric filter response even for the first and last samples. so nobody gets chopped at the edges, bestie 🥺

---

💀 EXIT STATUS 💀

Zero in case there are no errors, non-zero otherwise. simple. clean. she's not dramatic about it (unlike me). ✨

---

💜 AUTHOR 💜

Fons Adriaensen (fons (at) linuxaudio.org)

---

ngl bestie, if you're feeding her weird sample rate combos, remember the a/b with a and b ≤ 1000 thing. she will not negotiate. 🙈

version 0.0.1 🌸 May 2010 🌸 that's the whole page, bestie — go resample something iconic. mwah 🎀💖✨