1zresample(1)                     USER COMMANDS                    zresample(1)
2
3
4

NAME

6       zresample - resample and change sample format of audio files
7

SYNOPSIS

9       zresample [options] input-file output-file
10

DESCRIPTION

12       zresample  copies  an  audio  file, changing the sample rate and/or the
13       sample format. For 16-bit output it can also dither the  audio  signal.
14       Input  can  be  any  audio file readable by the libsndfile library. The
15       output file type is either WAV, WAVEX, CAF, AIFF or FLAC.
16

OPTIONS

18       --help Display a short help text.
19
20       --rate sample-rate
21              Set the output sample rate.  Zresample uses  the  zita-resampler
22              library  which  means  that not all combinations of input/output
23              sample rate will be accepted.  The resample ratio must be a red‐
24              ucable to a fraction a/b with both a and b less than or equal to
25              1000.
26
27       --gain gain
28              Gain in dB, default zero.
29
30   Output file type
31       --wav  Produce a WAV file, or for more than 2 channels, a  WAVEX  file.
32              This is the default.
33
34       --amb  Produce  a WAVEX file with the Ambisonic GUID. Such files should
35              have the .amb filename extension.
36
37       --caf  Produce a Core Audio file.
38
39       --aiff Produce an AIFF file.
40
41       --flac Produce a FLAC file.
42
43   Output sample format
44       --16bit
45              Output sample format is signed 16-bit. This option also  enables
46              the use of dithering, described below.
47
48       --24bit
49              Output sample format is 24-bit. This is the default.
50
51       --float
52              Output sample format is 32-bit floating point.
53
54   Dithering
55       --rec  Add  white dithering noise with a rectangular distribution. This
56              is the best option if the output  data  is  going  to  processed
57              again,  but  in that case it would be advisable to use 24-bit or
58              float.
59
60       --tri  Add filtered noise with a triangular distribution.  Compared  to
61              the  rectangular  dither  this  reduces the noise density in the
62              lower frequency range.
63
64       --lips This uses the optimal error feedback filter described by Stanley
65              Lipschitz.  This  is recommended is the output is the final dis‐
66              tribution format, e.g. for a CD.
67
68   Timing
69       --pad  Insert zero valued input samples at the start and  end  so  that
70              the  output includes the full symmetric filter response even for
71              the first and last samples.
72

EXIT STATUS

74       Zero in case there are no errors, non-zero otherwise.
75

AUTHOR

77       Fons Adriaensen (fons (at) linuxaudio.org)
78
79
80
81version 0.0.1                      May 2010                       zresample(1)