1WVUNPACK(1) WavPack Executable Programs WVUNPACK(1)
2
6 wvunpack - decodes wavpack encoded files
7
9 wvunpack [-options] INFILE... [-o OUTFILE]
10
12 wvunpack decodes WavPack files back to their original uncompressed form
13 using the options provided. Unless overridden with the -o switch, the
14 output filename will be identical to the source filename but with the
15 original file extension replacing WavPack's “.wv” extension. It is also
16 possible to output raw audio without headers (see --raw option).
17 Multiple WavPack input files may be specified resulting in multiple
18 output files, and in that case -o may be used to specify an alternate
19 target directory. Stdin and stdout may be specified with “-”. It is
20 also possible to export to one of the alternate file formats listed
21 below, but in that case the information in the original headers and
22 trailers will be lost (even if the alternate format is the same as the
23 source format). WavPack files are generally created with the wavpack
24 program.
25 If multiple input files are specified with piped output (“-o -”), then
27 the output from all the files is concatenated. This can be utilized as
28 an easy way to concatenate WavPack files (assuming the output is
29 subsequently piped into wavpack), but only makes sense with raw output
30 (--raw) to avoid headers being interleaved with the audio data.
31 OUTPUT FILE FORMATS
33 • Microsoft RIFF, extension “.wav”, force with -w or --wav, creates
34 RF64 if > 4 GB
35 • Sony Wave64, extension “.w64”, force with --w64
37 • Apple AIFF, extension “.aif”, force with --aif or --aif-le
39 • Apple Core Audio, extension “.caf”, force with --caf-be or --caf-le
41 • Raw PCM or DSD, extension “.raw”, force with -r or --raw
43 • Philips DSDIFF, extension “.dff”, force with --dsdiff or --dff
45 • Sony DSD Stream, extension “.dsf”, force with --dsf
47
49 --aif, --aif-le
50 force output to Apple AIFF (or AIFF-C/sowt), extension “.aif”
51 -b
53 blindly decode all stream blocks and ignore length info
54 -c
56 do not decode audio but instead just extract cuesheet stored in
57 APEv2 tag to stdout (equivalent to -x “cuesheet”)
58 -cc
60 extract cuesheet stored in APEv2 tag to source-name.cue file in
61 same directory as decoded audio file (equivalent to -xx
62 “cuesheet=%a.cue”)
63 --caf-be, --caf-le
65 force output to big-endian or little-endian Core Audio, extension
66 “.caf”
67 -d
69 delete source file if successful (use with caution!)
70 --dff, --dsdiff
72 force output to Philips DSDIFF, DSD audio source only, extension
73 “.dff”
74 --dsf
76 force output to Sony DSF, DSD audio source only, extension “.dsf”
77 -f
79 do not decode audio but simply display summary information about
80 WavPack file to stdout in a machine-parsable format (see
81 doc/wavpack_doc.html or cli/wvunpack.c in repository for format
82 details)
83 --help
85 display extended help
86 -i
88 ignore .wvc file (forces hybrid lossy decompression)
89 -m
91 calculate and display MD5 signature; verify if lossless
92 -n
94 no audio decoding (use with -xx to extract tags only)
95 --normalize-floats
97 normalize float audio to +/-1.0 if it isn't already (rarely the
98 case, but alters audio and fails MD5)
99 --no-utf8-convert
101 leave extracted text tags in UTF-8 encoding during extraction or
102 display
103 -o OUTFILE
105 specify output filename (only if single source file) or target
106 directory (must exist)
107 -q
109 quiet (keep console output to a minimum)
110 -r, --raw
112 force raw PCM or DSD audio decode by skipping headers & trailers,
113 results in source-name.raw
114 --raw-pcm
116 similar to -r and --raw above except that DSD audio will be
117 converted to 24-bit PCM (8x decimation)
118 -s
120 do not decode audio but simply display summary information about
121 WavPack file to stdout
122 -ss
124 do not decode audio but simply display summary and tag information
125 about WavPack file to stdout
126 --skip=[-][sample|hh:mm:ss.ss]
128 start decoding at specified sample or time index, specifying a -
129 causes sample/time to be relative to EOF
130 -t
132 copy input file's time stamp to output file(s)
133 --until=[+|-][sample|hh:mm:ss.ss]
135 stop decoding at specified sample or time index, specifying a +
136 causes sample/time to be relative to --skip point, specifying a -
137 causes sample/time to be relative to EOF
138 -v
140 verify source data only (no output file created)
141 -vv
143 quick verify (no output, version 5+ files only)
144 --version
146 write program version to stdout
147 -w, --wav
149 force output to Microsoft RIFF/RF64, extension “.wav”
150 --w64
152 force output to Sony Wave64, extension “.w64”
153 -x “Field”
155 do not decode audio but instead just extract the specified tag
156 field to stdout
157 -xx “Field[=file]”
159 extract the specified tag field to named file in same directory as
160 decoded audio file; optional filename specification may contain %a
161 which is replaced with the audio file base name, %t replaced with
162 the tag field name (note: comes from data for binary tags) and %e
163 replaced with the extension from the binary tag source file (or
164 “txt” for text tag).
165 -y
167 yes to overwrite warning (use with caution!)
168 -z[n]
170 don't set (n = 0 or omitted) or set (n = 1) console title to
171 indicate progress (leaves "WvUnpack Completed")
172
174 wavpack(1), wvgain(1), wvtag(1)
175 Please visit www.wavpack.com for more information
177
179 This manual page was written by Sebastian Dröge <slomo@debian.org> and
180 David Bryant <david@wavpack.com>. Permission is granted to copy,
181 distribute and/or modify this document under the terms of the BSD
182 License.
183
185 Sebastian Dröge <slomo@debian.org>
186 Original author
187 David Bryant <david@wavpack.com>
189 Updates
190
192 Copyright © 2005 Sebastian Dröge
193 Copyright © 2022 David Bryant
194WavPack 5.6.0 2022-11-16 WVUNPACK(1)