Hydrogenaudio Knowledgebase - User contributions [en]

REACT

2006-12-11T19:19:08Z

Tycho:

REACT ('''R'''un '''EAC''' '''T'''asks) can be used in conjunction with [[Exact Audio Copy]] (EAC), as an external compressor.

It is, however, not an encoder, but an interim application that provides a scripting facility to call muliple encoders or pre-/post-encoding applications to process the [[WAV|WAVE]] files created by [[Exact Audio Copy|EAC]], or the files created by the script itself. '''In short''', REACT allows you to run multiple tasks on the audio extracted, instead of only one.

REACT integrates with [[Exact Audio Copy]], adding some hotkeys combinations to access often used functions more quickly. It will also alter the default name for image files according to your INI settings, and close the extraction dialogue in order for the logfile to be created and used from within your script. It can auto-configure [[Exact Audio Copy|EAC]], updating the external compression options so that [[Exact Audio Copy|EAC]] is ready to run REACT immediately. This feature is extremely useful for novice users.

REACT is configured using an INI file and config files. The commands used within the config files are command line/DOS commands, with the addition of numerous variables which REACT makes available. For example, any instance of '''@artist@''' in the script will be replaced by the [[freedb]] artist name, while '''$artist$''' will be replaced with a ''filename-friendly'' version of the artist name (with illegal characters replaced according to your requirements).

'''From REACT v2.0 Final, most configuration can be done by editing the INI file only'''. Only advanced users should edit the .cfg files.

==Hotkeys==

REACT adds a few useful hotkeys to EAC:
{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Key || Function
|-
| F1 || Wiki page for EAC.
|-
| Alt-F1 || Wiki page for REACT (this page).
|-
| Ctrl-F2 || Configure EAC to be used with REACT.
|-
| Alt-F2 || Edit REACT.ini in notepad.
|-
| Alt-F3 || Edit REACT-image.cfg in notepad.
|-
| F4 || Activates Shift-F5 in EAC (Copy selected tracks - Compressed). Optionally, it also starts CoverDownloader\albumart. You may edit REACT.ini and set TracksHotVal=+{F6} if you want to do Test & Copy instead of Copy only. If the INI key CreateAllCuesheets=1, all four cuesheet types are saved as different files as well.
|-
| F10 || Shortcut to menu "Action - Copy Image and Save CUE Sheet - Compressed...". REACT will fill in the image name, as defined in the ImageNaming INI key (template). REACT will also close the Save Wavform dialog automatically if you have configured EAC to extract to a fixed directory.
|-
|}

==Configuration Files==

There are three configuration files in total; The INI file, one CFG file for copying to audio track files, and one for copying to an audio image with cuesheet. The config files are stored in the REACT folder, and are named:

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| File || Description
|-
| REACT.ini || Regular INI file with key=values pairs. Defines variables used by the CFG files.
|-
| REACT-tracks.cfg || - Used for "Copy Selected Tracks Compressed", default shortcut : F4
|-
| REACT-image.cfg || - Used for "Copy Image & Create CUE Sheet Compressed", default shortcut : F10
|-
|}

==The REACT.INI File==
There are four sections in the REACT.ini file. The first [Settings] section has global definitions that REACT uses. The next three [User...] sections have keys that are simply passed through to the .cfg configurations files. I.e. any KEY=VALUE defines a variable @KEY@ which gets expanded to VALUE in the .cfg files.

Note that you may add arbitrary keys to the [User...] sections, and they will expand to their values when used as variables in the .cfg files.

===Settings Section===

The first section in the INI file sets some global keys, which can be used in any or all encoder configs. These variables refer to high level settings, like the path to [[Exact Audio Copy|EAC]], rather than encoder-specific settings. Here is an example:
<pre>
[Settings]
Version=2.0
ImageExt=flac
ImageNaming=$artist$ - [$year$] $album$
ImageHotKey={F10}
TracksHotKey={F4}
TracksHotVal=+{F5}
VA=Various Artists
CreateAllCuesheets=0
RunCoverDownloader=1
CoverDownloader=C:\Program Files\REACT2\coverdownloader\albumart.exe
EAC=C:\Program Files\Exact Audio Copy\EAC.exe
MinimizeCompressionWindow=1
ProcessPriority=1
Sla_Bks_Col_Qst_Bar_Quo_Ast_Lt_Gt=-|-|-||!|'|#|[|]
</pre>

Some of the keys are obvious, and some you really don't need to bother with unless you are a REACT Ninja, but here's a few to watch out for:

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| ImageExt || Copy Image mode only (F10). The format extension for the compressed image file + cuefile. E.g. flac, wv, or mp3. Set to wav when no compressed image is desired.
|-
| ImageNaming || This variable detirmines how image files, and their cuesheets, will be named when REACT is used in copy image mode. Variables available are: $album$; $artist$; $year$; $genre$; and $freedb$. These are populated from the values of EAC's textboxes, and therefore do not strictly relate to the extended variables available within your config. '''Please note:''' Your scheme ''must'' begin "$artist$ -" in order for Various Artists discs to be recognised properly.
|-
| VA || Default set to 'Various Artists'. The variable @va@ holds this string. See @cdartist@ below for further details.
|-
| CreateAllCuesheets || If set to 1, all four availabe types of cuesheets will be saved to the extraction directory, which must be preconfigured in EAC. The cuesheet base name can be accessed using the @albumfile@ variable.
|-
| RunCoverDownloader || If set to 1, run the albumart.exe application. Simply double click the cover you want (select close after save in settings in albumart). In Copy Tracks mode, albumart will wait until it is closed before starting copying. You may set RunCoverDownloader=2 to make it wait in both modes, 3 to wait only in Image Copy mode, or 4 to never wait.
|-
| Sla_Bks_Col_Qst_Bar_Quo_Ast_Lt_Gt || Some characters cannot be used in file or folder names. This variable allows you to specify what these characters should be replaced with. Slash; Backslash; Colon; Question Mark; Bar (Pipe); Quotes; Asterisk; Less Than; Greater Than. It is also possible to convert Space to e.g. _ by appending a Bar and a _ (after the Gt convert character).
|}

===UserTrackFormat Section===
This section enables/disables output audio formats to be created.

===UserOutputNames Section===
Here the track names and the output paths are defined for the different output audio formats.

===UserSettings Section===
Set various variables for more detailed configuration.
{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| Debug || If you are having problems with your config file setup, set this value to 1. REACT will then pause before exiting, so you can examine the console output to attempt to determine where your process fell down.
|-
| Comment || Override the default @comment@ variable (taken from EAC)
|-
| EmbedCover || Select if you want your cover pictures embeded into the audio files, or only copied to the target directory as 'folder.jpg'.
|-
| ReplayGain || Enable/Disable ReplayGain calculation and tagging.
|-
| ApplyAlbumGain || Apply the album gain to the files, so they are played back with a consistent volume across the albums on every player.
|-
| AdjustAlbumGain_dB || If you want to adjust the album gain from 89.0 dB when applying to the audio, set adjustment in dB here.
|-
| AddCuesheetAG || Add Album gain/Album peak values to the cuesheet as REM lines. This implies that WaveGain is ran.
|-
| UseWaveGainAG || Instruct to use WaveGain to calculate AlbumGain values on the wav image file. The values will be transferred to the various compressed formats, rather than calculating them via other tools. If ApplyAlbumGain=1, LAME and OggEnc2 will use the --scale option to apply the album gain scale factor calculated by WaveGain.
|-
| Opt_... || Variables that defines options for each encoder used.
|-
| Ver_... || Variables that defines the version number for each encoder used.
|}

==Editing the CFG files (advanced)==
Because most of the configuration settings are moved to the INI file, it is seldom required to modify the .cfg files. Only advanced users that knows DOS scripting well should attempt to make significant changes. Following are the replacement variables available (excluding those defined in the [User...] sections of the INI file):

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| '''PATHS AND FILES''' ||
|-
| @reactdir@ || The path to the directory in which REACT resides
|-
| @tools@ || The path to the directory in which the encoders reside. Set within the INI file
|-
| @mymusic@ || The path to your 'My Music' folder
|-
| @sourcedir@ || The path to the folder in which the copied source files are located ([[WAV]]/LOG/CUE)
|-
| @basename@ || The name of the file being created, excluding folders and extension
|-
| @source@ || The path to the temporary source [[WAV|WAVE]] file
|-
| @image@ || The path to the final image file, when used in '''Copy Image''' mode
|-
| @imageext@ || The extension of the compressed target image, e.g. flac
|-
| @sourcecuesheet@ || The path to the (temporary) source [[Cuesheet|cuesheet]], when used in '''Copy Image''' mode
|-
| @cuesheet@ || The path to the final [[Cuesheet|cuesheet]], when used in '''Copy Image''' mode
|-
| @eaclog@ || The path to the log file created by [[Exact Audio Copy|EAC]]
|-
| @cover@ || The path to the cover/album art picture file, dowloaded with CoverDownloader.
|-
| @albumfile@ || The base path to the cuesheet files without extension, created when CreateAllCuesheets=1 in the INI file. E.g, "@albumfile@.[mg].cue" is the multiple wav files cuesheet with gaps.
|-
| ||
|-
| '''METADATA''' ||
|-
| @cdartist@ || The name of the CD artist. If @various@=1 @cdartist@ equals the variable @va@, otherwise @artist@. Use $cdartist$ in file paths
|-
| @artist@ || The name of the track artist. Use $artist$ in paths
|-
| @album@ || The name of the album. Use $album$ in paths
|-
| @title@ || The song title. Use $title$ in paths
|-
| @track@ || The track number. Use $track$ to zero-pad the track number, i.e.: turn 9 into 09
|-
| @numtracks@ || The total number of tracks. Use $numtracks$ to zero-pad the number
|-
| @genre@ || The album genre. Use $genre$ in paths
|-
| @year@ || The album year
|-
| @comment@ || The comment. Use $comment$ in paths
|-
| @freedbid@ || The [[freedb]] ID
|-
| ||
|-
| '''OTHER''' ||
|-
| @various@ || Is 1 if the EAC 'Various' checkbox was checked. Otherwise 0
|-
| @va@ || The name of VariousArtist. Default 'Various Artists'.
|-
| @crc@ || The [[CRC]] of the file
|-
| @bitrate@ || The value of the '''Bitrate''' dropdown on EAC's External Compressor dialogue
|-
| @curdate@ || The current date
|}

==Links==

Ask REACT questions in this thread : http://www.hydrogenaudio.org/forums/index.php?showtopic=35158

Download REACT from this thread : http://www.hydrogenaudio.org/forums/index.php?showtopic=36261

REACT

2006-12-11T14:28:28Z

Tycho:

'''This page is under construction.'''

REACT ('''R'''un '''EAC''' '''T'''asks) can be used in conjunction with [[Exact Audio Copy]] (EAC), as an external compressor.

It is, however, not an encoder, but an interim application that provides a scripting facility to call muliple encoders or pre-/post-encoding applications to process the [[WAV|WAVE]] files created by [[Exact Audio Copy|EAC]], or the files created by the script itself. '''In short''', REACT allows you to run multiple tasks on the audio extracted, instead of only one.

REACT integrates with [[Exact Audio Copy]], adding some hotkeys combinations to access often used functions more quickly. It will also alter the default name for image files according to your INI settings, and close the extraction dialogue in order for the logfile to be created and used from within your script. It can auto-configure [[Exact Audio Copy|EAC]], updating the external compression options so that [[Exact Audio Copy|EAC]] is ready to run REACT immediately. This feature is extremely useful for novice users.

REACT is configured using an INI file and config files. The commands used within the config files are command line/DOS commands, with the addition of numerous variables which REACT makes available. For example, any instance of '''@artist@''' in the script will be replaced by the [[freedb]] artist name, while '''$artist$''' will be replaced with a ''filename-friendly'' version of the artist name (with illegal characters replaced according to your requirements).

'''From REACT version 2.0 final, most configuration can be done by editing the INI file only'''. Only advanced users should edit the .cfg files.

==Hotkeys==

REACT adds a few useful hotkeys to EAC:
{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Key || Function
|-
| F1 || Wiki page for EAC.
|-
| Alt-F1 || Wiki page for REACT (this page).
|-
| Ctrl-F2 || Configure EAC to be used with REACT.
|-
| Alt-F2 || Edit REACT.ini in notepad.
|-
| Alt-F3 || Edit REACT-image.cfg in notepad.
|-
| F4 || Activates Shift-F5 in EAC (Copy selected tracks - Compressed). Optionally, it also starts CoverDownloader\albumart. You may edit REACT.ini and set TracksHotVal=+{F6} if you want to do Test & Copy instead of Copy only. If the INI key CreateAllCuesheets=1, all four cuesheet types are saved as different files as well.
|-
| F10 || Shortcut to menu "Action - Copy Image and Save CUE Sheet - Compressed...". REACT will fill in the image name, as defined in the ImageNaming INI key (template). REACT will also close the Save Wavform dialog automatically if you have configured EAC to extract to a fixed directory.
|-
|}

==Configuration Files==

There are three configuration files in total; The INI file, one CFG file for copying to audio track files, and one for copying to an audio image with cuesheet. The config files are stored in the REACT folder, and are named:

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| File || Description
|-
| REACT.ini || Regular INI file with key=values pairs. Defines variables used by the CFG files.
|-
| REACT-tracks.cfg || - Used for "Copy Selected Tracks Compressed", default shortcut : F4
|-
| REACT-image.cfg || - Used for "Copy Image & Create CUE Sheet Compressed", default shortcut : F10
|-
|}

==The REACT.INI File==
There are four sections in the REACT.ini file. The first [Settings] section has global definitions that REACT uses. The next three [User...] sections have keys that are simply passed through to the .cfg configurations files. I.e. any KEY=VALUE defines a variable @KEY@ which gets expanded to VALUE in the .cfg files.

Note that you may add arbitrary keys to the [User...] sections, and they will expand to their values when used as variables in the .cfg files.

===Settings Section===

The first section in the INI file sets some global keys, which can be used in any or all encoder configs. These variables refer to high level settings, like the path to [[Exact Audio Copy|EAC]], rather than encoder-specific settings. Here is an example:
<pre>
[Settings]
Version=2.0
ImageExt=flac
ImageNaming=$artist$ - [$year$] $album$
ImageHotKey={F10}
TracksHotKey={F4}
TracksHotVal=+{F5}
VA=Various Artists
CreateAllCuesheets=0
RunCoverDownloader=1
CoverDownloader=C:\Program Files\REACT2\coverdownloader\albumart.exe
EAC=C:\Program Files\Exact Audio Copy\EAC.exe
MinimizeCompressionWindow=1
ProcessPriority=1
Sla_Bks_Col_Qst_Bar_Quo_Ast_Lt_Gt=-|-|-||!|'|#|[|]
</pre>

Some of the keys are obvious, and some you really don't need to bother with unless you are a REACT Ninja, but here's a few to watch out for:

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| ImageExt || Copy Image mode only (F10). The format extension for the compressed image file + cuefile. E.g. flac, wv, or mp3. Set to wav when no compressed image is desired.
|-
| ImageNaming || This variable detirmines how image files, and their cuesheets, will be named when REACT is used in copy image mode. Variables available are: $album$; $artist$; $year$; $genre$; and $freedb$. These are populated from the values of EAC's textboxes, and therefore do not strictly relate to the extended variables available within your config. '''Please note:''' Your scheme ''must'' begin "$artist$ -" in order for Various Artists discs to be recognised properly.
|-
| VA || Default set to 'Various Artists'. The variable @va@ holds this string. See @cdartist@ below for further details.
|-
| CreateAllCuesheets || If set to 1, all four availabe types of cuesheets will be saved to the extraction directory, which must be preconfigured in EAC. The cuesheet base name can be accessed using the @albumfile@ variable.
|-
| RunCoverDownloader || If set to 1, run the albumart.exe application. Simply double click the cover you want (select close after save in settings in albumart). In Copy Tracks mode, albumart will wait until it is closed before starting copying. You may set RunCoverDownloader=2 to make it wait in both modes, 3 to wait only in Image Copy mode, or 4 to never wait.
|-
| Sla_Bks_Col_Qst_Bar_Quo_Ast_Lt_Gt || Some characters cannot be used in file or folder names. This variable allows you to specify what these characters should be replaced with. Slash; Backslash; Colon; Question Mark; Bar (Pipe); Quotes; Asterisk; Less Than; Greater Than. It is also possible to convert Space to e.g. _ by appending a Bar and a _ (after the Gt convert character).
|}

===UserTrackFormat Section===
This section enables/disables output audio formats to be created.

===UserOutputNames Section===
Here the track names and the output paths are defined for the different output audio formats.

===UserSettings Section===
Set various variables for more detailed configuration.
{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| Debug || If you are having problems with your config file setup, set this value to 1. REACT will then pause before exiting, so you can examine the console output to attempt to determine where your process fell down.
|-
| Comment || Override the default @comment@ variable (taken from EAC)
|-
| EmbedCover || Select if you want your cover pictures embeded into the audio files, or only copied to the target directory as 'folder.jpg'.
|-
| ReplayGain || Enable/Disable ReplayGain calculation and tagging.
|-
| ApplyAlbumGain || Apply the album gain to the files, so they are played back with a consistent volume across the albums on every player.
|-
| AdjustAlbumGain_dB || If you want to adjust the album gain from 89.0 dB when applying to the audio, set adjustment in dB here.
|-
| AddCuesheetAG || Add Album gain/Album peak values to the cuesheet as REM lines. This implies that WaveGain is ran.
|-
| UseWaveGainAG || Instruct to use WaveGain to calculate AlbumGain values on the wav image file. The values will be transferred to the various compressed formats, rather than calculating them via other tools. If ApplyAlbumGain=1, LAME and OggEnc2 will use the --scale option to apply the album gain scale factor calculated by WaveGain.
|-
| Opt_... || Variables that defines options for each encoder used.
|-
| Ver_... || Variables that defines the version number for each encoder used.
|}

==Modifying the CFG files (advanced)==

===Available Variables===

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| '''PATHS AND FILES''' ||
|-
| @reactdir@ || The path to the directory in which REACT resides
|-
| @tools@ || The path to the directory in which the encoders reside. Set within the INI file
|-
| @mymusic@ || The path to your 'My Music' folder
|-
| @sourcedir@ || The path to the folder in which the copied source files are located ([[WAV]]/LOG/CUE)
|-
| @basename@ || The name of the file being created, excluding folders and extension
|-
| @source@ || The path to the temporary source [[WAV|WAVE]] file
|-
| @image@ || The path to the final image file, when used in '''Copy Image''' mode
|-
| @imageext@ || The extension of the compressed target image, e.g. flac
|-
| @sourcecuesheet@ || The path to the (temporary) source [[Cuesheet|cuesheet]], when used in '''Copy Image''' mode
|-
| @cuesheet@ || The path to the final [[Cuesheet|cuesheet]], when used in '''Copy Image''' mode
|-
| @eaclog@ || The path to the log file created by [[Exact Audio Copy|EAC]]
|-
| @cover@ || The path to the cover/album art picture file, dowloaded with CoverDownloader.
|-
| @albumfile@ || The base path to the cuesheet files without extension, created when CreateAllCuesheets=1 in the INI file. E.g, "@albumfile@.[mg].cue" is the multiple wav files cuesheet with gaps.
|-
| ||
|-
| '''METADATA''' ||
|-
| @cdartist@ || The name of the CD artist. If @various@=1 @cdartist@ equals the variable @va@, otherwise @artist@. Use $cdartist$ in file paths
|-
| @artist@ || The name of the track artist. Use $artist$ in paths
|-
| @album@ || The name of the album. Use $album$ in paths
|-
| @title@ || The song title. Use $title$ in paths
|-
| @track@ || The track number. Use $track$ to zero-pad the track number, i.e.: turn 9 into 09
|-
| @numtracks@ || The total number of tracks. Use $numtracks$ to zero-pad the number
|-
| @genre@ || The album genre. Use $genre$ in paths
|-
| @year@ || The album year
|-
| @comment@ || The comment. Use $comment$ in paths
|-
| @freedbid@ || The [[freedb]] ID
|-
| ||
|-
| '''OTHER''' ||
|-
| @various@ || Is 1 if the EAC 'Various' checkbox was checked. Otherwise 0
|-
| @va@ || The name of VariousArtist. Default 'Various Artists'.
|-
| @crc@ || The [[CRC]] of the file
|-
| @bitrate@ || The value of the '''Bitrate''' dropdown on EAC's External Compressor dialogue
|-
| @curdate@ || The current date
|}

==Links==

Ask REACT questions in this thread : http://www.hydrogenaudio.org/forums/index.php?showtopic=35158

Download REACT from this thread : http://www.hydrogenaudio.org/forums/index.php?showtopic=36261

REACT

2006-12-11T14:17:36Z

Tycho:

'''This page is under construction.'''

REACT ('''R'''un '''EAC''' '''T'''asks) can be used in conjunction with [[Exact Audio Copy]] (EAC), as an external compressor.

It is, however, not an encoder, but an interim application that provides a scripting facility to call muliple encoders or pre-/post-encoding applications to process the [[WAV|WAVE]] files created by [[Exact Audio Copy|EAC]], or the files created by the script itself. '''In short''', REACT allows you to run multiple tasks on the audio extracted, instead of only one.

REACT integrates with [[Exact Audio Copy]], adding some hotkeys combinations to access often used functions more quickly. It will also alter the default name for image files according to your INI settings, and close the extraction dialogue in order for the logfile to be created and used from within your script. It can auto-configure [[Exact Audio Copy|EAC]], updating the external compression options so that [[Exact Audio Copy|EAC]] is ready to run REACT immediately. This feature is extremely useful for novice users.

REACT is configured using an INI file and config files. The commands used within the config files are command line/DOS commands, with the addition of numerous variables which REACT makes available. For example, any instance of '''@artist@''' in the script will be replaced by the [[freedb]] artist name, while '''$artist$''' will be replaced with a ''filename-friendly'' version of the artist name (with illegal characters replaced according to your requirements).

'''From REACT version 2.0 final, most configuration can be done by editing the INI file only'''. Only advanced users should edit the .cfg files.

==Hotkeys==

REACT adds a few useful hotkeys to EAC:
{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Key || Function
|-
| F1 || Wiki page for EAC.
|-
| Alt-F1 || Wiki page for REACT (this page).
|-
| Ctrl-F2 || Configure EAC to be used with REACT.
|-
| Alt-F2 || Edit REACT.ini in notepad.
|-
| Alt-F3 || Edit REACT-image.cfg in notepad.
|-
| F4 || Activates Shift-F5 in EAC (Copy selected tracks - Compressed). Optionally, it also starts CoverDownloader\albumart. You may edit REACT.ini and set TracksHotVal=+{F6} if you want to do Test & Copy instead of Copy only. If the INI key CreateAllCuesheets=1, all four cuesheet types are saved as different files as well.
|-
| F10 || Shortcut to menu "Action - Copy Image and Save CUE Sheet - Compressed...". REACT will fill in the image name, as defined in the ImageNaming INI key (template). REACT will also close the Save Wavform dialog automatically if you have configured EAC to extract to a fixed directory.
|-
|}

==Configuration Files==

There are three configuration files in total; The INI file, one CFG file for copying to audio track files, and one for copying to an audio image with cuesheet. The config files are stored in the REACT folder, and are named:

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| File || Description
|-
| REACT.ini || Regular INI file with key=values pairs. Defines variables used by the CFG files.
|-
| REACT-tracks.cfg || - Used for "Copy Selected Tracks Compressed", default shortcut : F4
|-
| REACT-image.cfg || - Used for "Copy Image & Create CUE Sheet Compressed", default shortcut : F10
|-
|}

==The REACT.INI File==
There are four sections in the REACT.ini file. The first [Settings] section has global definitions that REACT uses. The next three [User...] sections have keys that are simply passed through to the .cfg configurations files. I.e. any KEY=VALUE defines a variable @KEY@ which gets expanded to VALUE in the .cfg files.

Note that you may add arbitrary keys to the [User...] sections, and they will expand to their values when used as variables in the .cfg files.

===Settings Section===

The first section in the INI file sets some global keys, which can be used in any or all encoder configs. These variables refer to high level settings, like the path to [[Exact Audio Copy|EAC]], rather than encoder-specific settings. Here is an example:
<pre>
[Settings]
Version=2.0
ImageExt=flac
ImageNaming=$artist$ - [$year$] $album$
ImageHotKey={F10}
TracksHotKey={F4}
TracksHotVal=+{F5}
VA=Various Artists
CreateAllCuesheets=0
RunCoverDownloader=1
CoverDownloader=C:\Program Files\REACT2\coverdownloader\albumart.exe
EAC=C:\Program Files\Exact Audio Copy\EAC.exe
MinimizeCompressionWindow=1
ProcessPriority=1
Sla_Bks_Col_Qst_Bar_Quo_Ast_Lt_Gt=-|-|-||!|'|#|[|]
</pre>

Some of the keys are obvious, and some you really don't need to bother with unless you are a REACT Ninja, but here's a few to watch out for:

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| ImageExt || Copy Image mode only (F10). The format extension for the compressed image file + cuefile. E.g. flac, wv, or mp3. Set to wav when no compressed image is desired.
|-
| ImageNaming || This variable detirmines how image files, and their cuesheets, will be named when REACT is used in copy image mode. Variables available are: $album$; $artist$; $year$; $genre$; and $freedb$. These are populated from the values of EAC's textboxes, and therefore do not strictly relate to the extended variables available within your config. '''Please note:''' Your scheme ''must'' begin "$artist$ -" in order for Various Artists discs to be recognised properly.
|-
| VA || Default set to 'Various Artists'. The variable @va@ holds this string. See @cdartist@ below for further details.
|-
| CreateAllCuesheets || If set to 1, all four availabe types of cuesheets will be saved to the extraction directory, which must be preconfigured in EAC. The cuesheet base name can be accessed using the @albumfile@ variable.
|-
| RunCoverDownloader || If set to 1, run the albumart.exe application. Simply double click the cover you want (select close after save in settings in albumart). In Copy Tracks mode, albumart will wait until it is closed before starting copying. You may set RunCoverDownloader=2 to make it wait in both modes, 3 to wait only in Image Copy mode, or 4 to never wait.
|-
| Sla_Bks_Col_Qst_Bar_Quo_Ast_Lt_Gt || Some characters cannot be used in file or folder names. This variable allows you to specify what these characters should be replaced with. Slash; Backslash; Colon; Question Mark; Bar (Pipe); Quotes; Asterisk; Less Than; Greater Than. It is also possible to convert Space to e.g. _ by appending a Bar and a _ (after the Gt convert character).
|}

===UserTrackFormat Section===
This section enables/disables output audio formats to be created.

===UserOutputNames Section===
Here the track names and the output paths are defined for the different output audio formats.

===UserSettings Section===
Set various variables for more detailed configuration.
{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| Debug || If you are having problems with your config file setup, set this value to 1. REACT will then pause before exiting, so you can examine the console output to attempt to determine where your process fell down.
|-
| Comment || Override the default @comment@ variable (taken from EAC)
|-
| EmbedCover || Select if you want your cover pictures embeded into the audio files, or only copied to the target directory as 'folder.jpg'.
|-
|ReplayGain || Enable/Disable ReplayGain calculation and tagging.
|-
| ApplyAlbumGain || Apply the album gain to the files, so they are played back with a consistent volume across the albums on every player.
|-
| AdjustAlbumGain_dB || If you want to adjust the album gain from 89.0 dB when applying to the audio, set adjustment in dB here.
|-
| AddCuesheetAG || Add Album gain/Album peak values to the cuesheet as REM lines. This implies that WaveGain is ran.
|-
| UseWaveGainAG || Instruct to use WaveGain to calculate AlbumGain values on the wav image file. The values will be transferred to the various compressed formats, rather than calculating them via other tools.
|-
| Opt_... || Variables that defines options for each encoder used.
|-
| Ver_... || Variables that defines the version number for each encoder used.
|}

==Modifying the CFG files (advanced)==

===Available Variables===

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| '''PATHS AND FILES''' ||
|-
| @reactdir@ || The path to the directory in which REACT resides
|-
| @tools@ || The path to the directory in which the encoders reside. Set within the INI file
|-
| @mymusic@ || The path to your 'My Music' folder
|-
| @sourcedir@ || The path to the folder in which the copied source files are located ([[WAV]]/LOG/CUE)
|-
| @basename@ || The name of the file being created, excluding folders and extension
|-
| @source@ || The path to the temporary source [[WAV|WAVE]] file
|-
| @image@ || The path to the final image file, when used in '''Copy Image''' mode
|-
| @imageext@ || The extension of the compressed target image, e.g. flac
|-
| @sourcecuesheet@ || The path to the (temporary) source [[Cuesheet|cuesheet]], when used in '''Copy Image''' mode
|-
| @cuesheet@ || The path to the final [[Cuesheet|cuesheet]], when used in '''Copy Image''' mode
|-
| @eaclog@ || The path to the log file created by [[Exact Audio Copy|EAC]]
|-
| @cover@ || The path to the cover/album art picture file, dowloaded with CoverDownloader.
|-
| @albumfile@ || The base path to the cuesheet files without extension, created when CreateAllCuesheets=1 in the INI file. E.g, "@albumfile@.[mg].cue" is the multiple wav files cuesheet with gaps.
|-
| ||
|-
| '''METADATA''' ||
|-
| @cdartist@ || The name of the CD artist. If @various@=1 @cdartist@ equals the variable @va@, otherwise @artist@. Use $cdartist$ in file paths
|-
| @artist@ || The name of the track artist. Use $artist$ in paths
|-
| @album@ || The name of the album. Use $album$ in paths
|-
| @title@ || The song title. Use $title$ in paths
|-
| @track@ || The track number. Use $track$ to zero-pad the track number, i.e.: turn 9 into 09
|-
| @numtracks@ || The total number of tracks. Use $numtracks$ to zero-pad the number
|-
| @genre@ || The album genre. Use $genre$ in paths
|-
| @year@ || The album year
|-
| @comment@ || The comment. Use $comment$ in paths
|-
| @freedbid@ || The [[freedb]] ID
|-
| ||
|-
| '''OTHER''' ||
|-
| @various@ || Is 1 if the EAC 'Various' checkbox was checked. Otherwise 0
|-
| @va@ || The name of VariousArtist. Default 'Various Artists'.
|-
| @crc@ || The [[CRC]] of the file
|-
| @bitrate@ || The value of the '''Bitrate''' dropdown on EAC's External Compressor dialogue
|-
| @curdate@ || The current date
|}

==Links==

Ask REACT questions in this thread : http://www.hydrogenaudio.org/forums/index.php?showtopic=35158

Download REACT from this thread : http://www.hydrogenaudio.org/forums/index.php?showtopic=36261

REACT

2006-12-11T13:43:00Z

Tycho:

'''This page is under construction.'''

REACT ('''R'''un '''EAC''' '''T'''asks) can be used in conjunction with [[Exact Audio Copy]] (EAC), as an external compressor.

It is, however, not an encoder, but an interim application that provides a scripting facility to call muliple encoders or pre-/post-encoding applications to process the [[WAV|WAVE]] files created by [[Exact Audio Copy|EAC]], or the files created by the script itself. '''In short''', REACT allows you to run multiple tasks on the audio extracted, instead of only one.

REACT integrates with [[Exact Audio Copy]], adding some hotkeys combinations to access often used functions more quickly. It will also alter the default name for image files according to your INI settings, and close the extraction dialogue in order for the logfile to be created and used from within your script. It can auto-configure [[Exact Audio Copy|EAC]], updating the external compression options so that [[Exact Audio Copy|EAC]] is ready to run REACT immediately. This feature is extremely useful for novice users.

REACT is configured using an INI file and config files. The commands used within the config files are command line/DOS commands, with the addition of numerous variables which REACT makes available. For example, any instance of '''@artist@''' in the script will be replaced by the [[freedb]] artist name, while '''$artist$''' will be replaced with a ''filename-friendly'' version of the artist name (with illegal characters replaced according to your requirements).

'''From REACT version 2.0 final, most configuration can be done by editing the INI file only'''. Only advanced users should edit the .cfg files.

==Hotkeys==

REACT adds a few useful hotkeys to EAC:
{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Key || Function
|-
| F1 || Wiki page for EAC.
|-
| Alt-F1 || Wiki page for REACT (this page).
|-
| Ctrl-F2 || Configure EAC to be used with REACT.
|-
| Alt-F2 || Edit REACT.ini in notepad.
|-
| Alt-F3 || Edit REACT-image.cfg in notepad.
|-
| F4 || Activates Shift-F5 in EAC (Copy selected tracks - Compressed). Optionally, it also starts CoverDownloader\albumart. You may edit REACT.ini and set TracksHotVal=+{F6} if you want to do Test & Copy instead of Copy only. If the INI key CreateAllCuesheets=1, all four cuesheet types are saved as different files as well.
|-
| F10 || Shortcut to menu "Action - Copy Image and Save CUE Sheet - Compressed...". REACT will fill in the image name, as defined in the ImageNaming INI key (template). REACT will also close the Save Wavform dialog automatically if you have configured EAC to extract to a fixed directory.
|-
|}

==Configuration Files==

There are three configuration files in total; The INI file, one CFG file for copying to audio track files, and one for copying to an audio image with cuesheet. The config files are stored in the REACT folder, and are named:

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| File || Description
|-
| REACT.ini || Regular INI file with key=values pairs. Defines variables used by the CFG files.
|-
| REACT-tracks.cfg || - Used for "Copy Selected Tracks Compressed", default shortcut : F4
|-
| REACT-image.cfg || - Used for "Copy Image & Create CUE Sheet Compressed", default shortcut : F10
|-
|}

==The REACT.INI File==
There are four sections in the REACT.ini file. The first [Settings] section has global definitions that REACT uses. The next three [User...] sections have keys that are simply passed through to the .cfg configurations files. I.e. any KEY=VALUE defines a variable @KEY@ which gets expanded to VALUE in the .cfg files.

Note that you may add arbitrary keys to the [User...] sections, and they will expand to their values when used as variables in the .cfg files.

===Settings Section===

The first section in the INI file sets some global keys, which can be used in any or all encoder configs. These variables refer to high level settings, like the path to [[Exact Audio Copy|EAC]], rather than encoder-specific settings. Here is an example:
<pre>
[Settings]
Version=2.0
ImageExt=flac
ImageNaming=$artist$ - [$year$] $album$
ImageHotKey={F10}
TracksHotKey={F4}
TracksHotVal=+{F5}
VA=Various Artists
CreateAllCuesheets=0
RunCoverDownloader=1
CoverDownloader=C:\Program Files\REACT2\coverdownloader\albumart.exe
EAC=C:\Program Files\Exact Audio Copy\EAC.exe
MinimizeCompressionWindow=1
ProcessPriority=1
Sla_Bks_Col_Qst_Bar_Quo_Ast_Lt_Gt=-|-|-||!|'|#|[|]
</pre>

Some of the keys are obvious, and some you really don't need to bother with unless you are a REACT Ninja, but here's a few to watch out for:

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| ImageExt || Copy Image mode only (F10). The format extension for the compressed image file + cuefile. E.g. flac, wv, or mp3. Set to wav when no compressed image is desired.
|-
| ImageNaming || This variable detirmines how image files, and their cuesheets, will be named when REACT is used in copy image mode. Variables available are: $album$; $artist$; $year$; $genre$; and $freedb$. These are populated from the values of EAC's textboxes, and therefore do not strictly relate to the extended variables available within your config. '''Please note:''' Your scheme ''must'' begin "$artist$ -" in order for Various Artists discs to be recognised properly.
|-
| VA || Default set to 'Various Artists'. The variable @va@ holds this string. See @cdartist@ below for further details.
|-
| CreateAllCuesheets || If set to 1, all four availabe types of cuesheets will be saved to the extraction directory, which must be preconfigured in EAC. The cuesheet base name can be accessed using the @albumfile@ variable.
|-
| RunCoverDownloader || If set to 1, run the albumart.exe application. Simply double click the cover you want (select close after save in settings in albumart). In Copy Tracks mode, albumart will wait until it is closed before starting copying. You may set RunCoverDownloader=2 to make it wait in both modes, 3 to wait only in Image Copy mode, or 4 to never wait.
|-
| Sla_Bks_Col_Qst_Bar_Quo_Ast_Lt_Gt || Some characters cannot be used in file or folder names. This variable allows you to specify what these characters should be replaced with. Slash; Backslash; Colon; Question Mark; Bar (Pipe); Quotes; Asterisk; Less Than; Greater Than. It is also possible to convert Space to e.g. _ by appending a Bar and a _ (after the Gt convert character).
|}

===UserTrackFormat Section===
This section enables/disables output audio formats to be created.

===UserOutputNames Section===
Here the track names and the output paths are defined for the different output audio formats.

===UserSettings Section===
Set various variables for more detailed configuration.
{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| Debug || If you are having problems with your config file setup, set this value to 1. REACT will then pause before exiting, so you can examine the console output to attempt to determine where your process fell down.
|}

==Modifying the CFG files (advanced)==

===Available Variables===

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| '''PATHS AND FILES''' ||
|-
| @reactdir@ || The path to the directory in which REACT resides
|-
| @tools@ || The path to the directory in which the encoders reside. Set within the INI file
|-
| @mymusic@ || The path to your 'My Music' folder
|-
| @sourcedir@ || The path to the folder in which the copied source files are located ([[WAV]]/LOG/CUE)
|-
| @basename@ || The name of the file being created, excluding folders and extension
|-
| @source@ || The path to the temporary source [[WAV|WAVE]] file
|-
| @image@ || The path to the final image file, when used in '''Copy Image''' mode
|-
| @imageext@ || The extension of the compressed target image, e.g. flac
|-
| @sourcecuesheet@ || The path to the (temporary) source [[Cuesheet|cuesheet]], when used in '''Copy Image''' mode
|-
| @cuesheet@ || The path to the final [[Cuesheet|cuesheet]], when used in '''Copy Image''' mode
|-
| @eaclog@ || The path to the log file created by [[Exact Audio Copy|EAC]]
|-
| @cover@ || The path to the cover/album art picture file, dowloaded with CoverDownloader.
|-
| @albumfile@ || The base path to the cuesheet files without extension, created when CreateAllCuesheets=1 in the INI file. E.g, "@albumfile@.[mg].cue" is the multiple wav files cuesheet with gaps.
|-
| ||
|-
| '''METADATA''' ||
|-
| @cdartist@ || The name of the CD artist. If @various@=1 @cdartist@ equals the variable @va@, otherwise @artist@. Use $cdartist$ in file paths
|-
| @artist@ || The name of the track artist. Use $artist$ in paths
|-
| @album@ || The name of the album. Use $album$ in paths
|-
| @title@ || The song title. Use $title$ in paths
|-
| @track@ || The track number. Use $track$ to zero-pad the track number, i.e.: turn 9 into 09
|-
| @numtracks@ || The total number of tracks. Use $numtracks$ to zero-pad the number
|-
| @genre@ || The album genre. Use $genre$ in paths
|-
| @year@ || The album year
|-
| @comment@ || The comment. Use $comment$ in paths
|-
| @freedbid@ || The [[freedb]] ID
|-
| ||
|-
| '''OTHER''' ||
|-
| @various@ || Is 1 if the EAC 'Various' checkbox was checked. Otherwise 0
|-
| @va@ || The name of VariousArtist. Default 'Various Artists'.
|-
| @crc@ || The [[CRC]] of the file
|-
| @bitrate@ || The value of the '''Bitrate''' dropdown on EAC's External Compressor dialogue
|-
| @curdate@ || The current date
|}

==Links==

Ask REACT questions in this thread : http://www.hydrogenaudio.org/forums/index.php?showtopic=35158

Download REACT from this thread : http://www.hydrogenaudio.org/forums/index.php?showtopic=36261

REACT

2006-12-10T21:57:37Z

Tycho:

'''This page is under construction.'''

REACT ('''R'''un '''EAC''' '''T'''asks) can be used in conjunction with [[Exact Audio Copy]] (EAC), as an external compressor.

It is, however, not an encoder, but an interim application that provides a scripting facility to call muliple encoders or pre-/post-encoding applications to process the [[WAV|WAVE]] files created by [[Exact Audio Copy|EAC]], or the files created by the script itself. '''In short''', REACT allows you to run multiple tasks on the audio extracted, instead of only one.

REACT integrates with [[Exact Audio Copy]], adding some hotkeys combinations to access often used functions more quickly. It will also alter the default name for image files according to your INI settings, and close the extraction dialogue in order for the logfile to be created and used from within your script. It can auto-configure [[Exact Audio Copy|EAC]], updating the external compression options so that [[Exact Audio Copy|EAC]] is ready to run REACT immediately. This feature is extremely useful for novice users.

REACT is configured using an INI file and config files. The commands used within the config files are command line/DOS commands, with the addition of numerous variables which REACT makes available. For example, any instance of '''@artist@''' in the script will be replaced by the [[freedb]] artist name, while '''$artist$''' will be replaced with a ''filename-friendly'' version of the artist name (with illegal characters replaced according to your requirements).

'''From REACT version 2.1, most configuration can be done by editing the INI file only'''. Only advanced users should edit the .cfg files.

==Hotkeys==

REACT adds a few useful hotkeys to EAC:
{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Key || Function
|-
| F1 || Wiki page for EAC.
|-
| Alt-F1 || Wiki page for REACT (this page).
|-
| Ctrl-F2 || Configure EAC to be used with REACT.
|-
| Alt-F2 || Edit REACT.ini in notepad.
|-
| Alt-F3 || Edit REACT-image.cfg in notepad.
|-
| F4 || Activates Shift-F5 in EAC (Copy selected tracks - Compressed). Optionally, it also starts CoverDownloader\albumart. You may edit REACT.ini and set TracksHotVal=+{F6} if you want to do Test & Copy instead of Copy only. If the INI key CreateAllCuesheets=1, all four cuesheet types are saved as different files as well.
|-
| F10 || Shortcut to menu "Action - Copy Image and Save CUE Sheet - Compressed...". REACT will fill in the image name, as defined in the ImageNaming INI key (template). REACT will also close the Save Wavform dialog automatically if you have configured EAC to extract to a fixed directory.
|-
|}

==Configuration Files==

There are three configuration files in total; The INI file, one CFG file for ripping to audio track files, and one for ripping to an audio image with cuesheet. The config files are stored in the REACT folder, and are named:

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| File || Description
|-
| REACT.ini || Regular INI file with key=values pairs. Defines variables used by the CFG files.
|-
| REACT-tracks.cfg || - Used for "Copy Selected Tracks Compressed", default shortcut : F4
|-
| REACT-image.cfg || - Used for "Copy Image & Create CUE Sheet Compressed", default shortcut : F10
|-
|}

==The REACT.INI File==

===Settings Section===

The first section in the INI file sets some global keys, which can be used in any or all encoder configs. These variables refer to high level settings, like the path to [[Exact Audio Copy|EAC]], rather than encoder-specific settings. Here is an example:
<pre>
[Settings]
Version=2.1
ImageExt=flac
ImageNaming=$artist$ - [$year$] $album$
ImageHotKey={F10}
TracksHotKey={F4}
TracksHotVal=+{F5}
VA=Various Artists
CreateAllCuesheets=0
RunCoverDownloader=1
CoverDownloader=C:\Program Files\REACT2\coverdownloader\albumart.exe
EAC=C:\Program Files\Exact Audio Copy\EAC.exe
MinimizeCompressionWindow=1
ProcessPriority=1
Sla_Bks_Col_Qst_Bar_Quo_Ast_Lt_Gt=-|-|-||!|'|#|[|]
</pre>

Some of the keys are obvious, and some you really don't need to bother with unless you are a REACT Ninja, but here's a few to watch out for:

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| ImageExt || Image mode only (F10). The format extension for the compressed image file + cuefile. E.g. flac, wv, or mp3. Set to wav when no compressed image is desired.
|-
| VA || Default set to 'Various Artists'. The variable @va@ holds this string. See @cdartist@ below for further details.
|-
| CreateAllCuesheets || If set to 1, all four availabe types of cuesheets will be saved to the extraction directory, which must be preconfigured in EAC. The cuesheet base name can be accessed using the @albumfile@ variable.
|-
| ImageNaming || This variable detirmines how image files, and their cuesheets, will be named when REACT is used in image mode. Variables available are: $album$; $artist$; $year$; $genre$; and $freedb$. These are populated from the values of EAC's textboxes, and therefore do not strictly relate to the extended variables available within your config. '''Please note:''' Your scheme ''must'' begin "$artist$ -" in order for Various Artists discs to be recognised properly.
|-
| Sla_Bks_Col_Qst_Bar_Quo_Ast_Lt_Gt || Some characters cannot be used in file or folder names. This variable allows you to specify what these characters should be replaced with. Slash; Backslash; Colon; Question Mark; Bar (Pipe); Quotes; Asterisk; Less Than; Greater Than. It is also possible to convert Space to e.g. _ by appending a Bar and a _ (after the Gt convert character).
|-
| Debug || If you are having problems with your config file setup, set this value to 1. REACT will then pause before exiting, so you can examine the console output to attempt to determine where your process fell down.
|}

===UserTrackFormat Section===
===UserOutputNames Section===
===UserSettings Section===

==Modifying the CFG files (Advanced)==

===Available Variables===

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| '''PATHS AND FILES''' ||
|-
| @reactdir@ || The path to the directory in which REACT resides
|-
| @tools@ || The path to the directory in which the encoders reside. Set within the INI file
|-
| @mymusic@ || The path to your 'My Music' folder
|-
| @sourcedir@ || The path to the folder in which the ripped source files are located ([[WAV]]/LOG/CUE)
|-
| @basename@ || The name of the file being created, excluding folders and extension
|-
| @source@ || The path to the temporary source [[WAV|WAVE]] file
|-
| @image@ || The path to the final image file, when used in '''Copy Image''' mode
|-
| @sourcecuesheet@ || The path to the (temporary) source [[Cuesheet|cuesheet]], when used in '''Copy Image''' mode
|-
| @cuesheet@ || The path to the final [[Cuesheet|cuesheet]], when used in '''Copy Image''' mode
|-
| @eaclog@ || The path to the log file created by [[Exact Audio Copy|EAC]]
|-
| @albumfile@ || The base path to the cuesheet files without extension, created when CreateAllCuesheets=1 in the INI file. E.g, "@albumfile@.[mg].cue" is the multiple wav files cuesheet with gaps.
|-
| ||
|-
| '''METADATA''' ||
|-
| @cdartist@ || The name of the CD artist. If @various@=1 @cdartist@ equals the variable @va@, otherwise @artist@. Use $cdartist$ in file paths
|-
| @artist@ || The name of the track artist. Use $artist$ in paths
|-
| @album@ || The name of the album. Use $album$ in paths
|-
| @title@ || The song title. Use $title$ in paths
|-
| @track@ || The track number. Use $track$ to zero-pad the track number, i.e.: turn 9 into 09
|-
| @numtracks@ || The total number of tracks. Use $numtracks$ to zero-pad the number
|-
| @genre@ || The album genre. Use $genre$ in paths
|-
| @year@ || The album year
|-
| @comment@ || The comment. Use $comment$ in paths
|-
| @freedbid@ || The [[freedb]] ID
|-
| ||
|-
| '''OTHER''' ||
|-
| @crc@ || The [[CRC]] of the file
|-
| @bitrate@ || The value of the '''Bitrate''' dropdown on EAC's External Compressor dialogue
|-
| @curdate@ || The current date
|}

==Links==

Ask REACT questions in this thread : http://www.hydrogenaudio.org/forums/index.php?showtopic=35158

Download REACT from this thread : http://www.hydrogenaudio.org/forums/index.php?showtopic=36261

REACT

2006-12-09T20:05:35Z

Tycho:

REACT

2006-05-09T13:33:47Z

Tycho:

REACT ('''R'''un '''EAC''' '''T'''asks) can be used in conjunction with [[Exact Audio Copy]] (EAC), as an external compressor.

It is, however, not an encoder, but an interim application that provides a scripting facility to call muliple encoders or pre-/post-encoding applications to process the [[WAV|WAVE]] files created by [[Exact Audio Copy|EAC]], or the files created by the script itself. '''In short''', REACT allows you to run multiple tasks on the audio extracted, instead of only one.

REACT integrates with [[Exact Audio Copy]], adding some hotkeys combinations to access often used functions more quickly. It will also alter the default name for image files according to your INI settings, and close the extraction dialogue in order for the logfile to be created and used from within your script. It can auto-configure [[Exact Audio Copy|EAC]], updating the external compression options so that [[Exact Audio Copy|EAC]] is ready to run REACT immediately. This feature is extremely useful for novice users.

REACT is configured using an INI file and config files. The commands used within the config files are command line/DOS commands, with the addition of numerous variables which REACT makes available. For example, any instance of '''@artist@''' in the script will be replaced by the [[freedb]] artist name, while '''$artist$''' will be replaced with a ''filename-friendly'' version of the artist name (with illegal characters replaced according to your requirements).

=Hotkeys=

REACT adds a few useful hotkeys to EAC:
{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Key || Function
|-
| F1 || Wiki page for EAC.
|-
| Alt-F1 || Wiki page for REACT (this page).
|-
| Ctrl-F2 || Configure EAC to be used with REACT.
|-
| Alt-F2 || Open REACT.ini in notepad.
|-
| Alt-F3 || Browse Config files directory.
|-
| F4 || Copy selected tracks. This activates the function Shift-F5 in EAC by default. You may edit REACT.ini and set TracksHotVal=+{F6} if you want to do Test & Copy instead of Copy only. If the INI key SaveTracksCuesheets=1, all four cuesheet types are saved as different files as well.
|-
| F10 || Shortcut to menu "Action - Copy Image and Save CUE Sheet - Compressed...". REACT will fill in the image name, as defined in the ImageNaming INI key (template). REACT will also close the Save Wavform dialog automatically if you have configured EAC to extract to a fixed directory.
|}

=Available Variables=

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| '''PATHS''' ||
|-
| @reactdir@ || The path to the directory in which REACT resides
|-
| @encdir@ || The path to the directory in which the encoders reside. Set within the INI file
|-
| @mydocumentsdir@ || The path to your My Documents folder
|-
| @musicdir@ || The path to your music folder. Set within the INI file. Used as a root for other paths
|-
| @sourcedir@ || The path to the folder in which the source files are located ([[WAV]]/LOG/CUE)
|-
| @basename@ || The name of the file being created, excluding extension
|-
| @removabledriveN@ || The path to your removable drive number N. Set within the INI file
|-
| @destdirN@ || Directory path N used within your script. Set within the INI file
|-
| @destN@ || File path N, used within your script. Set within a config file
|-
| @Various-destN@ || The file path to use if it is a Various Artists CD. Set within a config file
|-
| @source@ || The path to the temporary source [[WAV|WAVE]] file
|-
| @image@ || The path to the final image file, when used in '''Copy Image''' mode
|-
| @sourcecuesheet@ || The path to the (temporary) source [[Cuesheet|cuesheet]], when used in '''Copy Image''' mode
|-
| @cuesheet@ || The path to the final [[Cuesheet|cuesheet]], when used in '''Copy Image''' mode
|-
| @eaclog@ || The path to the log file created by [[Exact Audio Copy|EAC]]
|-
| @trackscuesheet@ || (from v0.999) The path to the cuesheet files without extension, created by [[Exact Audio Copy|EAC]] when hitting F4 and SaveTracksCuesheets=1 in the INI file. E.g, "@trackscuesheet@.[mg].cue" is the multiple wav files cuesheet with gaps.
|-
| ||
|-
| '''METADATA''' ||
|-
| @cdartist@ || The name of the CD artist. Use $cdartist$ in paths
|-
| @artist@ || The name of the track artist. Use $artist$ in paths
|-
| @album@ || The name of the album. Use $album$ in paths
|-
| @title@ || The song title. Use $title$ in paths
|-
| @track@ || The track number. Use $track$ to zero-pad the track number, i.e.: turn 9 into 09
|-
| @numtracks@ || The total number of tracks
|-
| @islast@ || Whether the current track is the last, for track mode
|-
| @genre@ || The album genre. Use $genre$ in paths
|-
| @year@ || The album year
|-
| @comment@ || The comment. Use $comment$ in paths
|-
| @freedbid@ || The [[freedb]] ID
|-
| ||
|-
| '''OTHER''' ||
|-
| @crc@ || The [[CRC]] of the file
|-
| @bitrate@ || The value of the '''Bitrate''' dropdown on EAC's External Compressor dialogue
|-
| @curdate@ || The current date
|}

=Global INI Keys=

The first section of the REACT INI sets some global keys, which can be used in any or all encoder configs. These variables refer to high level settings, like the path to [[Exact Audio Copy|EAC]], rather than encoder-specific settings.

Here is an example:

<pre>
[Settings]
Config=FLAC
Version=1.0
EAC=C:\Program Files\Exact Audio Copy\EAC.exe
musicdir=C:\My Music
encdir=C:\Program Files\REACT\Encoders
LogFile=
CodePage=1252
MinimizeCompressionWindow=1
ProcessPriority=1
TracksHotKey={F4}
TracksHotVal=+{F5}
SaveTracksCuesheets=0
ImageHotKey={F10}
ImageNaming=$artist$ - ($year$) $album$
Sla_Bks_Col_Qst_Bar_Quo_Ast_Lt_Gt=-|-|-||!|'|#|[|]
Debug=0
</pre>

==A Few Of The Important INI Keys==

Some of the keys are obvious, and some you really don't need to bother with unless you are a REACT Ninja, but here's a few to watch out for:

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| Config || The encoder config file that REACT should process in the Config folder.
|-
| musicdir || The root directory for all your music. If you are encoding to "C:\My Music\WavPack" and "C:\My Music\MP3" then you can set musicdir to "C:\My Music" and use this variable when setting your @destdirN@ variables. this helps maintain clarity within your INI file.
|-
| encdir || REACT installs many encoders in a folder called "Encoders". Again, this variable can be used when referencing these applications, to maintain clarity.
|-
| LogFile || If you set a value to this variable a REACT log will be created with that name, e.g.: react.txt. If left blank no log will be written. This does not affect [[Exact Audio Copy|EAC]]'s log file.
|-
| SaveTracksCuesheets || If set to 1, all four availabe types of cuesheets will be saved to the extraction directory, which must be preconfigured in EAC. This only happens when pressing F4, or whatever the key TracksHotkey is set to. The cuesheet base name can be accessed using the @trackscuesheet@ variable.
|-
| ImageNaming || This variable detirmines how image files, and their cuesheets, will be named when REACT is used in image mode. You can use meta data variables here, e.g.: "$artist$ - $album$" to name the image using the artist and album name (filename-friendly values).
|-
| Sla_Bks_Col_Qst_Bar_Quo_Ast_Lt_Gt || Some characters cannot be used in file or folder names. This variable allows you to specify what these characters should be replaced with. Slash; Backslash; Colon; Question Mark; Bar (Pipe); Quotes; Asterisk; Less Than; Greater Than. It is also possible to convert Space to e.g. _ by appending a Bar and a _ (after the Gt convert character).
|-
| Debug || If you are having problems with your config file setup, set this value to 1. REACT will then pause before exiting, so you can examine the console output to attempt to determine where your process fell down.
|}

=The Encoder Config Files=

The initial REACT INI contains a global settings section. This contains a key named Config=<ENCODER> which refers to configuration files in the Config folder. There are two config files for each encoding; one for ripping to track files, and one for ripping to an image with cuesheet.

The config files are stored in <REACT dir>\Config folder, and are named:

<ENCODER>-tracks.txt

<ENCODER>-image.txt

The first part, '''ENCODER''', is simply a unique name which indentifies the encoder tasks; however it makes sense to use the name of the encoder being used, like "FLAC" or "WAVPACK". This part of the section header is referred to by the global variable, '''[[REACT#A_Few_Of_The_Important_Ones|Config]]'''.

The second part (tracks or image) describes whether to perform when ripping to '''tracks''', or to an '''image'''.

The encoder section consists of two parts:

==Variable Initialisation==

In the beginning of each config file you can set some variables.

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| !Description || A description of the processes within the section.
|-
| !ImageExt || The file extension of the image file, e.g.: "wv". Image sections only.
|-
| !CuesheetExt || The extension given to the cuesheet by [[Exact Audio Copy|EAC]], e.g.: ".wv.cue". Image sections only.
|-
|!WaveGainAnalysis || Set to 1 to enable a pre-run WaveGain analysis. Makes variables @gain@, @peak@ and @scale@ available for config scripts.
|}

It is likely that you will also need to set file and folder path variables, like @destN@ and @destdirN@. E.g.:

<pre>destdir1=@musicdir@\FLAC\$cdartist$\($year$) $album$
dest1=@destdir1@\$track$ - $title$</pre>

The above will set the folder path @destdir1@ using the global variable @musicdir@, and artist, year and album meta data. It then sets the file path @dest1@ using @destdir1@ and the track and title meta data. So, considering the following values for those variables:

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| musicdir|| C:\My Music
|-
| albumartist|| Ben Folds Five
|-
| album|| Whatever and Ever Amen
|-
| year|| 2000
|-
| track|| 03
|-
| title|| Brick
|}

... we end up with:

<pre>destdir1=C:\My Music\FLAC\Ben Folds Five\(2000) Whatever and Ever Amen
dest1=C:\My Music\FLAC\Ben Folds Five\(2000) Whatever and Ever Amen\03 - Brick</pre>

Obviously the values of $track$ and $title$ will change per track. Remember, $track$ will zero-pad the track number.

==Config Tasks==

Each line '''not''' starting with a "!" will be part of the config task script.

The task script is simply a list of command line statements, utilising the variables that REACT exposes within the code.

As an example, here is the default MP3-tracks.txt file. Notice that all REACT variables are surrounded by two ampersands (@), or two dollar signs ($); all other code is standard DOS command line syntax. With this in mind you will find working with REACT a lot easier if you are happy executing applications from the command line, more so if you have an understanding of batch files or command line scripting (what I think of as 'DOS scripts').

MP3-tracks.txt:
<pre>!Description=LAME -V2 mp3 track files, RG album gain, APE2 and id3v1 tags

!destdir1=@musicdir@\MP3\$cdartist$\($year$) $album$
!dest1=@destdir1@\$track$ - $title$
!Various-dest1=@destdir1@\$track$ - $title$ ($artist$)

echo.> "@dest1@.mp3.tmp"
@encdir@\Tag.exe --nocheck --ape2 -t "ARTIST=@artist@" -t "ALBUM=@album@" -t "TRACK=@track@" -t "TITLE=@title@" -t "YEAR=@year@" -t "GENRE=@genre@" -t "TOTALTRACKS=@numtracks@" -t "FREEDB=@freedbid@" -t "CRC=@crc@" "@dest1@.mp3.tmp"
move "@source@" "@dest1@.wav"

if @islast@==1 (
move "@eaclog@" "@destdir1@\eaclog.txt"
move "@trackscuesheet@.[*].cue" "@destdir1@"
start @encdir@\albumart.exe "@artist@" "@album@" "@destdir1@\cover.jpg"
cd /d "@destdir1@"
@encdir@\WaveGain.exe -a *.wav --exec @encdir@\lame.exe -V2 --vbr-new --scale %%ALBUM_SCALE%% --tc "AG appl:%%ALBUM_GAIN%%,TG:%%TRACK_GAIN%% dB" "%%INPUT_NAME%%.wav" "%%INPUT_NAME%%.mp3"
for %%i in (*.mp3) do @encdir@\Tag.exe --force id3v1 --force ape2 --fromfile "%%i.tmp" "%%i"
del "*.mp3.tmp" "*.wav"
)</pre>

=Links=

Ask REACT questions in this thread : http://www.hydrogenaudio.org/forums/index.php?showtopic=35158

Download REACT from this thread : http://www.hydrogenaudio.org/forums/index.php?showtopic=36261

REACT

2006-05-09T13:29:51Z

Tycho:

REACT ('''R'''un '''EAC''' '''T'''asks) can be used in conjunction with [[Exact Audio Copy]] (EAC), as an external compressor.

It is, however, not an encoder, but an interim application that provides a scripting facility to call muliple encoders or pre-/post-encoding applications to process the [[WAV|WAVE]] files created by [[Exact Audio Copy|EAC]], or the files created by the script itself. '''In short''', REACT allows you to run multiple tasks on the audio extracted, instead of only one.

REACT integrates with [[Exact Audio Copy]], adding some hotkeys combinations to access often used functions more quickly. It will also alter the default name for image files according to your INI settings, and close the extraction dialogue in order for the logfile to be created and used from within your script. It can auto-configure [[Exact Audio Copy|EAC]], updating the external compression options so that [[Exact Audio Copy|EAC]] is ready to run REACT immediately. This feature is extremely useful for novice users.

REACT is configured using an INI file and config files. The commands used within the config files are command line/DOS commands, with the addition of numerous variables which REACT makes available. For example, any instance of '''@artist@''' in the script will be replaced by the [[freedb]] artist name, while '''$artist$''' will be replaced with a ''filename-friendly'' version of the artist name (with illegal characters replaced according to your requirements).

=Hotkeys=

REACT adds a few useful hotkeys to EAC:
{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Key || Function
|-
| F1 || Wiki page for EAC.
|-
| Alt-F1 || Wiki page for REACT (this page).
|-
| Ctrl-F2 || Configure EAC to be used with REACT.
|-
| Alt-F2 || Open REACT.ini in notepad.
|-
| Alt-F3 || Browse Config files directory.
|-
| F4 || Copy selected tracks. This enables the function Shift-F5 in EAC by default. You may edit REACT.ini and set TracksHotVal=+{F6} if you want to do Test & Copy instead of Copy only. If the INI key SaveTracksCuesheets=1, all four cuesheet types are saved as different files as well.
|-
| F10 || Shortcut to menu "Action - Copy Image and Save CUE Sheet - Compressed...". REACT will fill in the image name, as defined in the ImageNaming INI key (template). REACT will also close the Save Wavform dialog automatically if you have configured EAC to extract to a fixed directory.
|}

=Available Variables=

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| '''PATHS''' ||
|-
| @reactdir@ || The path to the directory in which REACT resides
|-
| @encdir@ || The path to the directory in which the encoders reside. Set within the INI file
|-
| @mydocumentsdir@ || The path to your My Documents folder
|-
| @musicdir@ || The path to your music folder. Set within the INI file. Used as a root for other paths
|-
| @sourcedir@ || The path to the folder in which the source files are located ([[WAV]]/LOG/CUE)
|-
| @basename@ || The name of the file being created, excluding extension
|-
| @removabledriveN@ || The path to your removable drive number N. Set within the INI file
|-
| @destdirN@ || Directory path N used within your script. Set within the INI file
|-
| @destN@ || File path N, used within your script. Set within a config file
|-
| @Various-destN@ || The file path to use if it is a Various Artists CD. Set within a config file
|-
| @source@ || The path to the temporary source [[WAV|WAVE]] file
|-
| @image@ || The path to the final image file, when used in '''Copy Image''' mode
|-
| @sourcecuesheet@ || The path to the (temporary) source [[Cuesheet|cuesheet]], when used in '''Copy Image''' mode
|-
| @cuesheet@ || The path to the final [[Cuesheet|cuesheet]], when used in '''Copy Image''' mode
|-
| @eaclog@ || The path to the log file created by [[Exact Audio Copy|EAC]]
|-
| @trackscuesheet@ || (from v0.999) The path to the cuesheet files without extension, created by [[Exact Audio Copy|EAC]] when hitting F4 and SaveTracksCuesheets=1 in the INI file. E.g, "@trackscuesheet@.[mg].cue" is the multiple wav files cuesheet with gaps.
|-
| ||
|-
| '''METADATA''' ||
|-
| @cdartist@ || The name of the CD artist. Use $cdartist$ in paths
|-
| @artist@ || The name of the track artist. Use $artist$ in paths
|-
| @album@ || The name of the album. Use $album$ in paths
|-
| @title@ || The song title. Use $title$ in paths
|-
| @track@ || The track number. Use $track$ to zero-pad the track number, i.e.: turn 9 into 09
|-
| @numtracks@ || The total number of tracks
|-
| @islast@ || Whether the current track is the last, for track mode
|-
| @genre@ || The album genre. Use $genre$ in paths
|-
| @year@ || The album year
|-
| @comment@ || The comment. Use $comment$ in paths
|-
| @freedbid@ || The [[freedb]] ID
|-
| ||
|-
| '''OTHER''' ||
|-
| @crc@ || The [[CRC]] of the file
|-
| @bitrate@ || The value of the '''Bitrate''' dropdown on EAC's External Compressor dialogue
|-
| @curdate@ || The current date
|}

=Global INI Keys=

The first section of the REACT INI sets some global keys, which can be used in any or all encoder configs. These variables refer to high level settings, like the path to [[Exact Audio Copy|EAC]], rather than encoder-specific settings.

Here is an example:

<pre>
[Settings]
Config=FLAC
Version=1.0
EAC=C:\Program Files\Exact Audio Copy\EAC.exe
musicdir=C:\My Music
encdir=C:\Program Files\REACT\Encoders
LogFile=
CodePage=1252
MinimizeCompressionWindow=1
ProcessPriority=1
TracksHotKey={F4}
TracksHotVal=+{F5}
SaveTracksCuesheets=0
ImageHotKey={F10}
ImageNaming=$artist$ - ($year$) $album$
Sla_Bks_Col_Qst_Bar_Quo_Ast_Lt_Gt=-|-|-||!|'|#|[|]
Debug=0
</pre>

==A Few Of The Important INI Keys==

Some of the keys are obvious, and some you really don't need to bother with unless you are a REACT Ninja, but here's a few to watch out for:

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| Config || The encoder config file that REACT should process in the Config folder.
|-
| musicdir || The root directory for all your music. If you are encoding to "C:\My Music\WavPack" and "C:\My Music\MP3" then you can set musicdir to "C:\My Music" and use this variable when setting your @destdirN@ variables. this helps maintain clarity within your INI file.
|-
| encdir || REACT installs many encoders in a folder called "Encoders". Again, this variable can be used when referencing these applications, to maintain clarity.
|-
| LogFile || If you set a value to this variable a REACT log will be created with that name, e.g.: react.txt. If left blank no log will be written. This does not affect [[Exact Audio Copy|EAC]]'s log file.
|-
| SaveTracksCuesheets || If set to 1, all four availabe types of cuesheets will be saved to the extraction directory, which must be preconfigured in EAC. This only happens when pressing F4, or whatever the key TracksHotkey is set to. The cuesheet base name can be accessed using the @trackscuesheet@ variable.
|-
| ImageNaming || This variable detirmines how image files, and their cuesheets, will be named when REACT is used in image mode. You can use meta data variables here, e.g.: "$artist$ - $album$" to name the image using the artist and album name (filename-friendly values).
|-
| Sla_Bks_Col_Qst_Bar_Quo_Ast_Lt_Gt || Some characters cannot be used in file or folder names. This variable allows you to specify what these characters should be replaced with. Slash; Backslash; Colon; Question Mark; Bar (Pipe); Quotes; Asterisk; Less Than; Greater Than. It is also possible to convert Space to e.g. _ by appending a Bar and a _ (after the Gt convert character).
|-
| Debug || If you are having problems with your config file setup, set this value to 1. REACT will then pause before exiting, so you can examine the console output to attempt to determine where your process fell down.
|}

=The Encoder Config Files=

The initial REACT INI contains a global settings section. This contains a key named Config=<ENCODER> which refers to configuration files in the Config folder. There are two config files for each encoding; one for ripping to track files, and one for ripping to an image with cuesheet.

The config files are stored in <REACT dir>\Config folder, and are named:

<ENCODER>-tracks.txt

<ENCODER>-image.txt

The first part, '''ENCODER''', is simply a unique name which indentifies the encoder tasks; however it makes sense to use the name of the encoder being used, like "FLAC" or "WAVPACK". This part of the section header is referred to by the global variable, '''[[REACT#A_Few_Of_The_Important_Ones|Config]]'''.

The second part (tracks or image) describes whether to perform when ripping to '''tracks''', or to an '''image'''.

The encoder section consists of two parts:

==Variable Initialisation==

In the beginning of each config file you can set some variables.

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| !Description || A description of the processes within the section.
|-
| !ImageExt || The file extension of the image file, e.g.: "wv". Image sections only.
|-
| !CuesheetExt || The extension given to the cuesheet by [[Exact Audio Copy|EAC]], e.g.: ".wv.cue". Image sections only.
|-
|!WaveGainAnalysis || Set to 1 to enable a pre-run WaveGain analysis. Makes variables @gain@, @peak@ and @scale@ available for config scripts.
|}

It is likely that you will also need to set file and folder path variables, like @destN@ and @destdirN@. E.g.:

<pre>destdir1=@musicdir@\FLAC\$cdartist$\($year$) $album$
dest1=@destdir1@\$track$ - $title$</pre>

The above will set the folder path @destdir1@ using the global variable @musicdir@, and artist, year and album meta data. It then sets the file path @dest1@ using @destdir1@ and the track and title meta data. So, considering the following values for those variables:

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| musicdir|| C:\My Music
|-
| albumartist|| Ben Folds Five
|-
| album|| Whatever and Ever Amen
|-
| year|| 2000
|-
| track|| 03
|-
| title|| Brick
|}

... we end up with:

<pre>destdir1=C:\My Music\FLAC\Ben Folds Five\(2000) Whatever and Ever Amen
dest1=C:\My Music\FLAC\Ben Folds Five\(2000) Whatever and Ever Amen\03 - Brick</pre>

Obviously the values of $track$ and $title$ will change per track. Remember, $track$ will zero-pad the track number.

==Config Tasks==

Each line '''not''' starting with a "!" will be part of the config task script.

The task script is simply a list of command line statements, utilising the variables that REACT exposes within the code.

As an example, here is the default LAME-tracks.txt file. Notice that all REACT variables are surrounded by two ampersands (@), or two dollar signs ($); all other code is standard DOS command line syntax. With this in mind you will find working with REACT a lot easier if you are happy executing applications from the command line, more so if you have an understanding of batch files or command line scripting (what I think of as 'DOS scripts').

MP3-tracks.txt:
<pre>!Description=LAME -V2 mp3 track files, RG album gain, APE2 and id3v1 tags

!destdir1=@musicdir@\MP3\$cdartist$\($year$) $album$
!dest1=@destdir1@\$track$ - $title$
!Various-dest1=@destdir1@\$track$ - $title$ ($artist$)

echo.> "@dest1@.mp3.tmp"
@encdir@\Tag.exe --nocheck --ape2 -t "ARTIST=@artist@" -t "ALBUM=@album@" -t "TRACK=@track@" -t "TITLE=@title@" -t "YEAR=@year@" -t "GENRE=@genre@" -t "TOTALTRACKS=@numtracks@" -t "FREEDB=@freedbid@" -t "CRC=@crc@" "@dest1@.mp3.tmp"
move "@source@" "@dest1@.wav"

if @islast@==1 (
move "@eaclog@" "@destdir1@\eaclog.txt"
move "@trackscuesheet@.[*].cue" "@destdir1@"
start @encdir@\albumart.exe "@artist@" "@album@" "@destdir1@\cover.jpg"
cd /d "@destdir1@"
@encdir@\WaveGain.exe -a *.wav --exec @encdir@\lame.exe -V2 --vbr-new --scale %%ALBUM_SCALE%% --tc "AG appl:%%ALBUM_GAIN%%,TG:%%TRACK_GAIN%% dB" "%%INPUT_NAME%%.wav" "%%INPUT_NAME%%.mp3"
for %%i in (*.mp3) do @encdir@\Tag.exe --force id3v1 --force ape2 --fromfile "%%i.tmp" "%%i"
del "*.mp3.tmp" "*.wav"
)</pre>

=Links=

Ask REACT questions in this thread : http://www.hydrogenaudio.org/forums/index.php?showtopic=35158

Download REACT from this thread : http://www.hydrogenaudio.org/forums/index.php?showtopic=36261

REACT

2006-05-01T17:58:49Z

Tycho:

REACT ('''R'''un '''EAC''' '''T'''asks) can be used in conjunction with [[Exact Audio Copy]] (EAC), as an external compressor.

It is, however, not an encoder, but an interim application that provides a scripting facility to call muliple encoders or pre-/post-encoding applications to process the [[WAV|WAVE]] files created by [[Exact Audio Copy|EAC]], or the files created by the script itself. '''In short''', REACT allows you to run multiple tasks on the audio extracted, instead of only one.

REACT integrates with [[Exact Audio Copy]], adding some hotkeys combinations to access often used functions more quickly. It will also alter the default name for image files according to your INI settings, and close the extraction dialogue in order for the logfile to be created and used from within your script. It can auto-configure [[Exact Audio Copy|EAC]], updating the external compression options so that [[Exact Audio Copy|EAC]] is ready to run REACT immediately. This feature is extremely useful for novice users.

REACT is configured using an INI file and config files. The commands used within the config files are command line/DOS commands, with the addition of numerous variables which REACT makes available. For example, any instance of '''@artist@''' in the script will be replaced by the [[freedb]] artist name, while '''$artist$''' will be replaced with a ''filename-friendly'' version of the artist name (with illegal characters replaced according to your requirements).

=Available Variables=

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| '''PATHS''' ||
|-
| @reactdir@ || The path to the directory in which REACT resides
|-
| @encdir@ || The path to the directory in which the encoders reside. Set within the INI file
|-
| @mydocumentsdir@ || The path to your My Documents folder
|-
| @musicdir@ || The path to your music folder. Set within the INI file. Used as a root for other paths
|-
| @sourcedir@ || The path to the folder in which the source files are located ([[WAV]]/LOG/CUE)
|-
| @basename@ || The name of the file being created, excluding extension
|-
| @destbase@ || @destbase@ was deprecated in 0.997. Use @sourcedir@\@basename@ instead
|-
| @removabledriveN@ || The path to your removable drive number N. Set within the INI file
|-
| @destdirN@ || Directory path N used within your script. Set within the INI file
|-
| @destN@ || File path N, used within your script. Set within a config file
|-
| @Various-destN@ || The file path to use if it is a Various Artists CD. Set within a config file
|-
| @source@ || The path to the temporary source [[WAV|WAVE]] file
|-
| @image@ || The path to the final image file, when used in '''Copy Image''' mode
|-
| @sourcecuesheet@ || The path to the (temporary) source [[Cuesheet|cuesheet]], when used in '''Copy Image''' mode
|-
| @cuesheet@ || The path to the final [[Cuesheet|cuesheet]], when used in '''Copy Image''' mode
|-
| @eaclog@ || The path to the log file created by [[Exact Audio Copy|EAC]]
|-
| @trackscuesheet@ || (from v0.999) The path to the cuesheet files without extension, created by [[Exact Audio Copy|EAC]] when hitting F4 and SaveTracksCuesheets=1 in the INI file. E.g, "@trackscuesheet@.[mg].cue" is the multiple wav files cuesheet with gaps.
|-
| ||
|-
| '''METADATA''' ||
|-
| @cdartist@ || The name of the CD artist. Use $cdartist$ in paths
|-
| @artist@ || The name of the track artist. Use $artist$ in paths
|-
| @album@ || The name of the album. Use $album$ in paths
|-
| @title@ || The song title. Use $title$ in paths
|-
| @track@ || The track number. Use $track$ to zero-pad the track number, i.e.: turn 9 into 09
|-
| @numtracks@ || The total number of tracks
|-
| @islast@ || Whether the current track is the last, for track mode
|-
| @genre@ || The album genre. Use $genre$ in paths
|-
| @year@ || The album year
|-
| @comment@ || The comment. Use $comment$ in paths
|-
| @freedbid@ || The [[freedb]] ID
|-
| ||
|-
| '''OTHER''' ||
|-
| @crc@ || The [[CRC]] of the file
|-
| @bitrate@ || The value of the '''Bitrate''' dropdown on EAC's External Compressor dialogue
|-
| @curdate@ || The current date
|}

=Global INI Keys=

The first section of the REACT INI sets some global keys, which can be used in any or all encoder configs. These variables refer to high level settings, like the path to [[Exact Audio Copy|EAC]], rather than encoder-specific settings.

Here is an example:

<pre>
Config=FLAC
EAC=C:\Program Files\Exact Audio Copy\EAC.exe
musicdir=C:\My Music
encdir=C:\Program Files\REACT\Encoders
LogFile=react.txt
CodePage=1252
MinimizeCompressionWindow=1
ProcessPriority=1
TracksHotkey={F4}
SaveTracksCuesheets=0
ImageHotkey={F10}
ImageNaming=$artist$ - $album$
AutoCloseSaveImageDialog=0
Sla_Bks_Col_Qst_Bar_Quo_Ast_Lt_Gt=-|-|-||!|'|#|[|]
Version=0.999
Debug=0
</pre>

==A Few Of The Important INI Keys==

Some of the keys are obvious, and some you really don't need to bother with unless you are a REACT Ninja, but here's a few to watch out for:

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| Config || The encoder config file that REACT should process in the Config folder.
|-
| musicdir || The root directory for all your music. If you are encoding to "C:\My Music\WavPack" and "C:\My Music\MP3" then you can set musicdir to "C:\My Music" and use this variable when setting your @destdirN@ variables. this helps maintain clarity within your INI file.
|-
| encdir || REACT installs many encoders in a folder called "Encoders". Again, this variable can be used when referencing these applications, to maintain clarity.
|-
| LogFile || If you set a value to this variable a REACT log will be created with that name, e.g.: react.txt. If left blank no log will be written. This does not affect [[Exact Audio Copy|EAC]]'s log file.
|-
| SaveTracksCuesheets || If set to 1, all four availabe types of cuesheets will be saved to the extraction directory, which must be preconfigured in EAC. This only happens when pressing F4, or whatever the key TracksHotkey is set to. The cuesheet base name can be accessed using the @trackscuesheet@ variable.
|-
| ImageNaming || This variable detirmines how image files, and their cuesheets, will be named when REACT is used in image mode. You can use meta data variables here, e.g.: "$artist$ - $album$" to name the image using the artist and album name (filename-friendly values).
|-
| AutoCloseSaveImageDialog || If set to 1, when pressing F10, the save image wavform dialog will close automatically and the name generated using ImageNaming is used.
|-
| Sla_Bks_Col_Qst_Bar_Quo_Ast_Lt_Gt || Some characters cannot be used in file or folder names. This variable allows you to specify what these characters should be replaced with. Slash; Backslash; Colon; Question Mark; Bar (Pipe); Quotes; Asterisk; Less Than; Greater Than. It is also possible to convert Space to e.g. _ by appending a Bar and a _ (after the Gt convert character).
|-
| Debug || If you are having problems with your config file setup, set this value to 1. REACT will then pause before exiting, so you can examine the console output to attempt to determine where your process fell down.
|}

=The Encoder Config Files=

The initial REACT INI contains a global settings section. This contains a key named Config=<ENCODER> which refers to configuration files in the Config folder. There are two config files for each encoding; one for ripping to track files, and one for ripping to an image with cuesheet.

The config files are stored in <REACT dir>\Config folder, and are named:

<ENCODER>-tracks.txt

<ENCODER>-image.txt

The first part, '''ENCODER''', is simply a unique name which indentifies the encoder tasks; however it makes sense to use the name of the encoder being used, like "FLAC" or "WAVPACK". This part of the section header is referred to by the global variable, '''[[REACT#A_Few_Of_The_Important_Ones|Config]]'''.

The second part (tracks or image) describes whether to perform when ripping to '''tracks''', or to an '''image'''.

The encoder section consists of two parts:

==Variable Initialisation==

In the beginning of each config file you can set some variables.

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| !Description || A description of the processes within the section.
|-
| !ImageExt || The file extension of the image file, e.g.: "wv". Image sections only.
|-
| !CuesheetExt || The extension given to the cuesheet by [[Exact Audio Copy|EAC]], e.g.: ".wv.cue". Image sections only.
|-
|!WaveGainAnalysis || Set to 1 to enable a pre-run WaveGain analysis. Makes variables @gain@, @peak@ and @scale@ available for config scripts.
|}

It is likely that you will also need to set file and folder path variables, like @destN@ and @destdirN@. E.g.:

<pre>destdir1=@musicdir@\FLAC\$cdartist$\($year$) $album$
dest1=@destdir1@\$track$ - $title$</pre>

The above will set the folder path @destdir1@ using the global variable @musicdir@, and artist, year and album meta data. It then sets the file path @dest1@ using @destdir1@ and the track and title meta data. So, considering the following values for those variables:

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| musicdir|| C:\My Music
|-
| albumartist|| Ben Folds Five
|-
| album|| Whatever and Ever Amen
|-
| year|| 2000
|-
| track|| 03
|-
| title|| Brick
|}

... we end up with:

<pre>destdir1=C:\My Music\FLAC\Ben Folds Five\(2000) Whatever and Ever Amen
dest1=C:\My Music\FLAC\Ben Folds Five\(2000) Whatever and Ever Amen\03 - Brick</pre>

Obviously the values of $track$ and $title$ will change per track. Remember, $track$ will zero-pad the track number.

==Config Tasks==

Each line '''not''' starting with a "!" will be part of the config task script.

The task script is simply a list of command line statements, utilising the variables that REACT exposes within the code.

As an example, here is the default LAME-tracks.txt file. Notice that all REACT variables are surrounded by two ampersands (@), or two dollar signs ($); all other code is standard DOS command line syntax. With this in mind you will find working with REACT a lot easier if you are happy executing applications from the command line, more so if you have an understanding of batch files or command line scripting (what I think of as 'DOS scripts').

LAME-tracks.txt:
<pre>!Description=LAME -V2 mp3 track files, RG album gain, APE2 and id3v1 tags
!destdir1=@musicdir@\MP3\$cdartist$\($year$) $album$
!dest1=@destdir1@\$track$ - $title$
!Various-dest1=@destdir1@\$track$ - $title$ ($artist$)

echo.> "@dest1@.mp3.tmp"
@encdir@\Tag.exe --nocheck --ape2 -t "ARTIST=@artist@" -t "ALBUM=@album@" -t "TRACK=@track@" -t "TITLE=@title@" -t "YEAR=@year@" -t "GENRE=@genre@" -t "TOTALTRACKS=@numtracks@" -t "FREEDB=@freedbid@" -t "CRC=@crc@" "@dest1@.mp3.tmp"
move "@source@" "@dest1@.wav"
if @islast@==0 goto end
cd /d "@destdir1@"
move "@eaclog@" "EAC_log.txt"
@encdir@\WaveGain.exe -a *.wav --exec @encdir@\lame.exe -V2 --vbr-new --scale %%ALBUM_SCALE%% --tc "AG appl:%%ALBUM_GAIN%%,TG:%%TRACK_GAIN%% dB" "%%INPUT_NAME%%.wav" "%%INPUT_NAME%%.mp3"
for %%i in (*.mp3) do @encdir@\Tag.exe --force id3v1 --force ape2 --fromfile "%%i.tmp" "%%i"
del "*.mp3.tmp" "*.wav"
:end</pre>

=Links=

Ask REACT questions in this thread : http://www.hydrogenaudio.org/forums/index.php?showtopic=35158

Download REACT from this thread : http://www.hydrogenaudio.org/forums/index.php?showtopic=36261

REACT

2006-04-28T20:40:05Z

Tycho:

REACT ('''R'''un '''EAC''' '''T'''asks) can be used in conjunction with [[Exact Audio Copy]] (EAC), as an external compressor.

It is, however, not an encoder, but an interim application that provides a scripting facility to call muliple encoders or pre-/post-encoding applications to process the [[WAV|WAVE]] files created by [[Exact Audio Copy|EAC]], or the files created by the script itself. '''In short''', REACT allows you to run multiple tasks on the audio extracted, instead of only one.

REACT integrates with [[Exact Audio Copy]], adding some hotkeys combinations to access often used functions more quickly. It will also alter the default name for image files according to your INI settings, and close the extraction dialogue in order for the logfile to be created and used from within your script. It can auto-configure [[Exact Audio Copy|EAC]], updating the external compression options so that [[Exact Audio Copy|EAC]] is ready to run REACT immediately. This feature is extremely useful for novice users.

REACT is configured using an INI file and config files. The commands used within the config files are command line/DOS commands, with the addition of numerous variables which REACT makes available. For example, any instance of '''@artist@''' in the script will be replaced by the [[freedb]] artist name, while '''$artist$''' will be replaced with a ''filename-friendly'' version of the artist name (with illegal characters replaced according to your requirements).

=Available Variables=

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| '''PATHS''' ||
|-
| @reactdir@ || The path to the directory in which REACT resides
|-
| @encdir@ || The path to the directory in which the encoders reside. Set within the INI file
|-
| @mydocumentsdir@ || The path to your My Documents folder
|-
| @musicdir@ || The path to your music folder. Set within the INI file. Used as a root for other paths
|-
| @sourcedir@ || The path to the folder in which the source files are located ([[WAV]]/LOG/CUE)
|-
| @basename@ || The name of the file being created, excluding extension
|-
| @destbase@ || @destbase@ was deprecated in 0.997. Use @sourcedir@\@basename@ instead
|-
| @removabledriveN@ || The path to your removable drive number N. Set within the INI file
|-
| @destdirN@ || Directory path N used within your script. Set within the INI file
|-
| @destN@ || File path N, used within your script. Set within the INI file (encoder track section)
|-
| @Various-destN@ || The file path to use if it is a Various Artists CD. Set within the INI file (encoder track section)
|-
| @source@ || The path to the temporary source [[WAV|WAVE]] file
|-
| @image@ || The path to the final image file, when used in '''Copy Image''' mode
|-
| @sourcecuesheet@ || The path to the (temporary) source [[Cuesheet|cuesheet]], when used in '''Copy Image''' mode
|-
| @cuesheet@ || The path to the final [[Cuesheet|cuesheet]], when used in '''Copy Image''' mode
|-
| @eaclog@ || The path to the log file created by [[Exact Audio Copy|EAC]]
|-
| @trackscuesheet@ || (from v0.999) The path to the cuesheet files without extension, created by [[Exact Audio Copy|EAC]] when hitting F4 and SaveAllCuesheets=1 in the INI file. E.g, "@trackscuesheet@.[mg].cue" is the multiple wav files cuesheet with gaps.
|-
| ||
|-
| '''METADATA''' ||
|-
| @cdartist@ || The name of the CD artist. Use $cdartist$ in paths
|-
| @artist@ || The name of the track artist. Use $artist$ in paths
|-
| @album@ || The name of the album. Use $album$ in paths
|-
| @title@ || The song title. Use $title$ in paths
|-
| @track@ || The track number. Use $track$ to zero-pad the track number, i.e.: turn 9 into 09
|-
| @numtracks@ || The total number of tracks
|-
| @islast@ || Whether the current track is the last, for track mode
|-
| @genre@ || The album genre. Use $genre$ in paths
|-
| @year@ || The album year
|-
| @comment@ || The comment. Use $comment$ in paths
|-
| @freedbid@ || The [[freedb]] ID
|-
| ||
|-
| '''OTHER''' ||
|-
| @crc@ || The [[CRC]] of the file
|-
| @bitrate@ || The value of the '''Bitrate''' dropdown on EAC's External Compressor dialogue
|-
| @curdate@ || The current date
|}

=Global INI Keys=

The first section of the REACT INI sets some global keys, which can be used in any or all encoder configs. These variables refer to high level settings, like the path to [[Exact Audio Copy|EAC]], rather than encoder-specific settings.

Here is an example:

<pre>
Config=FLAC
EAC=C:\Program Files\Exact Audio Copy\EAC.exe
musicdir=C:\My Music
encdir=C:\Program Files\REACT\Encoders
LogFile=react.txt
CodePage=1252
MinimizeCompressionWindow=1
ProcessPriority=1
TracksHotkey={F4}
SaveTracksCuesheets=0
ImageHotkey={F10}
ImageNaming=$artist$ - $album$
Sla_Bks_Col_Qst_Bar_Quo_Ast_Lt_Gt=-|-|-||!|'|#|[|]
Version=0.999
Debug=0
</pre>

==A Few Of The Important INI Keys==

Some of the keys are obvious, and some you really don't need to bother with unless you are a REACT Ninja, but here's a few to watch out for:

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| Config || The encoder section that REACT should process. This will only be effective if the [[Exact Audio Copy|EAC]] command line begins with the parameter "REACT". You could, instead, amend the command line parameter to the section prefix, e.g.: "FLAC".
|-
| musicdir || The root directory for all your music. If you are encoding to "C:\My Music\WavPack" and "C:\My Music\MP3" then you can set musicdir to "C:\My Music" and use this variable when setting your @destdirN@ variables. this helps maintain clarity within your INI file.
|-
| encdir || REACT installs many encoders in a folder called "Encoders". Again, this variable can be used when referencing these applications, to maintain clarity.
|-
| LogFile || If you set a value to this variable a REACT log will be created with that name, e.g.: react.txt. If left blank no log will be written. This does not affect [[Exact Audio Copy|EAC]]'s log file.
|-
| SaveTracksCuesheets || If set to 1, all four availabe types of cuesheets will be saved to the extraction directory, which must be preconfigured in EAC. This only happens when pressing F4, or whatever the key TracksHotkey is set to. The cuesheet base name can be accessed using the @trackscuesheet@ variable.
|-
| ImageNaming || This variable detirmines how image files, and their cuesheets, will be named when REACT is used in image mode. You can use meta data variables here, e.g.: "$artist$ - $album$" to name the image using the artist and album name (filename-friendly values).
|-
| Sla_Bks_Col_Qst_Bar_Quo_Ast_Lt_Gt || Some characters cannot be used in file or folder names. This variable allows you to specify what these characters should be replaced with. Slash; Backslash; Colon; Question Mark; Bar (Pipe); Quotes; Asterisk; Less Than; Greater Than. It is also possible to convert Space to e.g. _ by appending a Bar and a _ (after the Gt convert character).
|-
| Debug || If you are having problems with your config file setup, set this value to 1. REACT will then pause before exiting, so you can examine the console output to attempt to determine where your process fell down.
|}

=The Encoder Config Files=

The initial REACT INI contains a global settings section. This contains a key named Config=<ENCODER> which refers to configuration files in the Config folder. There are two config files for each encoding; one for ripping to track files, and one for ripping to an image with cuesheet.

The config files are stored in <REACT dir>\Config folder, and are named:

<ENCODER>-tracks.txt

<ENCODER>-image.txt

The first part, '''ENCODER''', is simply a unique name which indentifies the encoder tasks; however it makes sense to use the name of the encoder being used, like "FLAC" or "WAVPACK". This part of the section header is referred to by the global variable, '''[[REACT#A_Few_Of_The_Important_Ones|Config]]'''.

The second part (tracks or image) describes whether to perform when ripping to '''tracks''', or to an '''image'''.

The encoder section consists of two parts:

==Variable Initialisation==

In the beginning of each config file you should set variables relative to that config.

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| !Description || A description of the processes within the section.
|-
| !ImageExt || The file extension of the image file, e.g.: "wv". Image sections only.
|-
| !CuesheetExt || The extension given to the cuesheet by [[Exact Audio Copy|EAC]], e.g.: ".wv.cue". Image sections only.
|-
|!WaveGainAnalysis || Set to 1 to enable a pre-run WaveGain analysis. Makes variables @gain@, @peak@ and @scale@ available for config scripts.
|}

It is likely that you will also need to set file and folder path variables, like @destN@ and @destdirN@. E.g.:

<pre>destdir1=@musicdir@\FLAC\$cdartist$\($year$) $album$
dest1=@destdir1@\$track$ - $title$</pre>

The above will set the folder path @destdir1@ using the global variable @musicdir@, and artist, year and album meta data. It then sets the file path @dest1@ using @destdir1@ and the track and title meta data. So, considering the following values for those variables:

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| musicdir|| C:\My Music
|-
| albumartist|| Ben Folds Five
|-
| album|| Whatever and Ever Amen
|-
| year|| 2000
|-
| track|| 03
|-
| title|| Brick
|}

... we end up with:

<pre>destdir1=C:\My Music\FLAC\Ben Folds Five\(2000) Whatever and Ever Amen
dest1=C:\My Music\FLAC\Ben Folds Five\(2000) Whatever and Ever Amen\03 - Brick</pre>

Obviously the values of $track$ and $title$ will change per track. Remember, $track$ will zero-pad the track number.

==Config Tasks==

Each line '''not''' starting with a "!" will be part of the config task script.

The task script is simply a list of command line statements, utilising the variables that REACT exposes within the code.

As an example, here is the default LAME-tracks.txt file. Notice that all REACT variables are surrounded by two ampersands (@), or two dollar signs ($); all other code is standard DOS command line syntax. With this in mind you will find working with REACT a lot easier if you are happy executing applications from the command line, more so if you have an understanding of batch files or command line scripting (what I think of as 'DOS scripts').

LAME-tracks.txt:
<pre>!Description=LAME -V2 mp3 track files, RG album gain, APE2 and id3v1 tags
!destdir1=@musicdir@\MP3\$cdartist$\($year$) $album$
!dest1=@destdir1@\$track$ - $title$
!Various-dest1=@destdir1@\$track$ - $title$ ($artist$)

echo.> "@dest1@.mp3.tmp"
@encdir@\Tag.exe --nocheck --ape2 -t "ARTIST=@artist@" -t "ALBUM=@album@" -t "TRACK=@track@" -t "TITLE=@title@" -t "YEAR=@year@" -t "GENRE=@genre@" -t "TOTALTRACKS=@numtracks@" -t "FREEDB=@freedbid@" -t "CRC=@crc@" "@dest1@.mp3.tmp"
move "@source@" "@dest1@.wav"
if @islast@==0 goto end
cd /d "@destdir1@"
move "@eaclog@" "EAC_log.txt"
@encdir@\WaveGain.exe -a *.wav --exec @encdir@\lame.exe -V2 --vbr-new --scale %%ALBUM_SCALE%% --tc "AG appl:%%ALBUM_GAIN%%,TG:%%TRACK_GAIN%% dB" "%%INPUT_NAME%%.wav" "%%INPUT_NAME%%.mp3"
for %%i in (*.mp3) do @encdir@\Tag.exe --force id3v1 --force ape2 --fromfile "%%i.tmp" "%%i"
del "*.mp3.tmp" "*.wav"
:end</pre>

=Links=

Ask REACT questions in this thread : http://www.hydrogenaudio.org/forums/index.php?showtopic=35158

Download REACT from this thread : http://www.hydrogenaudio.org/forums/index.php?showtopic=36261

REACT

2006-04-28T17:30:53Z

Tycho: Update from v0.997 to 0.999

REACT ('''R'''un '''EAC''' '''T'''asks) can be used in conjunction with [[Exact Audio Copy]] (EAC), as an external compressor.

It is, however, not an encoder, but an interim application that provides a scripting facility to call muliple encoders or pre-/post-encoding applications to process the [[WAV|WAVE]] files created by [[Exact Audio Copy|EAC]], or the files created by the script itself. '''In short''', REACT allows you to run multiple tasks on the audio extracted, instead of only one.

REACT integrates with [[Exact Audio Copy]], adding some hotkeys combinations to access often used functions more quickly. It will also alter the default name for image files according to your INI settings, and close the extraction dialogue in order for the logfile to be created and used from within your script. It can auto-configure [[Exact Audio Copy|EAC]], updating the external compression options so that [[Exact Audio Copy|EAC]] is ready to run REACT immediately. This feature is extremely useful for novice users.

REACT is configured using an INI file and config files. The commands used within the config files are command line/DOS commands, with the addition of numerous variables which REACT makes available. For example, any instance of '''@artist@''' in the script will be replaced by the [[freedb]] artist name, while '''$artist$''' will be replaced with a ''filename-friendly'' version of the artist name (with illegal characters replaced according to your requirements).

=Available Variables=

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| '''PATHS''' ||
|-
| @reactdir@ || The path to the directory in which REACT resides
|-
| @encdir@ || The path to the directory in which the encoders reside. Set within the INI file
|-
| @mydocumentsdir@ || The path to your My Documents folder
|-
| @musicdir@ || The path to your music folder. Set within the INI file. Used as a root for other paths
|-
| @sourcedir@ || The path to the folder in which the source files are located ([[WAV]]/LOG/CUE)
|-
| @basename@ || The name of the file being created, excluding extension
|-
| @destbase@ || @destbase@ was deprecated in 0.997. Use @sourcedir@\@basename@ instead
|-
| @removabledriveN@ || The path to your removable drive number N. Set within the INI file
|-
| @destdirN@ || Directory path N used within your script. Set within the INI file
|-
| @destN@ || File path N, used within your script. Set within the INI file (encoder track section)
|-
| @Various-destN@ || The file path to use if it is a Various Artists CD. Set within the INI file (encoder track section)
|-
| @source@ || The path to the temporary source [[WAV|WAVE]] file
|-
| @image@ || The path to the final image file, when used in '''Copy Image''' mode
|-
| @sourcecuesheet@ || The path to the (temporary) source [[Cuesheet|cuesheet]], when used in '''Copy Image''' mode
|-
| @cuesheet@ || The path to the final [[Cuesheet|cuesheet]], when used in '''Copy Image''' mode
|-
| @eaclog@ || The path to the log file created by [[Exact Audio Copy|EAC]]
|-
| @trackscuesheets@ || (from v0.999) The path to the cuesheet files without extension, created by [[Exact Audio Copy|EAC]] when hitting F4 and SaveAllCuesheets=1 in the INI file. E.g, "@trackscuesheets@.[mg].cue" is the multiple wav files cuesheet with gaps.
|-
| ||
|-
| '''METADATA''' ||
|-
| @cdartist@ || The name of the CD artist. Use $cdartist$ in paths
|-
| @artist@ || The name of the track artist. Use $artist$ in paths
|-
| @album@ || The name of the album. Use $album$ in paths
|-
| @title@ || The song title. Use $title$ in paths
|-
| @track@ || The track number. Use $track$ to zero-pad the track number, i.e.: turn 9 into 09
|-
| @numtracks@ || The total number of tracks
|-
| @islast@ || Whether the current track is the last, for track mode
|-
| @genre@ || The album genre. Use $genre$ in paths
|-
| @year@ || The album year
|-
| @comment@ || The comment. Use $comment$ in paths
|-
| @freedbid@ || The [[freedb]] ID
|-
| ||
|-
| '''OTHER''' ||
|-
| @crc@ || The [[CRC]] of the file
|-
| @bitrate@ || The value of the '''Bitrate''' dropdown on EAC's External Compressor dialogue
|-
| @curdate@ || The current date
|}

=Global INI Variables=

The first section of the REACT INI sets some global variables, which can be used in any or all encoder configs. These variables refer to high level settings, like the path to [[Exact Audio Copy|EAC]], rather than encoder-specific settings.

Here is an example:

<pre>
Config=FLAC
EAC=C:\Program Files\Exact Audio Copy\EAC.exe
musicdir=C:\My Music
encdir=C:\Program Files\REACT\Encoders
LogFile=react.txt
CodePage=1252
MinimizeCompressionWindow=1
ProcessPriority=1
TracksHotkey={F4}
SaveTracksCuesheets=0
ImageHotkey={F10}
ImageNaming=$artist$ - $album$
Sla_Bks_Col_Qst_Bar_Quo_Ast_Lt_Gt=-|-|-||!|'|#|[|]
Version=0.999
Debug=0
</pre>

==A Few Of The Important Ones==

Some of the variables are obvious, and some you really don't need to bother with unless you are a REACT Ninja, but here's a few to watch out for:

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| Config || The encoder section that REACT should process. This will only be effective if the [[Exact Audio Copy|EAC]] command line begins with the parameter "REACT". You could, instead, amend the command line parameter to the section prefix, e.g.: "FLAC".
|-
| musicdir || The root directory for all your music. If you are encoding to "C:\My Music\WavPack" and "C:\My Music\MP3" then you can set musicdir to "C:\My Music" and use this variable when setting your @destdirN@ variables. this helps maintain clarity within your INI file.
|-
| encdir || REACT installs many encoders in a folder called "Encoders". Again, this variable can be used when referencing these applications, to maintain clarity.
|-
| LogFile || If you set a value to this variable a REACT log will be created with that name, e.g.: react.txt. If left blank no log will be written. This does not affect [[Exact Audio Copy|EAC]]'s log file.
|-
| ImageNaming || This variable detirmines how image files, and their cuesheets, will be named when REACT is used in image mode. You can use meta data variables here, e.g.: "$artist$ - $album$" to name the image using the artist and album name (filename-friendly values).
|-
| Sla_Bks_Col_Qst_Bar_Quo_Ast_Lt_Gt || Some characters cannot be used in file or folder names. This variable allows you to specify what these characters should be replaced with. Slash; Backslash; Colon; Question Mark; Bar (Pipe); Quotes; Asterisk; Less Than; Greater Than. It is also possible to convert Space to e.g. _ by appending a Bar and a _ (after the Gt convert character).
|-
| Debug || If you are having problems with your INI file setup set this value to 1. REACT will then pause before exiting, so you can examine the console output to attempt to determine where your process fell down.
|}

=The Encoder Config Files=

The initial REACT INI contains a global settings section. This contains a key named Config=<ENCODER> which refers to configuration files in the Config folder. There are two config files for each encoding; one for ripping to track files, and one for ripping to an image with cuesheet.

The config files are stored in <REACT dir>\Config folder, and are named:

<ENCODER>-tracks.txt

<ENCODER>-image.txt

The first part, '''ENCODER''', is simply a unique name which indentifies the encoder tasks; however it makes sense to use the name of the encoder being used, like "FLAC" or "WAVPACK". This part of the section header is referred to by the global variable, '''[[REACT#A_Few_Of_The_Important_Ones|Config]]'''.

The second part (tracks or image) describes whether to perform when ripping to '''tracks''', or to an '''image'''.

The encoder section consists of two parts:

==Variable Initialisation==

In the beginning of each config file you should set variables relative to that config.

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| !Description || A description of the processes within the section.
|-
| !ImageExt || The file extension of the image file, e.g.: "wv". Image sections only.
|-
| !CuesheetExt || The extension given to the cuesheet by [[Exact Audio Copy|EAC]], e.g.: ".wv.cue". Image sections only.
|}

It is likely that you will also need to set file and folder path variables, like @destN@ and @destdirN@. E.g.:

<pre>destdir1=@musicdir@\FLAC\$cdartist$\($year$) $album$
dest1=@destdir1@\$track$ - $title$</pre>

The above will set the folder path @destdir1@ using the global variable @musicdir@, and artist, year and album meta data. It then sets the file path @dest1@ using @destdir1@ and the track and title meta data. So, considering the following values for those variables:

{| border="0" cellpadding="0" cellspacing="4"
! style=padding-right:24px;| Variable || Description
|-
| musicdir|| C:\My Music
|-
| albumartist|| Ben Folds Five
|-
| album|| Whatever and Ever Amen
|-
| year|| 2000
|-
| track|| 03
|-
| title|| Brick
|}

... we end up with:

<pre>destdir1=C:\My Music\FLAC\Ben Folds Five\(2000) Whatever and Ever Amen
dest1=C:\My Music\FLAC\Ben Folds Five\(2000) Whatever and Ever Amen\03 - Brick</pre>

Obviously the values of $track$ and $title$ will change per track. Remember, $track$ will zero-pad the track number.

==Config Tasks==

Each line '''not''' starting with a "!" will be part of the config task script.

The task script is simply a list of command line statements, utilising the variables that REACT exposes within the code.

As an example, here is the default LAME-tracks.txt file. Notice that all REACT variables are surrounded by two ampersands (@), or two dollar signs ($); all other code is standard DOS command line syntax. With this in mind you will find working with REACT a lot easier if you are happy executing applications from the command line, more so if you have an understanding of batch files or command line scripting (what I think of as 'DOS scripts').

LAME-tracks.txt:
<pre>!Description=LAME -V2 mp3 track files, RG album gain, APE2 and id3v1 tags
!destdir1=@musicdir@\MP3\$cdartist$\($year$) $album$
!dest1=@destdir1@\$track$ - $title$
!Various-dest1=@destdir1@\$track$ - $title$ ($artist$)

echo.> "@dest1@.mp3.tmp"
@encdir@\Tag.exe --nocheck --ape2 -t "ARTIST=@artist@" -t "ALBUM=@album@" -t "TRACK=@track@" -t "TITLE=@title@" -t "YEAR=@year@" -t "GENRE=@genre@" -t "TOTALTRACKS=@numtracks@" -t "FREEDB=@freedbid@" -t "CRC=@crc@" "@dest1@.mp3.tmp"
move "@source@" "@dest1@.wav"
if @islast@==0 goto end
cd /d "@destdir1@"
move "@eaclog@" "EAC_log.txt"
@encdir@\WaveGain.exe -a *.wav --exec @encdir@\lame.exe -V2 --vbr-new --scale %%ALBUM_SCALE%% --tc "AG appl:%%ALBUM_GAIN%%,TG:%%TRACK_GAIN%% dB" "%%INPUT_NAME%%.wav" "%%INPUT_NAME%%.mp3"
for %%i in (*.mp3) do @encdir@\Tag.exe --force id3v1 --force ape2 --fromfile "%%i.tmp" "%%i"
del "*.mp3.tmp" "*.wav"
:end</pre>

=Links=

Ask REACT questions in this thread : http://www.hydrogenaudio.org/forums/index.php?showtopic=35158

Download REACT from this thread : http://www.hydrogenaudio.org/forums/index.php?showtopic=36261