flac-113.bat was written to allow users to convert their FLAC archive
from previous versions of FLAC to the latest version.  The script was
written when 1.1.3 was released, thus the name, but can be used for any
version of FLAC.

The script uses FLAC.EXE to re-encode files, and follows the following
approximate path:

  1. If FlacGetV is present, check the FLAC version of the file.
  2. If older, use -t to test the FLAC file's integrity.
  3. If passed, encode the FILE to a new file, "<name>-flac-113.flac".
  4. If encoding was successful, move the new file over the source.

The script will accept three methods of input:

  1. A folder path.
     Drag a folder onto the batch file, or call the script using the
     syntax:

     flac-113.bat "C:\path\to\folder"

     and the script will process all FLAC files in that folder, and
     any subfolders.

  2. A FLAC file.
     Drag a FLAC file onto the batch file, or call the script using
     the syntax:

     flac-113.bat "C:\path\to\file.flac"

     and the script will process only that FLAC file.


  3. A TXT list of FLAC files.
     Drag a TXT file, containing a list of FLAC files (one file per
     line), onto the batch file, or call the script using the syntax:

     flac-113.bat "C:\path\to\list.txt"

     and the script will process all FLAC files in the list.

Before using the script you should open it in a text editor and ensure
that it is configured as you would like.  The configuration can be
found near the top of the file:

REM ######################################################
SET pathToFLAC="FLAC.EXE"
SET flacOptions=-8
SET retainListOfFailedFiles=1
SET retainListOfProcessedFiles=0
SET retainListOfSuccessfulFiles=0
SET flacVersion=114
REM ######################################################

pathToFLAC
The full path to FLAC.EXE.  Double quotes are required if the path
contains spaces.

flacOptions
The encoding options to use.  -V is hard-coded into the command line
already, so is not required again.  The value should be set just as it
would be on the command line, except the use of brackets, which should
be enclosed in double quotes (otherwise the script will attempt to
parse them).  E.g.:

SET flacOptions=-8 -A "tukey(0.25)" -A "gauss(0.1875)" -b 4096

retainListOfFailedFiles
If set to 1 the list of failed files that is displayed at the end of
the process will be saved as a text file in the same folder as the
script.

retainListOfProcessedFiles
If set to 1 the list of all processed files will be saved as a text
file in the same folder as the script.

retainListOfSuccessfulFiles
If set to 1 the list of all successfully converted files will be
saved as a text file in the same folder as the script.

flacVersion
If you have FlacGetV (and its supporting files) in the same folder as
the script it will be used to check the current version of the FLAC
file being processed against flacVersion.  If they are equal the file
will be skipped.  Therefore, if you are converting to 1.1.4, set
flacVersion to 114 to skip all files already encoded using FLAC 1.1.4.

FlacGetV was written by gharriss999 and can be downloaded from the
following thread on Hydrogen Audio:

http://www.hydrogenaudio.org/forums/index.php?showtopic=51084

If FlacGetV is not present the value of flaVersion is irrelevant, and
all files will be re-converted irrespective of their current version.


Discussion of this script can be found in the following thread on
Hydrogen Audio:

http://www.hydrogenaudio.org/forums/index.php?showtopic=50993


-- 
Synthetic Soul, 5th March 2007.