1WVUNPACK(1)               WavPack Executable Programs              WVUNPACK(1)
2
3
4

NAME

6       wvunpack - decodes wavpack encoded files
7

SYNOPSIS

9       wvunpack [-options] INFILE... [-o OUTFILE]
10

DESCRIPTION

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

OPTIONS

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

SEE ALSO

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

AUTHORS

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)
Impressum