Difference between revisions of "WavPack"

From Hydrogenaudio Knowledgebase
Jump to: navigation, search
(More 5.5.0 updates)
(hybrid encoding clarification; more on AIFF; the -t switch for WavPack too.)
Line 76: Line 76:
 
The basic ''encoding'' usage is <tt>wavpack filename.extension</tt> (which creates <tt>filename.wv</tt>) &ndash; this is what drag and drop accomplishes.  Wildcards are supported, e.g <tt>wavpack *.wav</tt>.  For a single input file, one can specify output like e.g. <tt>wavpack infilename.wav -o outfilename.wv</tt> (on Windows, the <tt>-o</tt> can be omitted).  Input file extension ".wav" can be dropped, and output ".wv" extension as well &ndash; but <tt>wavpack foo</tt> will only find foo.wav, not e.g. foo.w64.   
 
The basic ''encoding'' usage is <tt>wavpack filename.extension</tt> (which creates <tt>filename.wv</tt>) &ndash; this is what drag and drop accomplishes.  Wildcards are supported, e.g <tt>wavpack *.wav</tt>.  For a single input file, one can specify output like e.g. <tt>wavpack infilename.wav -o outfilename.wv</tt> (on Windows, the <tt>-o</tt> can be omitted).  Input file extension ".wav" can be dropped, and output ".wv" extension as well &ndash; but <tt>wavpack foo</tt> will only find foo.wav, not e.g. foo.w64.   
  
The basic ''decoding'' usage &ndash; as will be accomplished by drag and drop &ndash; is <tt>wvunpack filename.wv</tt>.  By default, wvunpack will restore the exact same file (metadata and file structure and all), with suffix as appropriate: filename.wav / filename.w64 / filename.caf.  (Though WavPack then knows the original input format, it does not store the original file name.) If only audio was encoded (from a player, pipe or using <tt>-r</tt>), output defaults to filename.wav.  
+
The basic ''decoding'' usage &ndash; as will be accomplished by drag and drop &ndash; is <tt>wvunpack filename.wv</tt>.  By default, wvunpack will restore the exact same file (metadata and file structure and all), with suffix as appropriate: filename.wav / filename.w64 / filename.caf.  (Though WavPack then knows the original input format, it does not store the original file name &ndash; but timestamp can be stored by using <tt>-t</tt>.) If only audio was encoded (from a player, pipe or using <tt>-r</tt>), output defaults to filename.wav.  
 
Just like for the wavpack encoder, file extensions can be dropped; e.g., using <tt>wvunpack foo bar</tt> will decode foo.wv to bar.wav/bar.w64/bar.caf, extension chosen from original format. This can be overridden by assigning an output fileextension &ndash; e.g. bar.w64 will write a Wave64 file regardless of input format.  
 
Just like for the wavpack encoder, file extensions can be dropped; e.g., using <tt>wvunpack foo bar</tt> will decode foo.wv to bar.wav/bar.w64/bar.caf, extension chosen from original format. This can be overridden by assigning an output fileextension &ndash; e.g. bar.w64 will write a Wave64 file regardless of input format.  
  
Line 97: Line 97:
 
* <tt>--import-id3</tt> will import ID3v2.3 tags (currently not v2.4) present in the source file &ndash; typically in Sony DSF files &ndash; and convert them to WavPack's preferred APE tags.  (It will still keep the chunk for restoring the original file.)  By default, this is limited to 1 MB; for more, use <tt>--allow-huge-tags</tt>.  Same option works in wvtag.
 
* <tt>--import-id3</tt> will import ID3v2.3 tags (currently not v2.4) present in the source file &ndash; typically in Sony DSF files &ndash; and convert them to WavPack's preferred APE tags.  (It will still keep the chunk for restoring the original file.)  By default, this is limited to 1 MB; for more, use <tt>--allow-huge-tags</tt>.  Same option works in wvtag.
 
* <tt>-r</tt>: remove extra (non-audio) chunks.  By default, WavPack will store these in the .wv file for later bit-by-bit restoration of everything, not only the audio. Use <tt>-r</tt> to throw them away &ndash; like encoding through most players appear to do.  
 
* <tt>-r</tt>: remove extra (non-audio) chunks.  By default, WavPack will store these in the .wv file for later bit-by-bit restoration of everything, not only the audio. Use <tt>-r</tt> to throw them away &ndash; like encoding through most players appear to do.  
 +
* <tt>-t</tt>: copy input file's time stamp.  (To restore the file with the original time stamp, use <tt>-t</tt> both when encoding and when decoding.)
 
* <tt>--pause</tt>: (Windows only!) waits for keypress at the end.  Useful for reading output before exit when calling wavpack/wvunpack in a separate window (which both drag-and-drop the Windows front-end do).
 
* <tt>--pause</tt>: (Windows only!) waits for keypress at the end.  Useful for reading output before exit when calling wavpack/wvunpack in a separate window (which both drag-and-drop the Windows front-end do).
 
* <tt>-y</tt>: "yes" to everything.  Use with caution, will overwrite.  From 5.5.0 there is also a <tt>--no-overwrite</tt> that will skip instead of asking to overwrite.
 
* <tt>-y</tt>: "yes" to everything.  Use with caution, will overwrite.  From 5.5.0 there is also a <tt>--no-overwrite</tt> that will skip instead of asking to overwrite.
Line 105: Line 106:
 
WavPack can recompress .wv files in place (using a temporary file until done).  For example, <tt>wavpack -hx4mvy wavpackfile.wv</tt> will recompress wavpackfile.wv the file in high mode using <tt>-x4</tt> extra processing, write audio MD5 to it, open the temp file and re-read for verification &ndash; and once verified, replace the old wavpackfile.wv. Tags will be transferred.  <tt>wavpack -hx4rlmvy wavpackfile.wv</tt> will also run with low priority (assuming the Windows platform), and will discard non-audio chunks &ndash; that is, the ones used to restore the original file's metadata; the .wv file's APE tags will still be copied.  As an example, one can compress an ID3v2.4-tagged DSF file by drag and drop; WavPack will then store the tag chunk, but WavPack cannot import v2.4.  Then open both in Mp3tag, copy the ID3v2.4 tags to the WavPack file, decide that there is no need to restore the original file's ID3v2.4 upon any unpacking, and apply the <tt>wavpack -hx4rlmvy wavpackfile.wv</tt> command; it will then discard that chunk (but keep the tags that Mp3tag wrote!), recompress using high (silently ignoring the -x4 that has no effect on DSD) with low priority, write an MD5 sum, verify the process and replace the .wv file by the new recompressed file.  
 
WavPack can recompress .wv files in place (using a temporary file until done).  For example, <tt>wavpack -hx4mvy wavpackfile.wv</tt> will recompress wavpackfile.wv the file in high mode using <tt>-x4</tt> extra processing, write audio MD5 to it, open the temp file and re-read for verification &ndash; and once verified, replace the old wavpackfile.wv. Tags will be transferred.  <tt>wavpack -hx4rlmvy wavpackfile.wv</tt> will also run with low priority (assuming the Windows platform), and will discard non-audio chunks &ndash; that is, the ones used to restore the original file's metadata; the .wv file's APE tags will still be copied.  As an example, one can compress an ID3v2.4-tagged DSF file by drag and drop; WavPack will then store the tag chunk, but WavPack cannot import v2.4.  Then open both in Mp3tag, copy the ID3v2.4 tags to the WavPack file, decide that there is no need to restore the original file's ID3v2.4 upon any unpacking, and apply the <tt>wavpack -hx4rlmvy wavpackfile.wv</tt> command; it will then discard that chunk (but keep the tags that Mp3tag wrote!), recompress using high (silently ignoring the -x4 that has no effect on DSD) with low priority, write an MD5 sum, verify the process and replace the .wv file by the new recompressed file.  
  
=== (Incomplete:) hybrid encoding ===
+
=== (Incomplete:) hybrid lossless & lossy encoding ===
(... by someone who knows the details.  DSD can currently not be hybrid-encoded and floating-point files should not be.)  
+
(Needs to be expanded. Notes: DSD can currently not be hybrid-encoded and floating-point files should not be.  The correction file will be omitted by a lot of applications/players, including ffmpeg; thus, using ffmpeg or ffmpeg-based players to convert/play hybrid-encoded WavPack will be lossy.)
 +
 
 
Basic use: the <tt>-b</tt> switch &ndash; and for losslessness, with <tt>-c</tt> to create a correction file. The <tt>b</tt> takes a numerical value signifying ''bits per sample'' if < 24 and ''kbit/second'' if 24 to 9600. E.g. <tt>-b12.5</tt> (no space in between, with . even if your locale uses comma for decimal point).
 
Basic use: the <tt>-b</tt> switch &ndash; and for losslessness, with <tt>-c</tt> to create a correction file. The <tt>b</tt> takes a numerical value signifying ''bits per sample'' if < 24 and ''kbit/second'' if 24 to 9600. E.g. <tt>-b12.5</tt> (no space in between, with . even if your locale uses comma for decimal point).
 
<tt>wavpack -b234.56 -c filename</tt> will create filename.wv file and correction file filename.wvc.  As long as both are present, playback and decoding (by <tt>wvunpack filename</tt> the ordinary way) will be lossless.
 
<tt>wavpack -b234.56 -c filename</tt> will create filename.wv file and correction file filename.wvc.  As long as both are present, playback and decoding (by <tt>wvunpack filename</tt> the ordinary way) will be lossless.
Line 113: Line 115:
  
 
WavPack will refuse to recompress lossy-generated .wv to "lossless .wv" as that would make a false pretense of being a lossless file.  It will also refuse so even in the presence of .wvc; you will have to wvunpack it and and then wavpack it again.  
 
WavPack will refuse to recompress lossy-generated .wv to "lossless .wv" as that would make a false pretense of being a lossless file.  It will also refuse so even in the presence of .wvc; you will have to wvunpack it and and then wavpack it again.  
 +
  
 
=== (Incomplete:) decoding options ===
 
=== (Incomplete:) decoding options ===
Line 143: Line 146:
 
FFmpeg can encode/decode to/from WavPack, with some limitations.  FFmpeg can decode WavPack 5 files, but will only write WavPack 4 (thus, no ''fast verification'').  Also, compression presets are different, defaulting to fast but not particularly good compression.<ref>[https://hydrogenaud.io/index.php?topic=118278.msg976262#msg976262  HA forum comment comparing the compression presets]</ref> On the other end, FFmpeg offers even slower modes than <tt>-hhx6</tt>.
 
FFmpeg can encode/decode to/from WavPack, with some limitations.  FFmpeg can decode WavPack 5 files, but will only write WavPack 4 (thus, no ''fast verification'').  Also, compression presets are different, defaulting to fast but not particularly good compression.<ref>[https://hydrogenaud.io/index.php?topic=118278.msg976262#msg976262  HA forum comment comparing the compression presets]</ref> On the other end, FFmpeg offers even slower modes than <tt>-hhx6</tt>.
  
There is potential information loss in using ffmpeg; for example, RIFF metadata (or AIFF) will be lost, and WAVE/AIFF output will default to 16-bits (potentially lossy) &ndash; anything else must be specified.  
+
There is potential information loss in using FFmpeg; it will ignore hybrid correction files, so decoding/playing hybrid-encoded WavPack with ffmpeg or ffmpeg-based players will be lossy.  Furthermore, ffmpeg will default to 16 bits when outputting WAVE/AIFF, whether or not the input file is 16 bits; to unpack a 24-bit .wv to WAVE/AIFF, 24-bit output must be specified.  (For AIFF by way of CAF, see below.)  
 +
Also, RIFF metadata will be lost (or AIFF metadata &ndash; which WavPack cannot store in any case).
  
 
=== From/to AIFF &ndash; preserving bit depth ===
 
=== From/to AIFF &ndash; preserving bit depth ===
Reference WavPack will encode a 20-bit (or 17, for that matter) .wav file and keep the information that it is 20 (/17) bits.  FFmpeg on the other hand, will be upconverted to 24 bit .wv, deleting the information that it was ever 20 (/17) bits. As reference WavPack cannot handle .aiff (but handles .caf), the following procedure can be used on bit depths not divisible by 8:
+
Reference WavPack will encode a 20-bit (or 17, for that matter) .wav file and keep the information that it is 20 (/17) bits.  FFmpeg on the other hand, will delete the information that it was ever 20 (/17) bits. Also, FFmpeg will by default produce 16-bits WAVE/AIFF files, and additional specification must be applied to ensure lossless decoding of 24-bit files; safest is to use wvunpack to decode, but reference WavPack cannot handle .aiff. It does handle .caf, so the following procedure and preserve bit depth, divisible by 8 or not:  
* To decode .wv to AIFF and preserve bit depth: <tt>wvunpack "infile.wv" --caf-be - | ffmpeg -i - -codec copy "outfile.aiff"</tt>
+
* To decode .wv to AIFF and preserve bit depth: <tt>wvunpack "infile.wv" --caf-be - | ffmpeg -i - -codec copy "outfile.aiff"</tt>.
 
* To encode AIFF, possibly with bit depths like 17 preserved: There are AIFF to WAVE conversion software that will preserve bit depth flags (here ffmpeg doesn't), but presuming a a lossless audio user has flac.exe around:  <tt> flac --fast --lax "aiff infile.aiff" -o - | flac -d - -o - | wavpack - "wavpack outfile.wv" </tt> will do a flac encode/decode provided bit depth is 4 to 24.  
 
* To encode AIFF, possibly with bit depths like 17 preserved: There are AIFF to WAVE conversion software that will preserve bit depth flags (here ffmpeg doesn't), but presuming a a lossless audio user has flac.exe around:  <tt> flac --fast --lax "aiff infile.aiff" -o - | flac -d - -o - | wavpack - "wavpack outfile.wv" </tt> will do a flac encode/decode provided bit depth is 4 to 24.  
  
Line 153: Line 157:
  
 
=== Splitting WavPack files by cuesheet ===
 
=== Splitting WavPack files by cuesheet ===
wvunpack cannot split WavPack files by neither embedded nor external cuesheet, but some external applications can (and will have to decode/re-encode):  [[CUETools]] can if it is CDDA (44.1 kHz 16-bit stereo), and can re-encode back to WavPack.  refalac can decode split by cuesheets with the appropriate DLL files<ref>[https://github.com/nu774/qaac/wiki/refalac-usage refalac usage] includes how to split by cuesheet</ref>, outputting WAVE or ALAC-in-MP4.
+
wvunpack cannot split WavPack files by neither embedded nor external cuesheet, but some external applications can (and will have to decode/re-encode):  [[CUETools]] can if it is CDDA (44.1 kHz 16-bit stereo), and can re-encode back to WavPack.  refalac can decode & split by cuesheets with the appropriate WavPack library DLL file<ref>[https://github.com/nu774/qaac/wiki/refalac-usage refalac usage] includes how to split by cuesheet</ref>, outputting WAVE or ALAC-in-MP4.
  
  

Revision as of 13:00, 20 July 2022

WavPack
Official WavPack logo

Hybrid Lossless Audio Compression
Developer(s) David Bryant
Release information
Initial release {{{released}}}
Stable release 5.5.0 (2022-07-07)
Preview release None
Compatibility
Operating system Windows, MacOSX, Linux/BSD/Unix, ...
Additional information
Use Encoder/Decoder
License BSD license
Website http://www.wavpack.com/

WavPack (pronounced "wave-pack") is a lossless audio codec, also offering optionally a hybrid lossless/lossy mode. It is distributed as a free open-source encoder/decoder with a library and a large number of tools, including a Windows GUI and a range of plugins for both audio players and other software. Third party implementations are available, including ffmpeg. WavPack supports and/or can be played back on a large number of platforms/OSes including mobile (Android, iOS), portable (Rockbox) and even web apps.

WavPack is arguably the most feature-rich lossless compressor, supporting a unique range of audio signals including Direct-Stream Digital. While many special features might require the user to apply the WavPack executable directly (which may be achieved with drag+drop, see the Using WavPack section below), everyday use is supported by a wide range of players and taggers.

Performance-wise, WavPack defaults to a fast codec – compressing around FLAC's default size, albeit not decoding as ultra-light. The user might fine-tune performance through a wide range of options, but all will decode faster than the high-compression Monkey's Audio/OptimFROG codecs. There is only one codec (TAK) which is able to outperform WavPack on both compression and encoding speed and decoding speed simultaneously.[1]

WavPack has inspired other codecs[2] and their features[3]. For more on WavPack, including on its history and technology, see the Wikipedia entry.


Features

For an end-user considering WavPack as a an audio format, its feature-richness might be the big selling point. WavPack supports pretty much all the more common features noted at HA Wiki's Lossless Codec Comparison as in the following first list, but several users might consider the more unique features listed under the subsequent headline.

  • Seekable and streaming playback.
  • Error handling: upon playback, it will detect and report corrupted frames, mute to protect against static/noise output, and continue playback. Since version 5, WavPack can also check for corruption without decoding, hence quicker than any decoding format. Optional MD5 audio checksum can also be added upon encoding for file fingerprinting.
  • High-resolution audio support (see next headline)
  • Multichannel support: currently capped at 256 channels, supports WAVEFORMATEXTENSIBLE channel masks.
  • Piping support for encoding, and support for RAW PCM input/output.
  • RIFF chunks supported for recreating also non-audio chunks of the original files; by default, WavPack will restore to a file bit-identical to the original.
  • Tagging: APEv2. (ID3v1 is possible, but not advisable.)
  • Cuesheet support. In practice, some applications handle embedded cuesheets better in WavPack than in some other formats.
  • Unicode support.
  • Can be used in the Matroska container.
  • Windows GUI available.

WavPack also handles bit depths not divisible by 8, and is known to employ a "wasted bits" strategy: For, say, a 20 bit signal in a 24 bit container, WavPack will detect that bits 21 to 24 are "wasted" and compressed as 20-bits without size penalty.

Special/unique features

Most of these features are shared with only a few if any notable codecs, or extend to signal types or file types others do not support (comparisons given).

  • DSD support: can losslessly compress Philips DSDIFF and Sony DSF files (see "Using WavPack" below); can import ID3v2.3 tags from DSF. (No other end-user codec compresses DSD.)
  • High-resolution support for bit depth 1-bit to 32-bit integer and sampling rates up to 2 GiHz in integer steps. (Officially, 1 GHz is supported – it is gigaherz, not MHz, the upper limit being in the UHF radio frequency band. Monkey's Audio, OptimFROG and MPEG-4 ALS support the entire WAVE range up to 4 GiHz.)
  • 32-bit floating-point supported – also including CoolEdit/Adobe Audition's 32-bit float format (use the -a option only if the .wav was generated by CoolEdit/Audition). (This line like OptimFROG.)
  • As much as 256 channels currently supported (version 5.5.0; can be extended to the thousands – for even more, MPEG-4 ALS supports 66536.)
  • Hybrid lossy/lossless mode (can also be used as lossy). (Like OptimFROG.)
  • Can in addition to PCM in WAVE files also read and output to RF64, Sony's Wave64, and CAF (including > 4 GB files and both endianness CAF – the latter apparently unique among lossless formats). Also, WavPack will upon decoding recreate any (standards-compliant) file bit by bit including non-audio parts, to whatever input format it supports. (Monkey's/OptimFROG/TAK do the same to the input formats they support.)
  • Recompression: Can recompress .wv files in place, with tag transfer. (Like FLAC on .flac files.)
  • Drag and drop support: Dropping a file on to wavpack.exe/wvunpack.exe will encode/decode it to source directory. (Like FLAC.) From 5.5.0, one can also apply options to drag and drop by renaming the executable, and drop several files.

Limitations

The following limitations are certainly not unique to WavPack. None seem to be able to force WAVE version (though some can force RF64), only FLAC can force decoding to AIFF (big-endian only) and only Monkey's support AIFF with full file structure restore (big-endian only) or the legacy AU/SND format.

  • Despite being available for several platforms, PCM in AIFF is currently not supported. (See below for workarounds.)
  • Although output can be forced to various filetypes, there seems not to be an easy way to force output to a given version of the WAVE format, nor to force RF64 if less than 4 GiB output.
  • DSD: Will reject DST-compressed DSD (which are already compressed heavier than WavPack does); can currently not import ID3v2.4, only ID3v2.3 (use Mp3tag to copy tags).

As of version 5.4.0, some features are discontinued. XP support is officially dropped (though an "unofficial" build is available[4] – otherwise, 5.3.0 released April 2020 supports XP), version 5 does no longer offer compression to Windows .sfx self-extracting file (cf. OptimFROG) nor the -p feature. Furthermore, WavPack version 3.x files are no longer supported. To recompress these files (if any are still around, WavPack 4 was released in 2004) to WavPack 5 files (for the fast decoding-free error checking feature), one must first recompress by WavPack 4.80 (still available) or lower, and then by WavPack 5.

As of July 2022, WavPack for MacOS through HomeBrew is still at version 5.4.0.

WavPack has traditionally had less hardware support than FLAC (Rockbox having been the most notable platform, others listed at https://www.wavpack.com/index.html#Hardware ), but with WavPack playback through Android and iOS players, the distinction between "hardware" and "software" is arguably blurred.


Using WavPack

WavPack files can be played back in supported players (see below), and several of these can encode to WavPack. However, there are situations where certain WavPack features are accessible only through the WavPack executables directly. For example, you cannot count on RIFF support by encoding through players which often deliver only the audio to the encoder – and you cannot count on such players to restore non-audio data faithfully. Also, the input format might exceed the player's internal decoding; e.g. trying to convert 32-bit integer or DSD with foobar2000 will yield a warning that it will not be lossless (also, converting DSD to PCM leads to files many times the size).

Unlike most other codecs, WavPack has separate encoding and decoding executables (wavpack and wvunpack).

Drag and drop (Windows)

The simplest encoding/decoding might be dragging and dropping a (supported) file to wavpack.exe (/wvunpack.exe). Then the file will be encoded/decoded with the default options. Dropping a .wv file onto wavpack.exe will recompress it, prompting before overwrite (again, using default settings – possibly a bad deal if it was encoded with high -x switches). Also it works on a shortcut to the executable. It is not possible to drop a folder, but from version 5.5.0, there is a way to drag and drop several files.

From version 5.5.0, drag and drop supports options by renaming the executable. The user can make a copy of the executable, rename it according to preferred settings, and those settings will be applied to the process upon drag and drop. The example given by the developer in in this HA forum post[5] uses encoding options that many WavPack users will recommend (better compression, verification and MD5 fingerprinting), and novice users can choose to copy that filename for the executable. For fine-tuning performance or for more specialized tasks, one will however have to utilize some of the options described below.

Basic command line usage (for Windows: command-line hints here)

The basic encoding usage is wavpack filename.extension (which creates filename.wv) – this is what drag and drop accomplishes. Wildcards are supported, e.g wavpack *.wav. For a single input file, one can specify output like e.g. wavpack infilename.wav -o outfilename.wv (on Windows, the -o can be omitted). Input file extension ".wav" can be dropped, and output ".wv" extension as well – but wavpack foo will only find foo.wav, not e.g. foo.w64.

The basic decoding usage – as will be accomplished by drag and drop – is wvunpack filename.wv. By default, wvunpack will restore the exact same file (metadata and file structure and all), with suffix as appropriate: filename.wav / filename.w64 / filename.caf. (Though WavPack then knows the original input format, it does not store the original file name – but timestamp can be stored by using -t.) If only audio was encoded (from a player, pipe or using -r), output defaults to filename.wav. Just like for the wavpack encoder, file extensions can be dropped; e.g., using wvunpack foo bar will decode foo.wv to bar.wav/bar.w64/bar.caf, extension chosen from original format. This can be overridden by assigning an output fileextension – e.g. bar.w64 will write a Wave64 file regardless of input format.

Several input files

Wildcards are supported, like wavpack *.wav. To give several filenames as input to wavpack/wvunpack, there are slight differences between the Windows version and the *n*xes: Windows (requires WavPack 5.5.0): use the --drop option as in the above example given by the developer. It is intended for drag and drop (hence the name of the option) and will write the output to same directory as source. However it can also be used with command-line: wavpack --drop firstfile secondfile will compress firstfile.wav to firstfile.wv and secondfile.wav to secondfile.wv. Note that without the --drop, the command wavpack firstfile secondfile will compress firstfile.wav to secondfile.wv, as -o is optional on Windows – indeed that is why the --drop had to be introduced. An arbitrary number of files can be processed, e.g. wvunpack --drop firstfile secondfile thirdfile fourthfile fifthfile will decode firstfile.wv, ..., fifthfile.wv. For *n*x, one can omit the --drop, and it also works with older WavPack versions.

Applying options

For tuning performance or other settings, one might want to apply command-line options. Some external applications can apply options without the user having to type – e.g. encoding with foobar2000, there are two compression sliders, one for the fast-to-extra-high and one for the -x settings (see below) – but in the Windows GUI one will want to type them in. Options can be concatenated for short, like for example writing -hh -x2 -m -v -y as -hhx2mvy.

The user should beware that the wavpack encoder and the wvunpack decoder (and wvtag/wvgain) have to "re-use letters" for different purposes, and e.g. -b, -c do not have related functions upon decoding as upon encoding. However some do the same in the wvunpack and wavpack (like -d for delete input file, -y for "yes to all" and -l for "run with low priority" (Windows only)) – and others cover the same purpose in both executables (like -m and -v).

Encoding options (lossless)

Encoding using -hxm seems a sensible trade-off between compression and CPU load. The manual (online, or included as wavpack_doc.html in the distribution) gives an exhaustive reference, and the following is merely a selection.

  • Compression. WavPack has four compression modes that affect compression as well as encoding and decoding time: fast (-f), default, high (-h) and very high (-hh). The CPU load of -hh is measured to around twice that of -f (and could in the early 2000s be too heavy for portable players, although it does decode faster than any Monkey's). On top these modes, the optional extra processing -x1 to -x6 settings will apply extra compression effort that does not increase decoding CPU load. -x without number is synonymous to -x1, which is often recommended (in all modes, fast/normal/high/extra high). The official manual calls -x4 to -x6 "extremely slow", but the size gains might be significant for high resolution audio in particular (van Beurden's revision 5, testing -x4).

With DSD files, there are only two compression settings, normal and high; the option -f will select normal, -h/-hh will both select high, and the -x switches are silently ignored. 5.5.0 introduces optional switches for the default compression: -g for normal mode and -x0 for "no -x". These are redundant for basic use, but can be used to switch off options already given (e.g. in renamed executables, or custom builds): -x6 -x0 will switch off the extra processing, and -h -f -g will encode as normal, whereas previous versions would abort with an error.

  • Guarding against errors upon encoding: The "-m" switch will compute an audio MD5 sum (like FLAC does by default) and store it for later verification. The "-v" switch will verify by decoding the file after encoding and writing the file to disk[6]. -vm will do both – that is, calculate the MD5s to verify, and store it. (Using the corresponding switches in wvunpack will check without producing output file, however wvunpack also has a faster corruption check switch -vv for WavPack 5-encoded files.)
  • --import-id3 will import ID3v2.3 tags (currently not v2.4) present in the source file – typically in Sony DSF files – and convert them to WavPack's preferred APE tags. (It will still keep the chunk for restoring the original file.) By default, this is limited to 1 MB; for more, use --allow-huge-tags. Same option works in wvtag.
  • -r: remove extra (non-audio) chunks. By default, WavPack will store these in the .wv file for later bit-by-bit restoration of everything, not only the audio. Use -r to throw them away – like encoding through most players appear to do.
  • -t: copy input file's time stamp. (To restore the file with the original time stamp, use -t both when encoding and when decoding.)
  • --pause: (Windows only!) waits for keypress at the end. Useful for reading output before exit when calling wavpack/wvunpack in a separate window (which both drag-and-drop the Windows front-end do).
  • -y: "yes" to everything. Use with caution, will overwrite. From 5.5.0 there is also a --no-overwrite that will skip instead of asking to overwrite.
  • -d: delete source file upon successful completion. Again, use with caution.
  • -l will force WavPack to run at low priority (Windows only)
  • -c with -b to select lossy quality: hybrid lossless/lossy use, see below.

WavPack can recompress .wv files in place (using a temporary file until done). For example, wavpack -hx4mvy wavpackfile.wv will recompress wavpackfile.wv the file in high mode using -x4 extra processing, write audio MD5 to it, open the temp file and re-read for verification – and once verified, replace the old wavpackfile.wv. Tags will be transferred. wavpack -hx4rlmvy wavpackfile.wv will also run with low priority (assuming the Windows platform), and will discard non-audio chunks – that is, the ones used to restore the original file's metadata; the .wv file's APE tags will still be copied. As an example, one can compress an ID3v2.4-tagged DSF file by drag and drop; WavPack will then store the tag chunk, but WavPack cannot import v2.4. Then open both in Mp3tag, copy the ID3v2.4 tags to the WavPack file, decide that there is no need to restore the original file's ID3v2.4 upon any unpacking, and apply the wavpack -hx4rlmvy wavpackfile.wv command; it will then discard that chunk (but keep the tags that Mp3tag wrote!), recompress using high (silently ignoring the -x4 that has no effect on DSD) with low priority, write an MD5 sum, verify the process and replace the .wv file by the new recompressed file.

(Incomplete:) hybrid lossless & lossy encoding

(Needs to be expanded. Notes: DSD can currently not be hybrid-encoded and floating-point files should not be. The correction file will be omitted by a lot of applications/players, including ffmpeg; thus, using ffmpeg or ffmpeg-based players to convert/play hybrid-encoded WavPack will be lossy.)

Basic use: the -b switch – and for losslessness, with -c to create a correction file. The b takes a numerical value signifying bits per sample if < 24 and kbit/second if 24 to 9600. E.g. -b12.5 (no space in between, with . even if your locale uses comma for decimal point). wavpack -b234.56 -c filename will create filename.wv file and correction file filename.wvc. As long as both are present, playback and decoding (by wvunpack filename the ordinary way) will be lossless. The file filename.wv – which is at most 234.56 kbit/s – can be copied to a different location and played back stand-alone as a lossy compressed file. The same will happen if the .wvc file is deleted or not found (it has to be same path/filename except with the ".wvc" suffix in place of ".wv") – or equivalently, if the -c is omitted during encoding, then no correction file will be created in the first place. For example: wavpack -b13.5 -hx filename will create a lossy filename.wv compressed with the -hx option, size constrained to 13.5 bits per sample. (Should 13.5 bits be sufficient for lossless encoding, WavPack will tell you at the end of the encoding process – but that information is not stored in the file.)

WavPack will refuse to recompress lossy-generated .wv to "lossless .wv" as that would make a false pretense of being a lossless file. It will also refuse so even in the presence of .wvc; you will have to wvunpack it and and then wavpack it again.


(Incomplete:) decoding options

In addition to the basic usage above (drag and drop or wvunpack filename.wv or wvunpack infilename.wv -o outfilename_possibly_with_desired_suffix_to_override_input_filetype.caf), the wvunpack executable offers several options. For use with the Windows front-end or drag and drop, the Windows-only --pause (waits for keypress at the end, like for wavpack.exe) is essential to read the output report. Also Windows-only options like --drop and -l work as for wavpack.exe, and so do -d (use with caution!) and -y (ditto!).

Many of the options are arguably for power users, like for example:

  • -b: "blindly" decode until end (potentially useful if a .wv file is corrupted)
  • -t: copy input file's time stamp to output file(s)
  • switches to force output file format: --wav, --w64, --caf-be, --caf-le, --raw
  • some switches to perform lossy operations on floating-point files, DSD streams or dropping hybrid-encoded correction files. See the documentation.
  • --skip and/or --until: only decode a portion of the file (again, see documentation)

wvunpack is also the utility to display information from .wv files even when it does not involve decoding, see the next section.

Other file handling

{stub-subsections, incomplete}

Error checking and other file info

wvunpack can get information about WavPack files without decoding to file:

  • -vv: Quick verify without decoding (WavPack 5 files only). This functionality seems to be unavailable outside the official wvunpack (other applications which verify will fall back to the next item, -v):
  • -v: Verify (will decode to check that everything is OK – but not write any file).
  • -s/-ss: -s displays summary of the file, -ss a long summary including tags
  • -x FIELD: Shows tag, e.g. -x comment shows the <comment> field. Also wvtag -x does the same thing.
  • -c: Like -x cuesheet. Also wvtag -c does the same thing.

(To fill in:) Tagging (wvtag) and replaygain management (wvgain)

(... most of these options are available in HA's fave taggers/player?)

Using 3rd party tools; FFmpeg's WavPack encoder/decoder, and others

FFmpeg can encode/decode to/from WavPack, with some limitations. FFmpeg can decode WavPack 5 files, but will only write WavPack 4 (thus, no fast verification). Also, compression presets are different, defaulting to fast but not particularly good compression.[7] On the other end, FFmpeg offers even slower modes than -hhx6.

There is potential information loss in using FFmpeg; it will ignore hybrid correction files, so decoding/playing hybrid-encoded WavPack with ffmpeg or ffmpeg-based players will be lossy. Furthermore, ffmpeg will default to 16 bits when outputting WAVE/AIFF, whether or not the input file is 16 bits; to unpack a 24-bit .wv to WAVE/AIFF, 24-bit output must be specified. (For AIFF by way of CAF, see below.) Also, RIFF metadata will be lost (or AIFF metadata – which WavPack cannot store in any case).

From/to AIFF – preserving bit depth

Reference WavPack will encode a 20-bit (or 17, for that matter) .wav file and keep the information that it is 20 (/17) bits. FFmpeg on the other hand, will delete the information that it was ever 20 (/17) bits. Also, FFmpeg will by default produce 16-bits WAVE/AIFF files, and additional specification must be applied to ensure lossless decoding of 24-bit files; safest is to use wvunpack to decode, but reference WavPack cannot handle .aiff. It does handle .caf, so the following procedure and preserve bit depth, divisible by 8 or not:

  • To decode .wv to AIFF and preserve bit depth: wvunpack "infile.wv" --caf-be - | ffmpeg -i - -codec copy "outfile.aiff".
  • To encode AIFF, possibly with bit depths like 17 preserved: There are AIFF to WAVE conversion software that will preserve bit depth flags (here ffmpeg doesn't), but presuming a a lossless audio user has flac.exe around: flac --fast --lax "aiff infile.aiff" -o - | flac -d - -o - | wavpack - "wavpack outfile.wv" will do a flac encode/decode provided bit depth is 4 to 24.

(One limitation of ffmpeg is that RIFF chunks will be discarded – but for AIFF that is not an issue anyway, as WavPack cannot store AIFF metadata.)

Splitting WavPack files by cuesheet

wvunpack cannot split WavPack files by neither embedded nor external cuesheet, but some external applications can (and will have to decode/re-encode): CUETools can if it is CDDA (44.1 kHz 16-bit stereo), and can re-encode back to WavPack. refalac can decode & split by cuesheets with the appropriate WavPack library DLL file[8], outputting WAVE or ALAC-in-MP4.


Software support

With Android support and playback through ffmpeg, it might no longer be feasible to maintain a list of applications that can play WavPack files, and the following is most certainly incomplete – as is the list at https://www.wavpack.com/#Software .

Players

  • foobar2000 advanced freeware audio player plays/decodes WavPack out of the box on both Windows, MacOS, Android and iOS (Windows: supports encoding if wavpack.exe is installed, and redistributes the official wavpack.exe through its "Free encoder pack" addon for encoding. With ReplayGain & cuesheets support.) Also Boom from the same author.
  • VLC multiplatform media player
  • VUPlayer (official plugin, supports encoding)
  • NullSoft Winamp (plugin with ReplayGain & Media Library support) and Winamp-compatible players
  • Windows Media Player and other directshow-based players (MPC, TCMP, RadLight) (with CoreWavPack directshow filter)
  • Cog Audio player for MacOS X.
  • JRiver Media Center
  • XMMS (with Kuniklo's plugin)
  • LAMIP (official plugin)
  • MPXplay for DOS!
  • Aqualung for GNU/Linux
  • Cowon JetAudio Player and CD ripper
  • XMPlay Plugin required (WavPack input plugin) and (bass library) to play 'wv' files

Converters, CD rippers etc.

Several of the players, like Cowon JetAudio, foobar2000 and VUplayer, also have converters that can create WavPack files. More:

Taggers

Other tools

It's worth mentioning the Matroska guys decided to concentrate on WavPack as the lossless compressor of choice for their container. Quite an honor... :-)

  • PKWare's .zip format compresses audio by WavPack since version 6.3.2 (2007). Beware that there is no expectation that other decompression software handles these zip files; even if PKWare co-designed the format and PKZip was the original .zip implementation, their subsequent compression methods are outside the ISO/IEC standardized zip format specification.


Links

  1. Martijn van Beurden: Lossless audio codec comparison archive, all comparisons in this wiki article consistent with CDDA results from revision 5, 2022, using WavPack 5.4.0.
  2. Monkey's Audio FAQ (archived on October 17, 2000)
  3. OptimFROG's "DualStream" hybrid encoding
  4. XP-compatible 5.4.0 build posted at the HA forum
  5. HA forum post on how to rename executable for drag and drop
  6. HA forum comment: verification checks the written file after closing and reopening
  7. HA forum comment comparing the compression presets
  8. refalac usage includes how to split by cuesheet
  9. HA Wiki: Configuring EAC and WavPack