1WVUNPACK(1) WavPack Executable Programs WVUNPACK(1)
2
3
4
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
26 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
32 OUTPUT FILE FORMATS
33 • Microsoft RIFF, extension “.wav”, force with -w or --wav, creates
34 RF64 if > 4 GB
35
36 • Sony Wave64, extension “.w64”, force with --w64
37
38 • Apple Core Audio, extension “.caf”, force with --caf-be or --caf-le
39
40 • Raw PCM or DSD, extension “.raw”, force with -r or --raw
41
42 • Philips DSDIFF, extension “.dff”, force with --dsdiff or --dff
43
44 • Sony DSD Stream, extension “.dsf”, force with --dsf
45
47 -b
48 blindly decode all stream blocks and ignore length info
49
50 -c
51 do not decode audio but instead just extract cuesheet stored in
52 APEv2 tag to stdout (equivalent to -x “cuesheet”)
53
54 -cc
55 extract cuesheet stored in APEv2 tag to source-name.cue file in
56 same directory as decoded audio file (equivalent to -xx
57 “cuesheet=%a.cue”)
58
59 --caf-be, --caf-le
60 force output to big-endian or little-endian Core Audio, extension
61 “.caf”
62
63 -d
64 delete source file if successful (use with caution!)
65
66 --dff, --dsdiff
67 force output to Philips DSDIFF, DSD audio source only, extension
68 “.dff”
69
70 --dsf
71 force output to Sony DSF, DSD audio source only, extension “.dsf”
72
73 -f
74 do not decode audio but simply display summary information about
75 WavPack file to stdout in a machine-parsable format (see
76 doc/wavpack_doc.html or cli/wvunpack.c in repository for format
77 details)
78
79 --help
80 display extended help
81
82 -i
83 ignore .wvc file (forces hybrid lossy decompression)
84
85 -m
86 calculate and display MD5 signature; verify if lossless
87
88 -n
89 no audio decoding (use with -xx to extract tags only)
90
91 --normalize-floats
92 normalize float audio to +/-1.0 if it isn't already (rarely the
93 case, but alters audio and fails MD5)
94
95 --no-utf8-convert
96 leave extracted text tags in UTF-8 encoding during extraction or
97 display
98
99 -o OUTFILE
100 specify output filename (only if single source file) or target
101 directory (must exist)
102
103 -q
104 quiet (keep console output to a minimum)
105
106 -r, --raw
107 force raw PCM or DSD audio decode by skipping headers & trailers,
108 results in source-name.raw
109
110 --raw-pcm
111 similar to -r and --raw above except that DSD audio will be
112 converted to 24-bit PCM (8x decimation)
113
114 -s
115 do not decode audio but simply display summary information about
116 WavPack file to stdout
117
118 -ss
119 do not decode audio but simply display summary and tag information
120 about WavPack file to stdout
121
122 --skip=[-][sample|hh:mm:ss.ss]
123 start decoding at specified sample or time index, specifying a -
124 causes sample/time to be relative to EOF
125
126 -t
127 copy input file's time stamp to output file(s)
128
129 --until=[+|-][sample|hh:mm:ss.ss]
130 stop decoding at specified sample or time index, specifying a +
131 causes sample/time to be relative to --skip point, specifying a -
132 causes sample/time to be relative to EOF
133
134 -v
135 verify source data only (no output file created)
136
137 -vv
138 quick verify (no output, version 5+ files only)
139
140 --version
141 write program version to stdout
142
143 -w, --wav
144 force output to Microsoft RIFF/RF64, extension “.wav”
145
146 --w64
147 force output to Sony Wave64, extension “.w64”
148
149 -x “Field”
150 do not decode audio but instead just extract the specified tag
151 field to stdout
152
153 -xx “Field[=file]”
154 extract the specified tag field to named file in same directory as
155 decoded audio file; optional filename specification may contain %a
156 which is replaced with the audio file base name, %t replaced with
157 the tag field name (note: comes from data for binary tags) and %e
158 replaced with the extension from the binary tag source file (or
159 “txt” for text tag).
160
161 -y
162 yes to overwrite warning (use with caution!)
163
164 -z[n]
165 don't set (n = 0 or omitted) or set (n = 1) console title to
166 indicate progress (leaves "WvUnpack Completed")
167
169 wavpack(1), wvgain(1), wvtag(1)
170
171 Please visit www.wavpack.com for more information
172
174 This manual page was written by Sebastian Dröge <slomo@debian.org> and
175 David Bryant <david@wavpack.com>. Permission is granted to copy,
176 distribute and/or modify this document under the terms of the BSD
177 License.
178
180 Sebastian Dröge <slomo@debian.org>
181 Original author
182
183 David Bryant <david@wavpack.com>
184 Updates
185
187 Copyright © 2005 Sebastian Dröge
188 Copyright © 2022 David Bryant
189
190
191
192WavPack 5.5.0 2022-06-23 WVUNPACK(1)