1WAVPACK(1) WavPack Executable Programs WAVPACK(1)
2
6 wavpack - encode audio files to wavpack
7
9 wavpack [-options] INFILE... [-o OUTFILE]
10
12 wavpack encodes the specified source file(s) into WavPack files using
13 the options provided. The source files may be any of the file format
14 types listed below, and the audio data may be either uncompressed PCM
15 or DSD (depending on the format). Raw audio may also be specified (see
16 --raw-pcm). The output filename will be source-name.wv unless
17 overridden with the -o switch. Multiple input files may be specified
18 resulting in multiple WavPack files, and in that case -o may be used to
19 specify an alternate target directory. Stdin and stdout may be
20 specified with “-”. In the case of transcoding from existing WavPack
21 files, all tags are copied (and may be modified with additional args)
22 and unless an alternate name or directory is specified, the source
23 files are safely overwritten. To decode WavPack files back to their
24 original format (or raw audio) use the wvunpack program.
25 INPUT FILE FORMATS
27 • Microsoft RIFF, extension “.wav”, includes BWF and RF64 variants
28 • WavPack, extension “.wv”, transcode operation, tags copied
30 • Apple AIFF, extension “.aif”
32 • Apple Core Audio, extension “.caf”
34 • Sony Wave64, extension “.w64”
36 • Philips DSDIFF, extension “.dff”
38 • Sony DSD Stream, extension “.dsf”
40
42 -a
43 Adobe Audition (CoolEdit) mode for 32-bit floats
44 --allow-huge-tags
46 allow tag data up to 16 MB (embedding > 1 MB is not recommended for
47 portable devices and may not work with some programs including
48 WavPack pre-4.70)
49 -bn
51 enable hybrid compression, n = 2.0 to 23.9 bits/sample, or n =
52 24-9600 kbits/second (kbps), not available with DSD audio
53 --blocksize=n
55 specify block size in samples (max = 131072 and min = 16 with
56 --merge-blocks, otherwise 128)
57 -c
59 create correction file (.wvc) for hybrid mode (results in 2-file
60 lossless compression)
61 -cc
63 maximum hybrid compression (hurts lossy quality & decode speed)
64 --channel-order=list
66 specify (comma separated) channel order if not Microsoft standard
67 (which is
68 FL,FR,FC,LFE,BL,BR,FLC,FRC,BC,SL,SR,TC,TFL,TFC,TFR,TBL,TBC,TBR);
69 specify “...” to indicate that channels are not assigned to
70 specific speakers, or terminate list with “...” to indicate that
71 any channels beyond those specified are unassigned
72 --cross-decorr
74 use cross-channel correlation in hybrid mode (on by default in
75 lossless mode and with -cc option)
76 -d
78 delete source file if successful (use with caution!)
79 -f
81 fast mode (fast, but some compromise in compression ratio)
82 --force-even-byte-depth
84 round the bit depth specified in the source file up to the next
85 even byte (e.g., 20-bit is rounded up to 24-bit) to handle cases
86 where the value specified is not correct (i.e., padding bits are
87 non-zero)
88 -g
90 general/normal mode, cancels previously specified -f and -h options
91 -h
93 high quality (better compression ratio, but slightly slower encode
94 and decode than normal mode)
95 -hh
97 very high quality (best compression, but slowest and NOT
98 recommended for use on vintage playback devices)
99 --help
101 display extended help
102 -i
104 ignore length in wav header and allow WAV files greater than 4 GB
105 (note that this will attempt to fix the WAV header stored in the
106 WavPack file, combine with -r to create a fresh header instead)
107 --import-id3
109 import applicable tag items from ID3v2.3 tag present in DSF (and
110 other) files into APEv2 tag (if there are > 1 MB cover images
111 present add --allow-huge-tags to include them, and -r if you do not
112 want large images appearing twice in the WavPack file, although
113 this will remove the entire original ID3v2 tag)
114 -jn
116 joint-stereo override (0 = left/right, 1 = mid/side)
117 -m
119 compute & store MD5 signature of raw audio data
120 --merge-blocks
122 merge consecutive blocks with equal redundancy (used with
123 --blocksize option and is useful for files generated by the
124 lossyWAV program or decoded HDCD files)
125 -n
127 calculate average and peak quantization noise (hybrid only,
128 reference fullscale sine)
129 --no-overwrite
131 never overwrite, nor ask to overwrite, an existing file (this is
132 handy for resuming a cancelled batch operation and obviously cannot
133 be mixed with -y)
134 --no-utf8-convert
136 don't recode passed tags from local encoding to UTF-8, assume they
137 are in UTF-8 already
138 -o OUTFILE
140 specify output filename (only if single source file) or target
141 directory (must exist)
142 --pair-unassigned-chans
144 encode unassigned channels into stereo pairs
145 --pre-quantize=bits
147 pre-quantize samples to bits depth BEFORE encoding and MD5
148 calculation (common use would be --pre-quantize=20 for 24-bit or
149 float material recorded with typical converters)
150 -q
152 quiet (keep console output to a minimum)
153 -r
155 parse headers to determine audio format and length but do not store
156 the headers in the resulting WavPack file (a minimum header will be
157 generated by wvunpack, but some non-audio metadata might be lost)
158 --raw-pcm
160 input data is raw pcm (44,100 Hz, 16-bit, 2-channels)
161 --raw-pcm=sr,bits[f|s|u],chans,[le|be]
163 input data is raw pcm with specified sample-rate, bit-depth
164 (float,unsigned,signed), number of channels, and endianness
165 (defaulted parameters may be omitted, specify bits=1 for DSD)
166 --raw-pcm-skip=begin[,end]
168 skip begin bytes before encoding raw PCM (header) and skip end
169 bytes at the EOF (trailer)
170 -sn
172 override default hybrid mode noise shaping where n is a float value
173 between -1.0 and 1.0; negative values move noise lower in freq,
174 positive values move noise higher in freq, use 0 for no shaping
175 (white noise)
176 -t
178 copy input file's time stamp to output file(s)
179 --use-dns
181 force use of dynamic noise shaping (hybrid mode only)
182 -v
184 verify output file integrity after write (not for piped output)
185 --version
187 write program version to stdout
188 -w Encoder
190 write actual encoder metadata to APEv2 tag (e.g., “Encoder=WavPack
191 5.5.0”)
192 -w Settings
194 write actual user settings metadata to APEv2 tag (e.g.,
195 “Settings=-hb384cx3”)
196 -w “Field=Value”
198 write specified text metadata to APEv2 tag
199 -w “Field=@file.ext”
201 write specified text metadata from file to APEv2 tag, normally used
202 for embedded cuesheets and logs (field names “Cuesheet” and “Log”)
203 --write-binary-tag “Field=@file.ext”
205 write the specified binary metadata file to APEv2 tag, normally
206 used for cover art with the specified field name “Cover Art
207 (Front)”
208 -x[n]
210 extra encode processing (optional n = 0 to 6, 1=default), -x0 for
211 no extra processing, -x1 to -x3 to choose best of predefined
212 filters, -x4 to -x6 to generate custom filters (very slow!)
213 -y
215 yes to all warnings (use with caution!)
216 -z[n]
218 don't set (n = 0 or omitted) or set (n = 1) console title to
219 indicate progress (leaves "WavPack Completed")
220
222 wvunpack(1), wvgain(1), wvtag(1)
223 Please visit www.wavpack.com for more information
225
227 This manual page was written by Sebastian Dröge <slomo@debian.org> and
228 David Bryant <david@wavpack.com>. Permission is granted to copy,
229 distribute and/or modify this document under the terms of the BSD
230 License.
231
233 Sebastian Dröge <slomo@debian.org>
234 Original author
235 David Bryant <david@wavpack.com>
237 Updates
238
240 Copyright © 2005 Sebastian Dröge
241 Copyright © 2022 David Bryant
242WavPack 5.6.0 2022-11-23 WAVPACK(1)