Changes:

Beta 2 => Beta 3:

1. Build with the "official" mlpdec.c module (revision 14206).
2. User manual added.

Beta 1 => Beta 2:

1. Build with Qt v4.4 library.
2. "Select All" tracks option added.
3. Audio watermark detection utility added.

Alpha "Final" => Beta 1:

1. Stereo downmix extraction supported.
2. "Recover from stream errors" option added.
3. Threads syncronization bug fixed.

Alpha 12 => Alpha "Final":

1. Major sync search fixed.
2. "Output directory" file dialog changed.
3. Drag & Drop support for "Open DVD-Audio zone" action.

Alpha 11 => Alpha 12:

1. Various UI improvements.
2. "Wait threshold" option added.
3. MLP decoding module (mlpdec.c) replaced.

Alpha 10 => Alpha 11:

1. "Run program" option added.

Alpha 9 => Alpha 10:

1. Bug in extraction of 16 bit MLP tracks fixed.
2. New wave format added.
3. Channel remapping when "Mergre groups" option checked.

Alpha 8 => Alpha 9:

1. Multiplatform, open source project.
2. MLP decoder has been moved into the main code.

since Alpha 7:

1. Indexed tracks supported.
2. Multiple tracks extraction.
3. Extraction from protected media with libdvdcpxm library.
4. MLP stream decoding with mlpdec module (part of FFmpeg project).


How To:

To run external program on extracted files enter command line in "Run program" edit box.
Select appropriate value for "Wait threshold". Extraction process will wait until difference
in sizes between extracted and processed files drops below threshold. Use smaller values when
short of free space.
Check "Delete files" to remove extracted files after exit from external program.
Command line substitution:
%path%       - file path without file name
%filepath%   - file name with path
%filename%   - file name without file path
%filebase%   - file name without extensions
%ext%        - file extension
%channels%   - total number of channels in file
%samplerate% - sample rate for group 1
%bits%       - bits in sample for group 1

Use 4C12bit utility to check presence of audio watermark.
This software contains part of CyberLink PowerDVD v7, you should have licence to run.
For more detailed information about 4C 12 Bit watermark see http://www.4centity.com/data/tech/4cspec.pdf
command line: 4C12bit -i <wavfile> [-l <logfile>] [-t <seconds>]
where
<wavfile> - input file (wave format only)
<logfile> - redirect console output to this file
<seconds> - restart detector every s-th second (float format)


Examples:

1. To encode files with flac:   flac -f %filepath%
2. To encode files with ffmpeg: ffmpeg -i %filepath% -y %path%/%filebase%.flac
3. To check audio watermarks:   4C12bit -i %filepath% -l %path%/%filebase%.log


Caveats:

1. When converting MLP tracks check DVDAExplorer.log file for messages from mlpdec.
   If there is something like "[24] Lossless check failed - expected XX, calculated YY"
   then extracted track should contain glitches.
2. Stereo downmix extraction is available for tracks with 2 substreams only, where the first
   substream is the downmix.
3. Use "Recover from stream errors" option for inconvertible tracks.


Known Issues:

1. Track 09 on The Alan Parsons Project "The Turn of a Friendly Card" disc cannot
   be properly extracted due to MLP decoder error: "FIR and IIR filters must use same precision".
2. Track 10 on The Alan Parsons Project "The Turn of a Friendly Card" disc is one block shorter
   than declared in ATS_01_0.IFO.
3. Track 02 on Grateful Dead "American Beauty" disc disc cannot
   be properly extracted due to MLP decoder error: "Restart header sync incorrect (got 0x133a)".