README

REACT 2.0 Final - EAC plugin

REACT 2.0 is not backward compatible with version 1.0. This version is more powerful, easier to use and configure. It uses only two configuration scripts: REACT-image.cfg, and REACT-track.cfg. Image mode (F10) is recommended, as it may be used for creating both an image and tracks, and is a little more robust. With Nyaochi's excellent ACDIR, it will split the image to tracks while encoding. You can pick and choose from which formats you want by only editing a few characters in the .cfg file. See examples below.

NEWS

Simpler user-configuration, located in the REACT.ini file (Alt-F2).
Only one configuration file for each mode (image/track).
Built-in support for CoverDownloader (albumart.exe). Runs when hitting F10/F4. Alt-F10 for CoverDownloader only.
Adds cover pictures to FLAC (with 1.1.3) and MP3 by using my new tool, metamp3.exe
Optionally scans and tags ReplayGain for all formats. May also apply album gain on MP3/AAC files.
Writes ID3v2.3 ReplayGain tags on MP3's (Winamp/Foobar compatible), via metamp3.exe
Adds iTunesEncode support.
Adds WaveGain support and --scale support for MP3 and OGG.
Adds support for writing albumgain values to cuesheet as REM lines.
Should fix random REACT exiting, reported by some users.
User may now minimize EAC while ripping (EAC will auto-restore when ripping done, and save log).
Accepts both "Various" and "Various Artists" as compilation disk.
If CreateAllCuesheets=1 is set in INI file, and EAC is set up to extract to a fixed directory, REACT will save all types of cuesheets when hitting F4/F10. Cuesheets can be accessed from scripts by @albumfile@ variable. E.g. "@albumfile@.[mg].cue"
The (unsafe) @islast@ variable for track mode is not supported anymore. Use @track@==@numtracks@ test instead, or image mode.

FEATURES

The wiki has more info : http://wiki.hydrogenaudio.org/index.php?title=REACT

Three new sections are added to the REACT.ini file: [UserTrackFormats], [UserOutputNames], and [UserSettings]. The user may edit these, but also add new variable=value pairs. These will be accesible in the .cfg scripts as @variable@ and will be substituted to value when executed. This makes it possible to place all configuration settings in the REACT.ini file, and leave the more complicated DOS-scripting code in the .cfg files. The regular user will therefore only need to modify the REACT.ini files.

INSTALL

Make sure to install in a new directory, or remove any old version of REACT before installing.

Tools included:

acdir.exe	http://nyaochi.sakura.ne.jp/xoops/modules/mydownloads/singlefile.php?cid=1&lid=2
Glob.exe	http://www.codeproject.com/file/fileglob.asp (example program modified by me)
flac.exe	http://flac.sourceforge.net (1.1.3)
metaflac.exe	http://flac.sourceforge.net
wavpack.exe	http://www.wavpack.com (4.40)
wvgain.exe	http://www.wavpack.com
lame.exe	http://www.rarewares.org/mp3.html (3.97)
metamp3.exe	Created by me. Uses sources from mp3gain, and encspotconsole, and id3lib.
iTunesEncode.exe	http://www.hydrogenaudio.org/forums/index.php?showtopic=35242
albumart.exe	http://www.hydrogenaudio.org/forums/index.php?showtopic=43429
aacgain.exe	http://www.rarewares.org/aac.html
AtomicParsley.exe	http://atomicparsley.sourceforge.net
WaveGain.exe	http://www.rarewares.org/others.html

Download the following tools for full functionality (nero aac and vorbis):

neroAacEnc.exe	http://www.nero.com/nerodigital/eng/Nero_Digital_Audio.html
oggenc2.exe	http://homepage3.nifty.com/blacksword
vorbisgain.exe	http://www.rarewares.org/ogg.html

EXAMPLES

1) Create FLAC tracks, and MP3 tracks, no image.

Press Alt-F2 to edit the REACT.ini file. Set the line in the [Settings] section:
   ImageExt=wav

and set the following lines in the [UserTrackFormats] section, and hit F10:
   Flac=1
   Wavpack=0
   LameMP3=1
   NeroAac=0
iTunesAac=0
   OggEnc2=0

Alternatively, hit F4 (track ripping), but be aware of possible shortcomings in track mode post-processing (RG-scanning, picture embedding).

2) Create a WAVPACK image, and Nero AAC tracks.

Press Alt-F2 to edit the REACT.ini file. Set the line in the [Settings] section:
   ImageExt=wv

and set the following lines in the [UserTrackFormats] section, and hit F10:
   Flac=0
   Wavpack=0
   LameMP3=0
   NeroAac=1
iTunesAac=0
   OggEnc2=0

You may set all these variables independently. Additional configuration is at the top part of the .cfg script.

CREDITS

Thanks to Andre Wiethoff for creating EAC (http://www.exactaudiocopy.de).
Thanks to all developers of the other free tools used by REACT.
Thanks to Synthetic Soul (http://www.synthetic-soul.co.uk) for creating the wiki help and all support for REACT in the hydrogenaudio forums.
Thanks to everyone else who have given feedback to make REACT better.

Tycho, 11th Dec 2006.