// $Id: readme.txt 104 2007-02-07 22:24:45Z cjk32 $
// Copyright 2007 Christopher Key (cjk32@cam.ac.uk)

--------
Overview
--------

EAC2iTunes is a script to simplify the process of using EAC to import tracks 
into iTunes.  The intention is to combine the simplicity of tagging in iTunes 
with the superior ripping technology in EAC.



-----
Usage
-----

A CD to be ripped is inserted, and iTunes opened.  The user then uses iTunes to 
download track information from the CDDB, and modifies this is as required.  

Once tagging is complete, EAC2iTunes is then run.  This will intially prompt for 
album artwork, before running EAC in auto extract mode.  This can can either be 
left to extract all tracks automatically, or interrupted and specific tracks 
manually selected.  When EAC is closed after extraction, EAC2iTunes will analyse 
the logfile to locate the extracted tracks.  These will then be imported into 
iTunes and converted to the default format.  The imported tracks will be tagged 
with the information that was downloaded / entered for the inserted CD.  
Optionally, EAC2iTunes will also add a line to the track comments detailing any 
EAC import errors.



-------------
Configuration
-------------

iTunes requires no specific configuration.

EAC should be configured not to use an external compressor (EAC -> Compression 
Options -> External Compressor -> Use external program for compression), and to 
write a logfile for the extraction operation (EAC -> EAC Options -> Tools -> 
Automatically write status report after extraction).

When EAC2iTunes is run for the first time, it will require some initial 
configuration.

1)  The full path to the EAC.exe executable.
2)  The folder where EAC writes ripped tracks and log files.
3)  Optionally, a folder where EAC2iTunes should write an extraction summary for 
each CD.
4)  Whether EAC2iTunes should add version information to the track comments.
5)  Whether EAC2iTunes should add read error information to the track comments.
6)  Whether EAC2iTunes should delete the WAV files after importing them into 
iTunes.


The configuration file is stored in C:\Windows\EAC2iTunes.txt, and can be 
manually edited.  Deletion will force EAC2iTunes to go through the configuration 
process again.