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 varients
28 · WavPack, extension “.wv”, trancode operation, tags copied
30 · Apple Core Audio, extension “.caf”
32 · Sony Wave64, extension “.w64”
34 · Philips DSDIFF, extension “.dff”
36 · Sony DSD Stream, extension “.dsf”
38
40 -a
41 Adobe Audition (CoolEdit) mode for 32-bit floats
42 --allow-huge-tags
44 allow tag data up to 16 MB (embedding > 1 MB is not recommended for
45 portable devices and may not work with some programs including
46 WavPack pre-4.70)
47 -bn
49 enable hybrid compression, n = 2.0 to 23.9 bits/sample, or n =
50 24-9600 kbits/second (kbps), not available with DSD audio
51 --blocksize=n
53 specify block size in samples (max = 131072 and min = 16 with
54 --merge-blocks, otherwise 128)
55 -c
57 create correction file (.wvc) for hybrid mode (results in 2-file
58 lossless compression)
59 -cc
61 maximum hybrid compression (hurts lossy quality & decode speed)
62 --channel-order=list
64 specify (comma separated) channel order if not Microsoft standard
65 (which is
66 FL,FR,FC,LFE,BL,BR,FLC,FRC,BC,SL,SR,TC,TFL,TFC,TFR,TBL,TBC,TBR);
67 specify “...” to indicate that channels are not assigned to
68 specific speakers, or terminate list with “...” to indicate that
69 any channels beyond those specified are unassigned
70 --cross-decorr
72 use cross-channel correlation in hybrid mode (on by default in
73 lossless mode and with -cc option)
74 -d
76 delete source file if successful (use with caution!)
77 -f
79 fast mode (fast, but some compromise in compression ratio)
80 -h
82 high quality (better compression ratio, but slower encode and
83 decode than default mode)
84 -hh
86 very high quality (best compression, but slowest and NOT
87 recommended for use on portable playback devices)
88 --help
90 display extended help
91 -i
93 ignore length in wav header (no pipe output allowed)
94 --import-id3
96 import applicable tag items from ID3v2.3 tag present in DSF (and
97 other) files into APEv2 tag (if there are > 1 MB cover images
98 present add --allow-huge-tags to include them, and -r if you do not
99 want large images appearing twice in the WavPack file, although
100 this will remove the entire original ID3v2 tag)
101 -jn
103 joint-stereo override (0 = left/right, 1 = mid/side)
104 -m
106 compute & store MD5 signature of raw audio data
107 --merge-blocks
109 merge consecutive blocks with equal redundancy (used with
110 --blocksize option and is useful for files generated by the
111 lossyWAV program or decoded HDCD files)
112 -n
114 calculate average and peak quantization noise (hybrid only,
115 reference fullscale sine)
116 --no-utf8-convert
118 don't recode passed tags from local encoding to UTF-8, assume they
119 are in UTF-8 already
120 -o OUTFILE
122 specify output filename (only if single source file) or target
123 directory (must exist)
124 --pair-unassigned-chans
126 encode unassigned channels into stereo pairs
127 --pre-quantize=bits
129 pre-quantize samples to bits depth BEFORE encoding and MD5
130 calculation (common use would be --pre-quantize=20 for 24-bit or
131 float material recorded with typical converters)
132 -q
134 quiet (keep console output to a minimum)
135 -r
137 remove file headers (file-appropriate headers will be regenerated
138 during unpacking)
139 --raw-pcm
141 input data is raw pcm (44,100 Hz, 16-bit, 2-channels)
142 --raw-pcm=sr,bits[f|s|u],chans,[le|be]
144 input data is raw pcm with specified sample-rate, bit-depth
145 (float,unsigned,signed), number of channels, and endianness
146 (defaulted parameters may be omitted, specify bits=1 for DSD)
147 --raw-pcm-skip=begin[,end]
149 skip begin bytes before encoding raw PCM (header) and skip end
150 bytes at the EOF (trailer)
151 -sn
153 override default hybrid mode noise shaping where n is a float value
154 between -1.0 and 1.0; negative values move noise lower in freq,
155 positive values move noise higher in freq, use 0 for no shaping
156 (white noise)
157 -t
159 copy input file's time stamp to output file(s)
160 --use-dns
162 force use of dynamic noise shaping (hybrid mode only)
163 -v
165 verify output file integrity after write (not for piped output)
166 --version
168 write program version to stdout
169 -w Encoder
171 write actual encoder metadata to APEv2 tag (e.g., “Encoder=WavPack
172 5.0.0”)
173 -w Settings
175 write actual user settings metadata to APEv2 tag (e.g.,
176 “Settings=-hb384cx3”)
177 -w “Field=Value”
179 write specified text metadata to APEv2 tag
180 -w “Field=@file.ext”
182 write specified text metadata from file to APEv2 tag, normally used
183 for embedded cuesheets and logs (field names “Cuesheet” and “Log”)
184 --write-binary-tag “Field=@file.ext”
186 write the specified binary metadata file to APEv2 tag, normally
187 used for cover art with the specified field name “Cover Art
188 (Front)”
189 -x[n]
191 extra encode processing (optional n = 1 to 6, 1=default), -x1 to
192 -x3 to choose best of predefined filters, -x4 to -x6 to generate
193 custom filters (very slow!)
194 -y
196 yes to all warnings (use with caution!)
197 -z[n]
199 don't set (n = 0 or omitted) or set (n = 1) console title to
200 indicate progress (leaves "WavPack Completed")
201
203 wvunpack(1), wvgain(1), wvtag(1)
204 Please visit www.wavpack.com for more information
206
208 This manual page was written by Sebastian Dröge <slomo@debian.org> and
209 David Bryant <david@wavpack.com>. Permission is granted to copy,
210 distribute and/or modify this document under the terms of the BSD
211 License.
212
214 Sebastian Dröge <slomo@debian.org>
215 Original author
216 David Bryant <david@wavpack.com>
218 Updates
219
221 Copyright © 2005 Sebastian Dröge
222 Copyright © 2021 David Bryant
223WavPack 5.4.0 2021-01-10 WAVPACK(1)