Hydrogenaudio Knowledgebase - User contributions [en]

User:Synthetic Soul

2011-04-19T13:08:50Z

Synthetic Soul: /* Settings */ Added MP3Gain, 97dB Track Gain, used to boost podcast volume for iPod/crappy headphones.

=Personal=
My name is Neil Popham. I live in the city of Exeter in the United Kingdom.

I am married to Lucy, and am the very proud father of Tilly, Romy, and Jasper.

I am currently employed as a web developer, mainly working with PHP and PostgreSQL.

I first got involved with Hydrogen Audio after I decided to back up all my [[CD]]s. I hung around the forums for a while, asked a few questions, and have been lingering ever since.

=Methodologies=

I am currently using [[WavPack]] images with accompanying cuesheets to archive my CDs. Archives are stored on both [[DVD]] and a 300GB hardrive. I also store [[PAR2]] parity data on the DVDs, which is created for each image individually. I've yet to see whether this is a good method. I use [[EAC]] to rip the audio, in conjunction with [[REACT]].

I get very little time to actually listen to my music! The main opportunity I get is walking to and from work, listening on my iPod Nano. I encode my music using [[LAME]] [[LAME#VBR_.28variable_bitrate.29_settings|-V5 --vbr-new]], and find the quality perfectly adequate. Still, I was very glad to see that [http://www.hydrogenaudio.org/forums/index.php?showtopic=40607 the latest ~128kbps comparison] proved that many people found the setting (near) transparent. Up until that time I had felt a little inadequate...

=Contributions=

My contributions have so far been quite minimal. I try to make up for this by answering as many of the easy questions as I can, so that the real stars can spend their time discussing the meaty questions. It also makes me look more knowledgeable than I am.

==[[Tag_(tagger)|Tag]] and [[Wapet]]==
Before using [[WavPack]] I used [[Monkey's Audio]]. In order for me to be able to automate my archiving process I found it necessary to adapt Case's [[Tag_(tagger)|Tag]] so that I could set tags from the contents of a text file - namely a cuesheet.

I'd never programmed any C(++) before and found the whole episode both immensely frustrating and incredibly satisfying.

I added the same functionality to Case's [[Wapet]], as I thought it may be useful in the future.

There seemed little interest at the time, but both applications are now used by various other third party applications, such as [[FLACAttack]] and [[REACT]].

==foo_cuesheetcreator==
foo_cuesheetcreator was originally created by Revision17 as a proof of concept.

I had been looking for a component to create cuesheets from a playlist for a while, and was amazed that I had not see it before. However there were some flaws with the component, e.g.: frames being calculated as 1/60th of a second rather than 1/75th and meta data tags being case sensitive, so I adapted it into a usable component.

==Diskwriter With Cuesheet Support==

I adapted [[Foobar2000]] 0.8.3's Diskwriter component so that as well as merging tracks into one single file you could also choose to create an accompanying cuesheet generated using the playlist information.

Since 0.9 beta 6 the same functionality has been included in [[Foobar2000]] 0.9. Of course Peter's implementation has more functionality, e.g.: the automatic embedding of the cuesheet in files that support it, and a similar facility using chapters in [[MP4]] files.

==Moderation==

In February 2006 I was offered the position of moderator, which I accepted. It seemed only fair that I give something back to the community which had helped me so much, and generally offered such entertainment. I think the offer was made mainly on the fact that I spent way too long hanging around the forum, and that I was in a useful time zone. Now, there's qualifications for you. ;)

=Settings=

For your information, and my record. :-)

===Converter and 'Move, Rename or Copy Files'===

[%album artist%\][%album%\]$ifgreater(%totaldiscs%,1,Disc %discnumber%\,)[%tracknumber% - ]%title%[' ('%track artist%')']

... or, allowing for multiple artists:

[$if($meta_test(album artist),$meta_sep(album artist,', ',' And '),$meta_sep(artist,', ',' And '))\][%album%\]$ifgreater(%totaldiscs%,1,Disc %discnumber%\,)[%tracknumber% - ]%title%[' ('$if($meta_test(album artist),$meta_sep(artist,', ',' And '),)')']

===ColumnsUI Album Column Display===

[%album%]
[ ' ('%album subtitle%')']
[' ('%discname%')']
$if($greater(%totaldiscs%,1),[' ('Disc %discnumber%')'])

===Run Service > Album Art===

"C:\Program Files\AlbumArtDownloaderXUI\AlbumArt.exe" /artist "%artist%" /album "%album%" /path
"$replace(%_path%,%_filename_ext%,)folder.jpg" /sources "GoogleImage,Album Art Exchange,Amazon (.com)"
/minSize 450 /maxSize 650 /sort size-

===Run Service > MP3Gain, 97dB Track Gain===

"C:\Program Files\MP3Gain\mp3gain.exe" /r /d 8 /c /t /p /s s "%_path%"

=Links=
* My website : http://www.synthetic-soul.co.uk/
* Tag
** My version : http://www.synthetic-soul.co.uk/tag/
** Case's original : http://www.rarewares.org/others.html
* Wapet
** My version : http://www.synthetic-soul.co.uk/wapet/
** Case's original : http://www.rarewares.org/others.html
* foo_cuesheetcreator : http://www.hydrogenaudio.org/forums/index.php?showtopic=26276
* Diskwriter With Cuesheet Support : http://www.hydrogenaudio.org/forums/index.php?showtopic=35275

APEv1 specification

2010-07-30T10:00:07Z

Synthetic Soul: Noted that APEv1 may not be used at the beginning of a file.

This is how information is laid out in an [[APEv1]] tag:

The only difference between APEv1 and [[APEv2]] is that APEv1 has no header. Therefore, it is strongly recommended that developers adopt v2 instead of v1 as standard tagging system for their formats.

{| border="1" cellspacing="1"
|width="120px"| [[APE Tag Item]] 1 ||width="80px"| 10.. bytes
|-
|[[APE Tag Item]] 2 || 10.. bytes
|-
|... || 10.. bytes
|-
|[[APE Tag Item]] n-1 || 10.. bytes
|-
|[[APE Tag Item]] n || 10.. bytes
|-
|[[APE Tags Header|APE Tags Footer]] || 32 bytes
|}

APE tag items should be sorted ascending by size. When streaming, parts of the APE tags can be dropped to reduce danger of drop outs between titles. This is not a ''must'', but ''strongly'' recommended. Actually the items should be sorted by importance/byte, but this is not feasible. Only break this rule if you add less important small items and you don't want to rewrite the whole tag. An APEv1 tag at the end of a file must have at least a footer, APEv1 tags may never be used at the beginning of a file (unlike [[APEv2]] tags).
When located at the end of an [[MP3]] file, an APE tag should be placed after the the last frame, just before the [[ID3v1]] tag (if any).

[[Category:Metadata]]

User:Synthetic Soul

2010-01-06T14:15:51Z

Synthetic Soul: /* Settings */

=Personal=
My name is Neil Popham. I live in the city of Exeter in the United Kingdom.

I am married to Lucy, and am the very proud father of Tilly, Romy, and Jasper.

I am currently employed as a web developer, mainly working with PHP and PostgreSQL.

I first got involved with Hydrogen Audio after I decided to back up all my [[CD]]s. I hung around the forums for a while, asked a few questions, and have been lingering ever since.

=Methodologies=

I am currently using [[WavPack]] images with accompanying cuesheets to archive my CDs. Archives are stored on both [[DVD]] and a 300GB hardrive. I also store [[PAR2]] parity data on the DVDs, which is created for each image individually. I've yet to see whether this is a good method. I use [[EAC]] to rip the audio, in conjunction with [[REACT]].

I get very little time to actually listen to my music! The main opportunity I get is walking to and from work, listening on my iPod Nano. I encode my music using [[LAME]] [[LAME#VBR_.28variable_bitrate.29_settings|-V5 --vbr-new]], and find the quality perfectly adequate. Still, I was very glad to see that [http://www.hydrogenaudio.org/forums/index.php?showtopic=40607 the latest ~128kbps comparison] proved that many people found the setting (near) transparent. Up until that time I had felt a little inadequate...

=Contributions=

My contributions have so far been quite minimal. I try to make up for this by answering as many of the easy questions as I can, so that the real stars can spend their time discussing the meaty questions. It also makes me look more knowledgeable than I am.

==[[Tag_(tagger)|Tag]] and [[Wapet]]==
Before using [[WavPack]] I used [[Monkey's Audio]]. In order for me to be able to automate my archiving process I found it necessary to adapt Case's [[Tag_(tagger)|Tag]] so that I could set tags from the contents of a text file - namely a cuesheet.

I'd never programmed any C(++) before and found the whole episode both immensely frustrating and incredibly satisfying.

I added the same functionality to Case's [[Wapet]], as I thought it may be useful in the future.

There seemed little interest at the time, but both applications are now used by various other third party applications, such as [[FLACAttack]] and [[REACT]].

==foo_cuesheetcreator==
foo_cuesheetcreator was originally created by Revision17 as a proof of concept.

I had been looking for a component to create cuesheets from a playlist for a while, and was amazed that I had not see it before. However there were some flaws with the component, e.g.: frames being calculated as 1/60th of a second rather than 1/75th and meta data tags being case sensitive, so I adapted it into a usable component.

==Diskwriter With Cuesheet Support==

I adapted [[Foobar2000]] 0.8.3's Diskwriter component so that as well as merging tracks into one single file you could also choose to create an accompanying cuesheet generated using the playlist information.

Since 0.9 beta 6 the same functionality has been included in [[Foobar2000]] 0.9. Of course Peter's implementation has more functionality, e.g.: the automatic embedding of the cuesheet in files that support it, and a similar facility using chapters in [[MP4]] files.

==Moderation==

In February 2006 I was offered the position of moderator, which I accepted. It seemed only fair that I give something back to the community which had helped me so much, and generally offered such entertainment. I think the offer was made mainly on the fact that I spent way too long hanging around the forum, and that I was in a useful time zone. Now, there's qualifications for you. ;)

=Settings=

For your information, and my record. :-)

===Converter and 'Move, Rename or Copy Files'===

[%album artist%\][%album%\]$ifgreater(%totaldiscs%,1,Disc %discnumber%\,)[%tracknumber% - ]%title%[' ('%track artist%')']

... or, allowing for multiple artists:

[$if($meta_test(album artist),$meta_sep(album artist,', ',' And '),$meta_sep(artist,', ',' And '))\][%album%\]$ifgreater(%totaldiscs%,1,Disc %discnumber%\,)[%tracknumber% - ]%title%[' ('$if($meta_test(album artist),$meta_sep(artist,', ',' And '),)')']

===ColumnsUI Album Column Display===

[%album%]
[ ' ('%album subtitle%')']
[' ('%discname%')']
$if($greater(%totaldiscs%,1),[' ('Disc %discnumber%')'])

===Run Service > Album Art===

"C:\Program Files\AlbumArtDownloaderXUI\AlbumArt.exe" /artist "%artist%" /album "%album%" /path
"$replace(%_path%,%_filename_ext%,)folder.jpg" /sources "GoogleImage,Album Art Exchange,Amazon (.com)"
/minSize 450 /maxSize 650 /sort size-

=Links=
* My website : http://www.synthetic-soul.co.uk/
* Tag
** My version : http://www.synthetic-soul.co.uk/tag/
** Case's original : http://www.rarewares.org/others.html
* Wapet
** My version : http://www.synthetic-soul.co.uk/wapet/
** Case's original : http://www.rarewares.org/others.html
* foo_cuesheetcreator : http://www.hydrogenaudio.org/forums/index.php?showtopic=26276
* Diskwriter With Cuesheet Support : http://www.hydrogenaudio.org/forums/index.php?showtopic=35275

User:Synthetic Soul

2009-12-03T16:21:07Z

Synthetic Soul: /* Converter and 'Move, Rename or Copy Files' */

=Personal=
My name is Neil Popham. I live in the city of Exeter in the United Kingdom.

I am married to Lucy, and am the very proud father of Tilly, Romy, and Jasper.

I am currently employed as a web developer, mainly working with PHP and PostgreSQL.

I first got involved with Hydrogen Audio after I decided to back up all my [[CD]]s. I hung around the forums for a while, asked a few questions, and have been lingering ever since.

=Methodologies=

I am currently using [[WavPack]] images with accompanying cuesheets to archive my CDs. Archives are stored on both [[DVD]] and a 300GB hardrive. I also store [[PAR2]] parity data on the DVDs, which is created for each image individually. I've yet to see whether this is a good method. I use [[EAC]] to rip the audio, in conjunction with [[REACT]].

I get very little time to actually listen to my music! The main opportunity I get is walking to and from work, listening on my iPod Nano. I encode my music using [[LAME]] [[LAME#VBR_.28variable_bitrate.29_settings|-V5 --vbr-new]], and find the quality perfectly adequate. Still, I was very glad to see that [http://www.hydrogenaudio.org/forums/index.php?showtopic=40607 the latest ~128kbps comparison] proved that many people found the setting (near) transparent. Up until that time I had felt a little inadequate...

=Contributions=

My contributions have so far been quite minimal. I try to make up for this by answering as many of the easy questions as I can, so that the real stars can spend their time discussing the meaty questions. It also makes me look more knowledgeable than I am.

==[[Tag_(tagger)|Tag]] and [[Wapet]]==
Before using [[WavPack]] I used [[Monkey's Audio]]. In order for me to be able to automate my archiving process I found it necessary to adapt Case's [[Tag_(tagger)|Tag]] so that I could set tags from the contents of a text file - namely a cuesheet.

I'd never programmed any C(++) before and found the whole episode both immensely frustrating and incredibly satisfying.

I added the same functionality to Case's [[Wapet]], as I thought it may be useful in the future.

There seemed little interest at the time, but both applications are now used by various other third party applications, such as [[FLACAttack]] and [[REACT]].

==foo_cuesheetcreator==
foo_cuesheetcreator was originally created by Revision17 as a proof of concept.

I had been looking for a component to create cuesheets from a playlist for a while, and was amazed that I had not see it before. However there were some flaws with the component, e.g.: frames being calculated as 1/60th of a second rather than 1/75th and meta data tags being case sensitive, so I adapted it into a usable component.

==Diskwriter With Cuesheet Support==

I adapted [[Foobar2000]] 0.8.3's Diskwriter component so that as well as merging tracks into one single file you could also choose to create an accompanying cuesheet generated using the playlist information.

Since 0.9 beta 6 the same functionality has been included in [[Foobar2000]] 0.9. Of course Peter's implementation has more functionality, e.g.: the automatic embedding of the cuesheet in files that support it, and a similar facility using chapters in [[MP4]] files.

==Moderation==

In February 2006 I was offered the position of moderator, which I accepted. It seemed only fair that I give something back to the community which had helped me so much, and generally offered such entertainment. I think the offer was made mainly on the fact that I spent way too long hanging around the forum, and that I was in a useful time zone. Now, there's qualifications for you. ;)

=Settings=

For your information, and my record. :-)

===Converter and 'Move, Rename or Copy Files'===

[%album artist%\][%album%\]$ifgreater(%totaldiscs%,1,Disc %discnumber%\,)[%tracknumber% - ]%title%[' ('%track artist%')']

===ColumnsUI Album Column Display===

[%album%]
[ ' ('%album subtitle%')']
[' ('%discname%')']
$if($greater(%totaldiscs%,1),[' ('Disc %discnumber%')'])

===Run Service > Album Art===

"C:\Program Files\AlbumArtDownloaderXUI\AlbumArt.exe" /artist "%artist%" /album "%album%" /path
"$replace(%_path%,%_filename_ext%,)folder.jpg" /sources "GoogleImage,Album Art Exchange,Amazon (.com)"
/minSize 450 /maxSize 650 /sort size-

=Links=
* My website : http://www.synthetic-soul.co.uk/
* Tag
** My version : http://www.synthetic-soul.co.uk/tag/
** Case's original : http://www.rarewares.org/others.html
* Wapet
** My version : http://www.synthetic-soul.co.uk/wapet/
** Case's original : http://www.rarewares.org/others.html
* foo_cuesheetcreator : http://www.hydrogenaudio.org/forums/index.php?showtopic=26276
* Diskwriter With Cuesheet Support : http://www.hydrogenaudio.org/forums/index.php?showtopic=35275

User:Synthetic Soul

2009-09-23T09:29:26Z

Synthetic Soul:

=Personal=
My name is Neil Popham. I live in the city of Exeter in the United Kingdom.

I am married to Lucy, and am the very proud father of Tilly, Romy, and Jasper.

I am currently employed as a web developer, mainly working with PHP and PostgreSQL.

I first got involved with Hydrogen Audio after I decided to back up all my [[CD]]s. I hung around the forums for a while, asked a few questions, and have been lingering ever since.

=Methodologies=

I am currently using [[WavPack]] images with accompanying cuesheets to archive my CDs. Archives are stored on both [[DVD]] and a 300GB hardrive. I also store [[PAR2]] parity data on the DVDs, which is created for each image individually. I've yet to see whether this is a good method. I use [[EAC]] to rip the audio, in conjunction with [[REACT]].

I get very little time to actually listen to my music! The main opportunity I get is walking to and from work, listening on my iPod Nano. I encode my music using [[LAME]] [[LAME#VBR_.28variable_bitrate.29_settings|-V5 --vbr-new]], and find the quality perfectly adequate. Still, I was very glad to see that [http://www.hydrogenaudio.org/forums/index.php?showtopic=40607 the latest ~128kbps comparison] proved that many people found the setting (near) transparent. Up until that time I had felt a little inadequate...

=Contributions=

My contributions have so far been quite minimal. I try to make up for this by answering as many of the easy questions as I can, so that the real stars can spend their time discussing the meaty questions. It also makes me look more knowledgeable than I am.

==[[Tag_(tagger)|Tag]] and [[Wapet]]==
Before using [[WavPack]] I used [[Monkey's Audio]]. In order for me to be able to automate my archiving process I found it necessary to adapt Case's [[Tag_(tagger)|Tag]] so that I could set tags from the contents of a text file - namely a cuesheet.

I'd never programmed any C(++) before and found the whole episode both immensely frustrating and incredibly satisfying.

I added the same functionality to Case's [[Wapet]], as I thought it may be useful in the future.

There seemed little interest at the time, but both applications are now used by various other third party applications, such as [[FLACAttack]] and [[REACT]].

==foo_cuesheetcreator==
foo_cuesheetcreator was originally created by Revision17 as a proof of concept.

I had been looking for a component to create cuesheets from a playlist for a while, and was amazed that I had not see it before. However there were some flaws with the component, e.g.: frames being calculated as 1/60th of a second rather than 1/75th and meta data tags being case sensitive, so I adapted it into a usable component.

==Diskwriter With Cuesheet Support==

I adapted [[Foobar2000]] 0.8.3's Diskwriter component so that as well as merging tracks into one single file you could also choose to create an accompanying cuesheet generated using the playlist information.

Since 0.9 beta 6 the same functionality has been included in [[Foobar2000]] 0.9. Of course Peter's implementation has more functionality, e.g.: the automatic embedding of the cuesheet in files that support it, and a similar facility using chapters in [[MP4]] files.

==Moderation==

In February 2006 I was offered the position of moderator, which I accepted. It seemed only fair that I give something back to the community which had helped me so much, and generally offered such entertainment. I think the offer was made mainly on the fact that I spent way too long hanging around the forum, and that I was in a useful time zone. Now, there's qualifications for you. ;)

=Settings=

For your information, and my record. :-)

===Converter and 'Move, Rename or Copy Files'===

[%album artist%\][%album%\][Disc %discnumber%\][%tracknumber% - ]%title%$if($meta(album artist),' ('$meta(artist)')',)

===ColumnsUI Album Column Display===

[%album%]
[ ' ('%album subtitle%')']
[' ('%discname%')']
$if($greater(%totaldiscs%,1),[' ('Disc %discnumber%')'])

===Run Service > Album Art===

"C:\Program Files\AlbumArtDownloaderXUI\AlbumArt.exe" /artist "%artist%" /album "%album%" /path
"$replace(%_path%,%_filename_ext%,)folder.jpg" /sources "GoogleImage,Album Art Exchange,Amazon (.com)"
/minSize 450 /maxSize 650 /sort size-

=Links=
* My website : http://www.synthetic-soul.co.uk/
* Tag
** My version : http://www.synthetic-soul.co.uk/tag/
** Case's original : http://www.rarewares.org/others.html
* Wapet
** My version : http://www.synthetic-soul.co.uk/wapet/
** Case's original : http://www.rarewares.org/others.html
* foo_cuesheetcreator : http://www.hydrogenaudio.org/forums/index.php?showtopic=26276
* Diskwriter With Cuesheet Support : http://www.hydrogenaudio.org/forums/index.php?showtopic=35275

User:Synthetic Soul

2009-03-03T08:23:10Z

Synthetic Soul: /* Settings */

=Personal=
My name is Neil Popham. I live in the city of Exeter in the United Kingdom.

I am married to Lucy, and am the very proud father of Tilly, Romy, and Jasper.

I am currently employed as a web developer, mainly working with PHP and PostgreSQL.

I first got involved with Hydrogen Audio after I decided to back up all my [[CD]]s. I hung around the forums for a while, asked a few questions, and have been lingering ever since.

=Methodologies=

I am currently using [[WavPack]] images with accompanying cuesheets to archive my CDs. Archives are stored on both [[DVD]] and a 300GB hardrive. I also store [[PAR2]] parity data on the DVDs, which is created for each image individually. I've yet to see whether this is a good method. I use [[EAC]] to rip the audio, in conjunction with [[REACT]].

I get very little time to actually listen to my music! The main opportunity I get is walking to and from work, listening on my Creative Zen Nano Plus. I encode my music using [[LAME]] [[LAME#VBR_.28variable_bitrate.29_settings|-V5 --vbr-new]], and find the quality perfectly adequate. Still, I was very glad to see that [http://www.hydrogenaudio.org/forums/index.php?showtopic=40607 the latest ~128kbps comparison] proved that many people found the setting (near) transparent. Up until that time I had felt a little inadequate...

=Contributions=

My contributions have so far been quite minimal. I try to make up for this by answering as many of the easy questions as I can, so that the real stars can spend their time discussing the meaty questions. It also makes me look more knowledgeable than I am.

==[[Tag_(tagger)|Tag]] and [[Wapet]]==
Before using [[WavPack]] I used [[Monkey's Audio]]. In order for me to be able to automate my archiving process I found it necessary to adapt Case's [[Tag_(tagger)|Tag]] so that I could set tags from the contents of a text file - namely a cuesheet.

I'd never programmed any C(++) before and found the whole episode both immensely frustrating and incredibly satisfying.

I added the same functionality to Case's [[Wapet]], as I thought it may be useful in the future.

There seemed little interest at the time, but both applications are now used by various other third party applications, such as [[FLACAttack]] and [[REACT]].

==foo_cuesheetcreator==
foo_cuesheetcreator was originally created by Revision17 as a proof of concept.

I had been looking for a component to create cuesheets from a playlist for a while, and was amazed that I had not see it before. However there were some flaws with the component, e.g.: frames being calculated as 1/60th of a second rather than 1/75th and meta data tags being case sensitive, so I adapted it into a usable component.

==Diskwriter With Cuesheet Support==

I adapted [[Foobar2000]] 0.8.3's Diskwriter component so that as well as merging tracks into one single file you could also choose to create an accompanying cuesheet generated using the playlist information.

Since 0.9 beta 6 the same functionality has been included in [[Foobar2000]] 0.9. Of course Peter's implementation has more functionality, e.g.: the automatic embedding of the cuesheet in files that support it, and a similar facility using chapters in [[MP4]] files.

==Moderation==

In February 2006 I was offered the position of moderator, which I accepted. It seemed only fair that I give something back to the community which had helped me so much, and generally offered such entertainment. I think the offer was made mainly on the fact that I spent way too long hanging around the forum, and that I was in a useful time zone. Now, there's qualifications for you. ;)

=Settings=

For your information, and my record. :-)

===Converter and 'Move, Rename or Copy Files'===

[%album artist%\][%album%\][Disc %discnumber%\][%tracknumber% - ]%title%$if($meta(album artist),' ('$meta(artist)')',)

===ColumnsUI Album Column Display===

[%album%]
[ ' ('%album subtitle%')']
[' ('%discname%')']
$if($greater(%totaldiscs%,1),[' ('Disc %discnumber%')'])

===Run Service > Album Art===

"C:\Program Files\AlbumArtDownloaderXUI\AlbumArt.exe" /artist "%artist%" /album "%album%" /path
"$replace(%_path%,%_filename_ext%,)folder.jpg" /sources "GoogleImage,Album Art Exchange,Amazon (.com)"
/minSize 450 /maxSize 650 /sort size-

=Links=
* My website : http://www.synthetic-soul.co.uk/
* Tag
** My version : http://www.synthetic-soul.co.uk/tag/
** Case's original : http://www.rarewares.org/others.html
* Wapet
** My version : http://www.synthetic-soul.co.uk/wapet/
** Case's original : http://www.rarewares.org/others.html
* foo_cuesheetcreator : http://www.hydrogenaudio.org/forums/index.php?showtopic=26276
* Diskwriter With Cuesheet Support : http://www.hydrogenaudio.org/forums/index.php?showtopic=35275
* Batch file for re-encoding FLAC files to a newer version : http://www.synthetic-soul.co.uk/files/flac-113.bat ([http://www.synthetic-soul.co.uk/files/flac-113.txt readme])

EAC and LossyWAV

2008-10-06T10:00:02Z

Synthetic Soul:

= Software Needed =
* [http://www.exactaudiocopy.de/en/index.php/resources/download/ Exact Audio Copy]
* [[LossyWAV]]
* Either:
** [[FLAC]]
** [[TAK]]
** [[WavPack]]

= Installation =
'''Note:''' This guide assumes that [[EAC]] is has been configured for secure ripping, if not please follow [[EAC_Drive_Configuration | this]] guide.
* Extract lossywav.exe and your chosen encoder to a folder, or folders, of your choosing.

= Configuration =
* Open EAC and insert a CD into the drive.
* Click the '''EAC''' menu and select '''Compression Options'''.
* Click the '''External Compression''' Tab, and check '''Use external program for compression'''.
* Change '''Parameter Passing Scheme''' to '''User Defined Encoder'''.
* Change '''Use file extension''' to '''.flac''', '''.tak''', or '''.wv''', depending on your encoder of choice.
* Click the '''Browse''' button and locate '''cmd.exe'''. In Windows XP it can be found in '''C:\WINDOWS\system32'''.
* Ensure '''Use CRC check''' and '''Add ID3 tag''' are not checked.
* Ensure '''Check for external programs return code''' is checked.
* In the '''Additional command line options''' box, copy and paste the following.

===FLAC===

/d /c C:\"Program Files"\LossyWAV\lossywav.exe %s --standard --silent --stdout|C:\"Program Files"\FLAC\flac.exe - -b 512 '''-5''' -f -T "artist=%a" -T "title=%t" -T "album=%g" -T "date=%y" -T "tracknumber=%n" -T "genre=%m" -o %d

===TAK (no tagging)===

/d /c C:\"Program Files"\LossyWAV\lossywav.exe %s --standard --silent --stdout|C:\"Program Files"\TAK\takc.exe -e '''-p2''' -fsl512 -ihs - %d

===WavPack===

/d /c C:\"Program Files"\LossyWAV\lossywav.exe %s --standard --silent --stdout|C:\"Program Files"\WavPack\wavpack.exe '''-h''' --blocksize=512 --merge-blocks -i -w "Artist=%a" -w "Title=%t" -w "Album=%g" -w "Year=%y" -w "Track=%n" -w "Genre=%m" - %d

'''Note:''' The green text indicates where you would change the compression level or add settings for the encoder.

Do not worry what bit rate is shown in the bit rate drop down box, this will be ignored, as will the quality setting chosen below it.

[[Image:EACandLossyWAV.gif|frame|center|EAC External Compression dialogue configured for LossyFLAC ]]

=File Extension=
Unfortunately, [[EAC]] does not allow long file extensions, and therefore the recommended '''.lossy.<ext>''' cannot be used. Users are recommended to manually update their file extensions to include the '''.lossy''' prefix, to maintain the distinction between these lossy files and any lossless [[FLAC]]/[[TAK]]/[[WavPack]] files you may have.

=Addtional Reading=
* [[Exact_Audio_Copy | Exact Audio Copy]]
* [[LossyWAV]]
* [[FLAC]]
* [[TAK]]
* [[WavPack]]
* [[Lossless | About Lossless Compression]]

[[Category:Guides]]
[[Category:EAC Guides]]

EAC and LossyWAV

2008-10-06T09:59:38Z

Synthetic Soul:

= Software Needed =
* [http://www.exactaudiocopy.de/en/index.php/resources/download/ Exact Audio Copy]
* [[LossyWAV]]
* Either:
** [[FLAC]]
** [[TAK]]
** [[WavPack]]

= Installation =
'''Note:''' This guide assumes that EAC is has been configured for secure ripping, if not please follow [[EAC_Drive_Configuration | this]] guide.
* Extract lossywav.exe and your chosen encoder to a folder, or folders, of your choosing.

= Configuration =
* Open EAC and insert a CD into the drive.
* Click the '''EAC''' menu and select '''Compression Options'''.
* Click the '''External Compression''' Tab, and check '''Use external program for compression'''.
* Change '''Parameter Passing Scheme''' to '''User Defined Encoder'''.
* Change '''Use file extension''' to '''.flac''', '''.tak''', or '''.wv''', depending on your encoder of choice.
* Click the '''Browse''' button and locate '''cmd.exe'''. In Windows XP it can be found in '''C:\WINDOWS\system32'''.
* Ensure '''Use CRC check''' and '''Add ID3 tag''' are not checked.
* Ensure '''Check for external programs return code''' is checked.
* In the '''Addtional command line options''' box, copy and paste the following.

===FLAC===

/d /c C:\"Program Files"\LossyWAV\lossywav.exe %s --standard --silent --stdout|C:\"Program Files"\FLAC\flac.exe - -b 512 '''-5''' -f -T "artist=%a" -T "title=%t" -T "album=%g" -T "date=%y" -T "tracknumber=%n" -T "genre=%m" -o %d

===TAK (no tagging)===

/d /c C:\"Program Files"\LossyWAV\lossywav.exe %s --standard --silent --stdout|C:\"Program Files"\TAK\takc.exe -e '''-p2''' -fsl512 -ihs - %d

===WavPack===

/d /c C:\"Program Files"\LossyWAV\lossywav.exe %s --standard --silent --stdout|C:\"Program Files"\WavPack\wavpack.exe '''-h''' --blocksize=512 --merge-blocks -i -w "Artist=%a" -w "Title=%t" -w "Album=%g" -w "Year=%y" -w "Track=%n" -w "Genre=%m" - %d

'''Note:''' The green text indicates where you would change the compression level or add settings for the encoder.

Do not worry what bit rate is shown in the bit rate drop down box, this will be ignored, as will the quality setting chosen below it.

[[Image:EACandLossyWAV.gif|frame|center|EAC External Compression dialogue configured for LossyFLAC ]]

=File Extension=
Unfortunately, [[EAC]] does not allow long file extensions, and therefore the recommended '''.lossy.<ext>''' cannot be used. Users are recommended to manually update their file extensions to include the '''.lossy''' prefix, to maintain the distinction between these lossy files and any lossless [[FLAC]]/[[TAK]]/[[WavPack]] files you may have.

=Addtional Reading=
* [[Exact_Audio_Copy | Exact Audio Copy]]
* [[LossyWAV]]
* [[FLAC]]
* [[TAK]]
* [[WavPack]]
* [[Lossless | About Lossless Compression]]

[[Category:Guides]]
[[Category:EAC Guides]]

EAC and TAK

2008-10-06T09:18:13Z

Synthetic Soul:

==Software Needed==
* [http://www.exactaudiocopy.de/en/index.php/resources/download/ Exact Audio Copy]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=58784 TAK]
* [[Wapet]]

==Installation==
'''Note:''' This guide assumes that EAC has been configured for secure ripping, if not please follow [[EAC_Drive_Configuration | this]] guide.
* Extract '''takc.exe''' into a folder of your choice.
* Extract '''wapet.exe''' into your '''Exact Audio Copy''' directory.

==Configuration==

* Open EAC and insert a CD into the drive.
* Click the '''EAC''' menu and select '''Compression Options...''' (or press '''F11''').
* Click the '''External Compression''' tab, and put a check box in '''Use external program for compression'''.
* Change '''Parameter passing scheme''' to '''User Defined Encoder'''.
* Change '''Use file extension''' to '''.tak'''.
* Click the '''Browse''' button and locate '''wapet.exe'''.
* Remove the ticks from '''Use CRC check''', '''Add ID3 tag''' and '''Check for external programs return code'''.
* In the '''Additional command line options''' box, copy and paste the string below.
'''APEv2 Tag:'''
%d -t "Artist=%a" -t "Title=%t" -t "Album=%g" -t "Year=%y" -t "Track=%n" -t "Genre=%m" '''"C:\Program Files\TAK\takc.exe"''' -e '''-p2''' %s %d

'''Note 1''': This needs to point to where '''takc.exe''' is located. If the path contains spaces, you must surround it with double quotes (").

'''Note 2''': Alter this switch for the desired compression mode. If you leave the switch out, TAK will use the default of -p2.

Taken from the TAK command line summary:

<pre>
-p# select encoder preset #: 0-5 (fastest to strongest, default is 2).
Append E/M (-p2m) to increase the evaluation level to Extra/Max.
</pre>

<center>[[Image:EACandTAK.png|frame|center|EAC External Compression dialogue configured for TAK with tagging support provided by Wapet]]</center>

* Don't worry what bit rate is shown in the '''Bit rate''' drop down box, this will be ignored.

==Addtional Reading==
* [[TAK]]
* [[Exact_Audio_Copy | Exact Audio Copy]]
* [[Lossless | About Lossless Compression]]

[[Category:Guides]]
[[Category:EAC Guides|TAK & EAC]]

EAC and LossyWAV

2008-10-06T09:15:04Z

Synthetic Soul: Added File Extension

= Software Needed =
* [http://www.exactaudiocopy.de/en/index.php/resources/download/ Exact Audio Copy]
* [[LossyWAV]]
* Either:
** [[FLAC]]
** [[TAK]]
** [[WavPack]]

= Installation =
'''Note:''' This guide assumes that EAC is has been configured for secure ripping, if not please follow [[EAC_Drive_Configuration | this]] guide.
* Extract lossywav.exe and your chosen encoder to a folder, or folders, of your choosing.

= Configuration =
* Open EAC and insert a CD into the drive.
* Click the '''EAC''' menu and select '''Compression Options'''.
* Click the '''External Compression''' Tab, and check '''Use external program for compression'''.
* Change '''Parameter Passing Scheme''' to '''User Defined Encoder'''.
* Change '''Use file extension''' to '''.flac''', '''.tak''', or '''.wv''', depending on your encodoer of choice.
* Click the '''Browse''' button and locate '''cmd.exe'''. In Windows XP it can be found in '''C:\WINDOWS\system32'''.
* Ensure '''Use CRC check''' and '''Add ID3 tag''' are not checked.
* Ensure '''Check for external programs return code''' is checked.
* In the '''Addtional command line options''' box, copy and paste the following.

===FLAC===

/d /c C:\"Program Files"\LossyWAV\lossywav.exe %s --standard --silent --stdout|C:\"Program Files"\FLAC\flac.exe - -b 512 '''-5''' -f -T "artist=%a" -T "title=%t" -T "album=%g" -T "date=%y" -T "tracknumber=%n" -T "genre=%m" -o %d

===TAK (no tagging)===

/d /c C:\"Program Files"\LossyWAV\lossywav.exe %s --standard --silent --stdout|C:\"Program Files"\TAK\takc.exe -e '''-p2''' -fsl512 -ihs - %d

===WavPack===

/d /c C:\"Program Files"\LossyWAV\lossywav.exe %s --standard --silent --stdout|C:\"Program Files"\WavPack\wavpack.exe '''-h''' --blocksize=512 --merge-blocks -i -w "Artist=%a" -w "Title=%t" -w "Album=%g" -w "Year=%y" -w "Track=%n" -w "Genre=%m" - %d

'''Note:''' The green text indicates where you would change the compression level or add settings for the encoder.

Do not worry what bit rate is shown in the bit rate drop down box, this will be ignored, as will the quality setting chosen below it.

[[Image:EACandLossyWAV.gif|frame|center|EAC External Compression dialogue configured for LossyFLAC ]]

=File Extension=
Unfortunately, [[EAC]] does not allow long file extensions, and therefore the recommended '''.lossy.<ext>''' cannot be used. Users are recommended to manually update their file extensions to include the '''.lossy''' prefix, to maintain the distinction between these lossy files and any lossless [[FLAC]]/[[TAK]]/[[WavPack]] files you may have.

=Addtional Reading=
* [[Exact_Audio_Copy | Exact Audio Copy]]
* [[LossyWAV]]
* [[FLAC]]
* [[TAK]]
* [[WavPack]]
* [[Lossless | About Lossless Compression]]

[[Category:Guides]]
[[Category:EAC Guides]]

LossyWAV

2008-10-06T09:05:15Z

Synthetic Soul: Added link to EAC guide.

{{Software Infobox
| name = lossyWAV
| screenshot =
| caption =
| maintainer = [http://www.hydrogenaudio.org/forums/index.php?showuser=42400 Nick.C]
| stable_release = 1.1.0b
| preview_release = 1.0.1x RC4
| operating_system = [[Wikipedia:Microsoft Windows|Windows]]
| use = [[Wikipedia:Digital signal processing|Digital signal processing]]
| license = [[Wikipedia:GNU General Public License|GNU GPL]]
| website = [http://www.hydrogenaudio.org/forums/index.php?showtopic=56129 Hydrogenaudio]
}}
lossyWAV is a new free lossy pre-processor for [[PCM]] audio contained in the [[WAV]] file format. It reduces [[Wikipedia:Audio bit depth|bit depth]] of the input signal, which, when used in conjunction with certain lossless codecs, reduces the bitrate of the encoded file significantly compared to unpreprocessed compression.
lossyWAV's primary goal is to maintain [[transparency]] with a high degree of confidence when processing any audio data.

==History==
lossyWAV is based on the lossyFLAC idea proposed by [http://www.hydrogenaudio.org/forums/index.php?showuser=409 David Robinson] at Hydrogenaudio, which is a method of carefully reducing the bitdepth of samples, therefore utilising the wasted bits feature of the FLAC lossless codec. The aim is to transparently reduce audio bit depth (by making some lower significant bits (lsb's) zero), consequently taking advantage of FLAC's detection of consistently-zeroed lower significant bits within each single frame and significantly increasing coding efficiency.[http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=55522&view=findpost&p=498179] In this way the user can enjoy audio encoded using the same codec (which may be all important from a hardware compatibility perspective) at a reduced bitrate compared to the lossless version.

[http://www.hydrogenaudio.org/forums/index.php?showuser=42400 Nick Currie] ported the original [[Wikipedia:MATLAB|MATLAB]] implementation to [[Wikipedia:Borland Delphi|Delphi]] (Many thanks [[Wikipedia:CodeGear|CodeGear]] for Turbo Explorer!!) with a liberal sprinkling of [[Wikipedia:IA-32|IA-32]] and [[Wikipedia:x87|x87]] Assembly Language for speed.

Subsequently, lossyFLAC proved itself to work with other lossless codecs, so the application name was changed to lossyWAV.

Since then, Nick has heavily developed and built upon lossyWAV, with valuable tuning performed by [http://www.hydrogenaudio.org/forums/index.php?showuser=25015 Horst Albrecht] at Hydrogenaudio. Although the current lossyWAV implementation has built on David's original method, the method itself still very much belongs to its author.

==Indicative bitrate reduction==
It must be stressed that lossyWAV is a pure variable bit-depth pre-processor in that the overall sample size remains the same after processing but the number of significant bits used for the samples in a codec-block can change on a block-by-block basis. Bits-to-remove from the audio data are calculated on a block-by-block basis (codec-block length = 512 samples, 11.6msec @ 44.1kHz) using overlapping [[Wikipedia:fast Fourier transform|fast Fourier Transform]] (FFT) analyses of at least two lengths (default quality preset (-q 5) = 32, 64 & 1024 [[Wikipedia:Sampling %28signal processing%29|samples]]). After some manipulation, the results of each FFT analysis for a specific codec-block are then grouped and the minimum value used to determine bits-to-remove for the whole codec-block. Bit removal adds [[Wikipedia:white noise|white noise]] to the output, however the level of the added noise associated with the removal of a number of bits has been pre-calculated and the number of bits to remove will depend on the level of the noise floor of the codec-block in question. Each sample in the codec-block is then rounded such that the first <bits-to-remove> lsb's are zero. In this way the wasted bits feature of [[FLAC]] et al is exploited.

{| class="wikitable" style="text-align:center"
|-
!lossyWAV Test Set (16 bit / 44.1kHz)
!Codec
!lossless
!--insane
!--extreme
!--standard
!--portable
!-q 0
|-
!10 Album Test Set
| TAK
| 820 kbit/s
| 615 kbit/s
| 532 kbit/s
| 447 kbit/s
| 359 kbit/s
| 266 kbit/s
|-
!10 Album Test Set
| FLAC
| 854 kbit/s
| 632 kbit/s
| 548 kbit/s
| 463 kbit/s
| 376 kbit/s
| 285 kbit/s
|-
!10 Album Test Set
| Wavpack
| 852 kbit/s
| 641 kbit/s
| 563 kbit/s
| 481 kbit/s
| 390 kbit/s
| 296 kbit/s
|}

==File identification==
lossyWAV-processed WAV files are named with a double filename extension, .lossy.wav, to make them instantly identifiable. e.g. ".lossy.flac" would indicate an audio file which was processed using lossyWAV, and subsequently encoded using FLAC.[http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=55522&view=findpost&p=498559]

The --correction parameter is used when processing to create a correction file which is named with the .lwcdf.wav double filename extension. When "added" to the corresponding .lossy.wav, using the --merge parameter, the original file will be reconstituted.

Combinations of lossyWAV with each specific encoder are referred to as lossy'''X''', where '''X''' is an abbreviation of the lossless codec name. Combination names are listed in the "[[LossyWAV#Known supported codecs|known supported codecs]]" section below.

lossyWAV inserts a variable-length 'fact' chunk into the WAV file immediately after the 'fmt ' chunk. This takes the form:<pre>fact/<size>/lossyWAV x.y.z @ dd/mm/yyyy hh:mm:ss, -q 5</pre>Where the version, date & time and user settings are copied. Additionally, if a lossyWAV 'fact' chunk is found in a file, the processing will be halted (exit code = 16) to prevent re-processing of an already processed file.

The -check parameter can be used to determine whether a file has previously been processed without trying to process it, exit code = 16 if already processed; exit code = 0 if not.

==Quality presets==
*--insane: (-q 10) Highest quality preset, generally considered to be excessive;
*--extreme: (-q 7.5) High quality preset, disc space-saving alternative to lossless archiving for large audio collections, considered to be suitable for transcoding to other lossy codecs;
*--standard: (-q 5) Default preset, generally accepted to be transparent;
*--portable: (-q 2.5) DAP quality preset for use on a compatible [[Wikipedia:Digital audio player|DAP]]. [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=56129&view=findpost&p=531316]

All tuning has been performed on quality preset --standard with higher presets being more conservative. Quality preset --standard is generally accepted to be (and from testing so far is) transparent. If you find a track which --standard fails to achieve transparency after processing, please post a sample (no more than 30 seconds) in the development thread.

==Supported input formats==
*[[WAV]]: 9-bit to 32-bit integer; 1 to 8 channels; sample rate ≥ 32kHz [[Pulse Code Modulation|PCM]]. Very high sample rates (>48kHz) have not been extensively tested. Tunings have been focussed on 16-bit, 44.1kHz samples (i.e. [[Wikipedia:Red Book (audio CD standard)|CD]] PCM).

==Codec compatibility==
{| class="wikitable" style="text-align:center"
|-
!Codec
!Supported
!Encoder parameters
!Combination name
|-
! [[Free Lossless Audio Codec|FLAC]]
| '''Yes'''
| -'''5''' -'''b''' 512 --'''keep-foreign-metadata'''
| lossy'''FLAC'''
|-
! [[Lossless Predictive Audio Compression|LPAC]]
| '''Yes'''
| -'''b'''512
| lossy'''LPAC'''
|-
! [[Wikipedia:Audio Lossless Coding|MPEG-4 ALS]]
| '''Yes'''
| -'''l''' -'''n'''512
| lossy'''ALS'''
|-
! [[TAK]]
| '''Yes'''
| -'''fsl'''512
| lossy'''TAK'''
|-
! [[WavPack]]
| '''Yes'''
| --'''blocksize'''=512
| lossy'''WV'''
|-
! [[Windows Media Audio#Windows Media Audio Lossless|WMA Lossless]]
| '''Yes'''
| —
| lossy'''WMALSL'''
|-
! [[Apple Lossless]]
| No
| —
| —
|-
! [[Lossless Audio|LA]]
| No
| —
| —
|-
! [[Monkey's Audio]]
| No
| —
| —
|-
! [[OptimFROG]]
| No
| —
| —
|-
! [[Wikipedia:TTA (codec)|TTA]]
| No
| —
| —
|}

* Combinations of lossyWAV with each specific encoder are referred to as lossy'''X''', where '''X''' is an abbreviation of the lossless codec name.

There is also [http://www.hometheaterhifi.com/volume_8_4/dvd-benchmark-part-6-dvd-audio-11-2001.html#Meridian%20Lossless%20Packing%20(MLP)%20in%20a%20Nutshell evidence] — so-called "Bit Shifting" — to suggest that lossyWAV may work with [[Wikipedia:Meridian Lossless Packing|MLP]], but this remains untested due to prohibitive prices of encoders.

A comparison of portable media players is [[Wikipedia:Comparison of portable media players#Audio Formats|here]], which shows FLAC and WMA Lossless compatibility among listed players.
Any player supported by [http://www.rockbox.org Rockbox] can use FLAC or WavPack files after installing Rockbox.
===Important note===
'''NB: when encoding using a lossless codec, please ensure that the block size of the lossless codec matches that of lossyWAV (default = 512 samples). If this is not done then the lossless encoding of the processed WAV file will (almost certainly) be larger than it would otherwise have been. This is achieved by adding the "Encoder Parameters" in the table above to the command line of the lossless codec in question.'''
===Bonus feature===
Another, possibly not obvious, feature of lossyWAV is that the processed output can be "transcoded" from one lossless codec to another lossless codec with absolutely no loss of quality whatsoever. This is solely due to the fact that lossyWAV output is designed to be losslessly encoded - something that lossless codecs do very well indeed.

==Using lossyWAV==
===Application settings===
<pre>
lossyWAV 1.1.0, Copyright (C) 2007,2008 Nick Currie. Copyleft.

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful,but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see <http://www.gnu.org/licenses/>.

Usage : lossyWAV <input wav file> <options>

Example : lossyWAV musicfile.wav

Quality Options:

-I, --insane highest quality output, suitable for transcoding;
-E, --extreme high quality output, also suitable for transcoding;
-S, --standard default quality output, considered to be transparent;
-P, --portable good quality output for DAP use. Not considered to be fully
transparent, but considered fit for its intended purpose.

Standard Options:

-c, --check check if WAV file has already been processed; default=off.
errorlevel=16 if already processed, 0 if not.
-C, --correction write correction file for processed WAV file; default=off.
-f, --force forcibly over-write output file if it exists; default=off.
-h, --help display help.
-L, --longhelp display extended help.
-M, --merge merge existing lossy.wav and lwcdf.wav files.
-o, --outdir <t> destination directory for the output file(s).
-v, --version display the lossyWAV version number.

Special thanks:

David Robinson for the publication of his lossyFLAC method, guidance, and
the motivation to implement the method as lossyWAV.
Horst Albrecht for ABX testing, valuable support in tuning the internal
presets, constructive criticism and all the feedback.
Sebastian Gesemann for the noise shaping coefficients and help in using them
in the lossyWAV noise shaping implementation.
Don Cross for the Complex-FFT algorithm used.</pre>
===Example drag'n'drop batch file===
Simply drag the FLAC files onto this batch file and it will process, recode in FLAC and copy ALL of the tags from the input FLAC file, placing the output lossyFLAC file in the same directory as the input FLAC file. Requires flac.exe and [http://www.synthetic-soul.co.uk/tag/ tag.exe] to be somewhere on the path.
<pre>@echo off
:repeat
if %1.==. goto end
if exist %1 flac -d %1 --stdout --silent|lossywav - --stdout --standard --stdinname %1|flac - -b 512 -o "%~dpn1.lossy.flac" --silent && tag --fromfile %1 "%~dpn1.lossy.flac"
shift
goto repeat
:end</pre>

===Example Foobar2000 converter settings===
lossyFLAC settings:<pre>Encoder: c:\windows\system32\cmd.exe
Extension : lossy.flac
Parameters: /d /c c:\"program files"\bin\lossywav - --standard --silent --stdout|
c:\"program files"\bin\flac - -b 512 -5 -f -o%d
Format is : lossless or hybrid
Highest BPS mode supported: 24 </pre>

lossyTAK settings:<pre>Encoder: c:\windows\system32\cmd.exe
Extension : lossy.tak
Parameters : /d /c c:\"program files"\bin\lossywav - --standard --silent --stdout|
c:\"program files"\bin\takc -e -p2m -fsl512 -ihs - %d
Format is: lossless or hybrid
Highest BPS mode supported: 24</pre>

lossyWV settings:<pre>Encoder: c:\windows\system32\cmd.exe
Extension : lossy.wv
Parameters: /d /c c:\"program files"\bin\lossywav - --standard --silent --stdout|
c:\"program files"\bin\wavpack -hm --blocksize=512 --merge-blocks -i - %d
Format is : lossless or hybrid
Highest BPS mode supported: 24</pre>

There is a known problem within foobar2000 (although more likely to do with cmd.exe itself) when running an executable within the cmd.exe command line from a path which includes spaces. The suggested fix for this is to enclose the element of the path which contains spaces within double quotation marks ("), e.g. c:\"program files"\directory_where_executable_is\executable_name

===Example EAC settings===
Please see [[EAC and LossyWAV]].

==Frequently asked questions==
*'''Question:''' Why is the ".wav" file extension used?
*'''Answer:''' The ".wav" file extension is used because lossyWAV is a digital signal processor and not a codec. No decoding is required for any program to play a WAV file which has been processed with lossyWAV as it remains compliant with the RIFF WAVE format.

*'''Question:''' Why create a processor which means that I cannot be sure that a lossless file is truly lossless?
*'''Answer:''' Unless one creates the lossless file personally, one can '''never''' be completely sure that the file is indeed lossless. e.g. If a WAV file is encoded to mp3 and then transcoded to a lossless codec, how can this pre-processing be easily determined?

*'''Question:''' Is it [[Variable Bitrate|VBR]]?
*'''Short answer:''' Yes.

*'''Question:''' Do I need to re-process to change lossless codecs?
*'''Short answer:''' No.

*'''Question:''' Is it [[transparency|transparent]]?
*'''Short answer:''' At preset --standard, almost certainly.

*'''Question:''' Is it [[lossless]]?
*'''Short answer:''' No.

*'''Question:''' Will it ever have a [[Constant Bitrate|CBR]] mode?
*'''Short answer:''' No.

*'''Question:''' Why should I use this?
*'''Answer:'''
:*high quality
:*extremely low chance of audible [[artifact|artifacts]]
:*reasonable [[bitrate]]s
:*usable with unmodified, established lossless formats.

==External links==
*[http://www.hydrogenaudio.org/forums/index.php?showtopic=55522 Original lossyFLAC thread] - Introduction of the concept by David Robinson (Replay Gain developer) and initial development;

*[http://www.hydrogenaudio.org/forums/index.php?showtopic=65499 lossyWAV 1.2.0 Development Thread] - Latest release candidate and beta version in the first post;

*[http://www.hydrogenaudio.org/forums/index.php?showtopic=63254 lossyWAV 1.1.0 development thread]
*[http://www.hydrogenaudio.org/forums/index.php?showtopic=64617 lossyWAV 1.1.0 release thread] - Release of version 1.1.0 on 12 July 2008;

*[http://www.hydrogenaudio.org/forums/index.php?showtopic=56129 lossyWAV Development thread] - Conversion of the original Matlab script to Delphi and evolution of the method;
*[http://www.hydrogenaudio.org/forums/index.php?showtopic=63225 lossyWAV 1.0.0 release thread] - Release of version 1.0.0b on 12 May 2008;

Exact Audio Copy

2008-10-06T09:02:26Z

Synthetic Soul: /* Compression guides */

{{featured}}
{{Software Infobox
| name = Exact Audio Copy
| screenshot = [[Image:EAC_screenshot.png|250px|EAC screenshot]]
| caption = popular secure ripper with C2 error correction
| maintainer = Andre Wiethoff
| stable_release = 0.95b4
| preview_release =
| operating_system = Windows, Linux/BSD (Wine Emulation)
| use = Digital Audio Extraction
| license = Free, Cardware
| website = [http://www.exactaudiocopy.org EAC website]
}}

'''Exact Audio Copy''' ('''EAC''' for short) is a free software that can be used to extract tracks from an Audio CD to your computer's hard disk. What makes EAC special compared to other rippers is the fact that it is capable of reading audio CDs almost perfectly.
EAC uses various methods for extracting audio data. EAC can also invoke externally installed encoders, thereby making it possible to simultaneously rip and encode audio data to the format of your choice.

== Features of Exact Audio Copy ==
* Usage of the Windows 95 and Windows NT ASPI Interface, so both SCSI and ATAPI CD-ROM drives are supported
* Hidden sector synchronization (jitter correction)
* Secure, fast and burst extraction methods selectable. Fast extraction should run at the same speed as other grabbers, but is probably not exact anymore. Burst mode just grabs the audio data without any synchronization.
* Read error and complete loss of sync detection and correction in secure modes, as far as possible
* Output of time positions of all non-exact corrections and listen to these positions
* Copy of ranges of music data, not only tracks
* Automatic Speed reduction on errors and fallback afterwards
* Normalization of extracted audio
* Usage of the Windows Audio Compression Manager (ACM Codecs) for direct compression e.g. to MP3 waves
* Support for the BladeEnc DLL that is usable like an ACM Codec for online MP3 compression
* Support of external MP3, VQF, RA and AAC encoders for automatic compression after extraction
* Batch compression and decompression of/to WAV files
* Compression offset support for exact compression/decompression
* Detection of pre-track gaps
* Detection of silence in pre-track gaps
* Automatic creation of CUE sheets for CDRWin, including all gaps, indices, track attributes, UPC and ISRC
* CD player functionality and prelistening to selected ranges
* Automatic detection of drive features, whether a drive has an accurate stream and/or does caching
* Sample Offsets for drives with no accurate streams, including the option of filling up missing samples with silence
* Option for synchronizing tracks for non-accurate stream drives
* Filename editing with local and remote CDDB database and cdplayer.ini support and more features like ID3 tagging
* Browse and edit local database
* Local CDDB support
* Record and Loop Record functions for recording from LP, radio, etc.
* Automatic rename of MP3 files according to their ID3 tag
* Catalog extraction function
* Multisession (CD-Extra) support
* CD-Text support
* CD-Write support for some drives
* ID3 Tag editor with drag and drop possibility from track listing and database
* Glitch removal after extraction
* Small WAV editor with the following functionality: delete, trim, normalize, pad, glitch removal, pop detection, interpolation of ranges, noise reduction, fade in/out, undo (and more)
* Program is Cardware, so feel free to copy

== How it works ==
=== Extraction technology ===
In secure mode, this program reads every audio sector at least twice. That is one reason why the program is so slow. But by using this technique non-identical sectors are detected. If an error occurs (read or sync error), the program keeps on reading this sector, until eight of 16 retries are identical, but at maximum one, three or five times (according to the error recovery quality) these 16 retries are read. So, in the worst case, bad sectors are read up to 82 times! But this will help the program to obtain best result by comparing all of the retries. If it is not sure that the stream is correct (at least it can be said at approx. 99.5%) the program will tell the user where the (possible) read error occurred. The program also tries to adjust the jitter artefacts that occur on the first block of a track, so that each extraction should be exactly the same. On drives found to have the ''accurate stream'' feature, this is guaranteed. Of course, this is a little bit more complex, especially with some CD drives which have caching. When these drives cache audio data, every sector read will be read from cache and is identical. I initially implemented two ways of dealing with the caching problem. First there is an extra option for resetting the cache for use the the old secure mode (the one being kept for compatibility reasons). In the current beta version, the cache will still be reset by resetting the drive completely. You might imagine that this would slow down the reading process very badly.

That is why it was implemented three new read modes in version 0.85beta. One really fast mode (up to half of maximum speed) is only for non-caching, accurate stream CD-ROM drives. The second one could be used for caching, accurate stream drives and the last one will work with drives that don't have accurate streams, or do caching. The last two will be much slower, when no read errors occur it will usually something around a third to a fourth of the drives maximum speed.
For testing, it was used a Plextor 14/32 drive that does no caching and a Teac R56S-600 drive that does caching. Furthermore the Plextor 14/32 supports the ''accurate stream'' feature, so it produces no jitter artefacts on any stream.

This program is really damn slow in secure mode in comparison with other grabbers, but the program checks every sector over and over to get the correct data with high certainty. If you don't like this feature of EAC and prefer fast copies instead of secure copies, you should use the fast or burst extraction option in the options menu. But of course in fast mode, the program will no longer be able to find read errors. Only if a read error occurs in a sector synchronization area, will a sync error will still be displayed. Fast mode is sector synchronized with 2 blocks of 23 as synchronization blocks. Burst copy is even worse, no synchronization is done, enabling extraction at maximum speed of the drive. No error checking of any kind can be performed. If the stream ever breaks, it will tell the user in the status report by showing up suspicious positions. Of course this is only heuristic; there needn't be any errors on that positions; moreover there could be errors that are not found at all.
A new option for selecting the error recovery quality will determine how often these blocks of 16 reads will be done before giving up and working with the results obtained so far. For bad CDs, low error recovery quality will be fastest, but high recover quality should give best results.

=== Gap technology ===
In the new versions of EAC it is possible to detect pre-track gaps. These are the pauses between two tracks. Usually they are two seconds long and a CD player will display a negative time during this pause. By enabling the option ''Detect Pre-Track Gaps'' it will be possible to detect all gap-lengths by reading the sub-channel information. Because this information is not stored on the CD directly retrievable, EAC has to search for the position a track ends. This search is quite fast, but it still takes on average a second per track. That's why I made it possible to disable it in the options. Besides that option you can choose to add the gaps to the previous track nevertheless. Otherwise you can choose either to append the gap to the correct track or to leave it out . A benefit of performing the detection and getting the gap times is the selection of a range to copy. There the correct times will be displayed. One last word on this topic: Because these pre-track gaps are found by testing positions, it is possible that it will not be 100% exact. But in most cases it will be correct.

=== Automatic feature detection technology ===
From version 0.8 beta on it is possible to autodetect CD-ROM drive features. For each drive the program builds a separate drive options page. On this option page this function can be called.
There are two different features that will be checked by EAC: First if the stream is accurate and second, if the drive caches audio data. Even if the drive has a cache (drive specifications), it does not automatically mean that the drive uses the cache for audio extractions.
The test for the accurate stream feature should be always correct, but testing for cache will give some problems with drives that extract audio very slowly (under 4× speed). If results are uncertain (given e.g. two different results on different tests), you should assume that the drive does caching. The new secure mode for non-accurate and/or caching drives should work for all drives. The other new read modes are only a bit faster. If testing for accurate stream only sometimes gives a negative result, then you could nevertheless try to use the accurate secure mode. From version 0.8 beta on it is possible to autodetect CD-ROM drive features. For each drive the program builds a separate drive options page. On this option page this function can be called.

=== Track synchronization technology ===
Usually CD audio extraction programs will extract one track after another. This could cause some problems on CD-ROM drives which are not accurate, when using a CD which has no gaps. When this option is enabled in the EAC options, EAC will synchronize a track with a preceding track if there is no silence at the track junction, so track transitions will be free from jitter artefacts (e.g. on live recordings).

=== Offset technology ===
''Sample Offset'' is another new feature of EAC, it will help to always get the same WAVs compared to a different reader and to prevent generation losses. Nearly all drives can not position the head correctly. That means if the program tells the drive to read block 10000 it will probably read data somewhere in block 9998 instead. But this is not visible to the reading program, it won't know if it is really the data it wanted. Usually the head will be set always to a fixed offset before or after the correct read position. So it is possible to detect this offset once and use it for all CDs coming afterwards. To find out the offset of any drive the offset has to be calculated relative to an absolute offset (reference offset).

To implement this detection for all drives some bytes from common CDs (reference CDs) are used. These are the reference each CD-ROM drive has to compare with. Of course it was implemented only a limited selection of CDs that can be used to detect this offset. Sometimes there are different versions (releases) of the same CD, but only the same press like the one that was used will work. Furthermore, drives that have jitter are unable to position their heads correctly. So you should activate the secure or fast extraction method and moreover if your drive does caching, activate no-caching emulation. The ''Searching Track Start'' algorithm tries to find the correct start position even if jitter occurs. But this is not always possible, mainly if the drive jitters too much. But it can be shown that nearly 80% of the reads will get the same results. A drive's characteristic offset can be found automatically from the CD from on the list of reference CDs. Because of the mentioned jitter error the value given back is also not 100% sure. You should start the test several times and remember to activate emulate no-caching if necessary. Then you should get one value that occurs more often than other values. '''You should use this test on two different CDs at least! Both tests should give back the same value!'''
As different models of common CD-R writer usually do not add the same offset on writing, it seems that also big CD manufactures also do not always press the same offset on their CDs. So it was determined the most common offset of pressed CDs and integrated it into the offset detection routines.
Please help us measure more reference CDs. If you have a Plextor 14/32 32× CD-ROM drive, we know the offset. So all you have to do is run some popular disks from your own collection through it with a utility you could download here and send us the output.

== Exact Audio Copy guides ==
You can begin configuring EAC by starting with the Drive Configuration followed by the Gap Settings and finally, the Encoder Options. Remember to use only an original, factory-pressed Audio CD for configuring EAC. Please do not use, CD-Rs, CD-RWs, bootlegs or any such discs. Also use a non copy-protected disc which carries the familiar “Compact Disc-Digital Audio” logo.

=== General guides ===
* [[EAC Configuration Wizard]]
* [[EAC configuration]]
* [[EAC Drive Configuration]]
* EAC [[Gap settings]]

=== Compression guides ===
* [[EAC and FLAC]]
* [[EAC and Lame]]
* [[EAC and AAC]]
* [[EAC and Monkeys Audio]]
* [[EAC and Musepack]]
* [[EAC and Ogg Vorbis]]
* [[EAC and TAK]]
* [[EAC and WavPack]]
* [[EAC and LossyWAV]]

== See also ==
* [[EAC CUE Sheets]] ASCII formats explained
* [[EAC Vs CDex SecureMode | EAC secure mode versus CDex full paranoia]] (by Pio2001)
* [[REACT]] 2 integration for running EAC scripts

== External links ==
* [http://www.rjamorim.com/rrw/eac.html Historical versions of EAC] at ReallyRareWares
* [http://www.digital-inn.de/forum271/ EAC forums]

[[Category:CD Rippers]]

EAC and LossyWAV

2008-10-06T09:01:31Z

Synthetic Soul: Initial version

= Software Needed =
* [http://www.exactaudiocopy.de/en/index.php/resources/download/ Exact Audio Copy]
* [[LossyWAV]]
* Either:
** [[FLAC]]
** [[TAK]]
** [[WavPack]]

= Installation =
'''Note:''' This guide assumes that EAC is has been configured for secure ripping, if not please follow [[EAC_Drive_Configuration | this]] guide.
* Extract lossywav.exe and your chosen encoder to a folder, or folders, of your choosing.

= Configuration =
* Open EAC and insert a CD into the drive.
* Click the '''EAC''' menu and select '''Compression Options'''.
* Click the '''External Compression''' Tab, and check '''Use external program for compression'''.
* Change '''Parameter Passing Scheme''' to '''User Defined Encoder'''.
* Change '''Use file extension''' to '''.flac'''.
* Click the '''Browse''' button and locate '''cmd.exe'''. In Windows XP it can be found in '''C:\WINDOWS\system32'''.
* Ensure '''Use CRC check''' and '''Add ID3 tag''' are not checked.
* Ensure '''Check for external programs return code''' is checked.
* In the '''Addtional command line options''' box, copy and paste the following.

===FLAC===

/d /c C:\"Program Files"\LossyWAV\lossywav.exe %s --standard --silent --stdout|C:\"Program Files"\FLAC\flac.exe - -b 512 '''-5''' -f -T "artist=%a" -T "title=%t" -T "album=%g" -T "date=%y" -T "tracknumber=%n" -T "genre=%m" -o %d

===TAK (no tagging)===

/d /c C:\"Program Files"\LossyWAV\lossywav.exe %s --standard --silent --stdout|C:\"Program Files"\TAK\takc.exe -e '''-p2''' -fsl512 -ihs - %d

===WavPack===

/d /c C:\"Program Files"\LossyWAV\lossywav.exe %s --standard --silent --stdout|C:\"Program Files"\WavPack\wavpack.exe '''-h''' --blocksize=512 --merge-blocks -i -w "Artist=%a" -w "Title=%t" -w "Album=%g" -w "Year=%y" -w "Track=%n" -w "Genre=%m" - %d

'''Note:''' The green text indicates where you would change the compression level or add settings for the encoder.

Do not worry what bit rate is shown in the bit rate drop down box, this will be ignored, as will the quality setting chosen below it.

[[Image:EACandLossyWAV.gif|frame|center|EAC External Compression dialogue configured for LossyFLAC ]]

==Addtional Reading==
* [[Exact_Audio_Copy | Exact Audio Copy]]
* [[LossyWAV]]
* [[FLAC]]
* [[TAK]]
* [[WavPack]]
* [[Lossless | About Lossless Compression]]

[[Category:Guides]]
[[Category:EAC Guides]]

File:EACandLossyWAV.gif

2008-10-06T08:58:14Z

Synthetic Soul: EAC External Compression dialogue configured for LossyFLAC

EAC External Compression dialogue configured for LossyFLAC

TAK

2008-04-08T13:59:23Z

Synthetic Soul: Updated graph and summary to 1.0.4

{{Codec Infobox
| name = Tom's lossless Audio Kompressor
| logo =
| type = lossless
| purpose = lossless audio compression.
| maintainer = Thomas Becker
| recommended_encoder = TAK encoder
| recommended_text = TAK v1.0.4
| website = [http://thbeck.de/Tak/Tak.html ThBeck.de/Tak/Tak.html] ''(german)''
}}

== Description ==
'''Tom's lossless Audio Kompressor''' ('''TAK''') is a lossless audio compressor which promises compression performance similar to [[Monkey's Audio]] “High” and decompression speed similar to [[Free Lossless Audio Codec|FLAC]].

=== Features ===
* High compression
* Fast compression and decompression speed
* Streaming support (necessary headers for decompressing the audio are written to the stream every 2 seconds)
* Piping support for encoding
* Error tolerance (single bit error will never affect more than 250 ms)
* Error detection (each frame protected by a 24-bit checksum (CRC))

=== Pros ===
* Fast encoding speed (while providing better compression TAK encodes as fast as [[Free Lossless Audio Codec|FLAC]] -8 in TAK's “Insane” and several times faster in “Turbo” mode)
* Fast decompression speed (on par with FLAC / [[WavPack]])
* Good compression levels (on par with [[Monkey's Audio]] High)
* Error Robustness
* Fast Seeking

=== Cons ===
* Closed Source (at the moment)
* No hardware support
* Very limited software support (playback: [[Winamp]] & [[foobar2000]] plugins, tagging: Mp3Tag)

== Hardware and Software That Support TAK ==
=== Hardware ===
* None

=== Software ===
==== Windows ====
* TAK SDK 1.0.5 – Software Development Kit for TAK [http://www.hydrogenaudio.org/forums/index.php?showtopic=54159 here]
* Winamp Plugin 1.0.7 [http://www.hydrogenaudio.org/forums/index.php?showtopic=54159 here]
* foo_input_tak, TAK decoder for [[foobar2000]] [http://www.hydrogenaudio.org/forums/index.php?showtopic=54087 here] (supports tagging and [[Replay Gain]])
* [[Mp3tag]] – universal tag editor with support for TAK
* shntool (since version 3.0.6)

==== Linux ====
* The TAK reference applications (GUI as well as commandline) are known to run on Linux via Wine.

== Recommended Settings ==
* Default compression: “-p2” (formerly ''Normal'') is the most attractive setting, providing an excellent compromise between compression and encoding speed. (At compression levels close to [[Monkey's Audio]] High (<0.4% difference), it is able to encode more quickly.)
takc -e [input file]
* Highest compression: “-pMax” (same as -p5m) (This will create files which are comparable in size to file created using [[Monkey's Audio]] High. Decompression speed is comparable to [[WavPack]] Normal.)
takc -e -pMax [input file]
* Fastest compression: “-p0” (This will create files which are comparable in size to [[Monkey's Audio]] Fast or [[WavPack]] High. Decompression speed is comparable to [[Free Lossless Audio Codec|FLAC]] 0.)
takc -e -p0 [input file]

=== TAK Performance Graph ===
[[Image:TAK_performance_graph_1-0-4.png|frame|center|Graph showing encoding and decoding rate against compression, using data from Synthetic Soul's test on TAK 1.0.4 (see [[TAK#External Links|External Links]])]]

== Using TAK ==
=== TAK with [[foobar2000]] ===
* Copy the takc.exe to your [[foobar2000]] directory
* Go to File → Preferences → Tools → Converter
* Set it up as shown:
[[Image:Tak_foobar_converter.png|frame|center|Screenshot of foobar 0.9.5 Converter settings for TAK 1.0.3]]
'''Note:''' replace -p2 with the desired compression level.

* TAK introduced encoding from STDIN in version 1.0.3, eliminating the need for a temporary file and greatly improving overall compression time. If you are using an earlier version of TAK use the following command line instead:
-e -p2 %s %d
* Use [[APEv2 specification|APEv2]] tagging (will be used as internal tagging)

=== TAK with EAC ===
Please read the [[EAC and TAK|wiki guide]], which details how to create TAK files with [[Exact Audio Copy|EAC]].

== Future Features ==
* Unicode support
* MD5 audio checksums for verification and identification
* A German version
* Embedded cue sheets
* Embedded cover art
* Multichannel audio

== Frequently Asked Questions ==
; Is the codec safe for use?
: Yes. To check, convert a WAVE to TAK and back and compare the two (or use foobar's bitcompare tool).
; Why should I use TAK?
: TAK offers high compression ratios with great decoding rates.
; What can I compress with TAK?
: TAK 1.0 can compress any integer-format (up to 24 bits per channel) PCM RIFF WAVE file (.wav). Piping support as of v1.0.3 is implemented, so converting lossless files to WAV first is not necessary.
; What about hardware support?
: None at the moment. Although, ''-p0 (Turbo)'', ''-p1 (Fast)'' and ''-p2 (Normal)'' are the candidates for hardware playback.
; When will the source be opened?
: Yes, TAK will be open-source, as soon as the code is ported to C or C++ and documented. However, Thomas has mentioned that he would like to improve the codec before opening the source.

== External Links ==
* [http://thbeck.de/Tak/Tak.html thbeck.de/Tak/Tak.html] – Official Website ''(german)''
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=61875 TAK 1.0.4 Release Announcement / Discussion Thread on HA] ''(english)''
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=61874 TAK 1.0.4 Downloads]
* [http://synthetic-soul.co.uk/comparison/lossless/ synthetic-soul.co.uk/comparison/lossless] – Comparison with Other Codecs (by Synthetic Soul)
* [http://flac.sourceforge.net/comparison.html flac.sourceforge.net/comparison.html] – An Updated Comparison (from FLAC Homepage)

[[Category:Lossless]]
[[Category:Encoder/Decoder]]

File:TAK performance graph 1-0-4.png

2008-04-08T13:53:27Z

Synthetic Soul: Compares encoding, decoding speed and compression of the TAK audio format with v1.0.4

Compares encoding, decoding speed and compression of the TAK audio format with v1.0.4

REACT:Adding Support For Monkey's Audio

2008-04-06T21:07:10Z

Synthetic Soul: Added piping info

To configure [[REACT]] to use an encoder that is not supported with the original INI and CFG files you will need to make changes to both the INI and CFG file you require.

Below you will find additional text that you will need to add to your config files to use [[Monkey's Audio]] with [[REACT]]. This is meant as an example, to demonstrate what is required to add any codec that you choose. The naming schemes and meta data used are based on the examples in the initial INI and CFG files; you may want to change them to fit your methodology.

==REACT.ini==

===Settings===
Specify that we want to use [[Monkey's Audio]] as our image format.

ImageExt=ape

===UserTrackFormats===
Specify that we want to encode tracks using [[Monkey's Audio]].

Ape=1

===UserOutputNames===
Specify the directories for [[Monkey's Audio]] images and tracks.

ImageDir_Ape=@OutRoot@\APE-images\$cdartist$
TrackDir_Ape=@OutRoot@\APE\$cdartist$\[$year$] $album$

===UserSettings===
Specify any encoding options and the version used.

Opt_Ape=-c2000
Ver_Ape=4.01

==REACT-image.cfg==

===REM ** Transfer RG values from Wavgain calculations, instead of recalculation.===
Add the text below under the comment above, with the other similar lines.

SET RG_Ape=-t "replaygain_album_gain=%album_gain% dB" -t "replaygain_album_peak=%album_peak%"
SET RG_Ape_acdir=-t $qreplaygain_album_gain=%album_gain% dB$q -t $qreplaygain_album_peak=%album_peak%$q

===REM ---- Image ----===
Add the text below under the comment above, with the other similar lines.

As [[Monkey's Audio]] does not support inline tagging this section uses '''[[Monkey's Audio|mac.exe]]''' to encode, and then '''[[Tag_(tagger)|tag.exe]]''' to add [[APEv2]] tags to the newly-created [[Monkey's Audio]] file. You will need to add '''[[Monkey's Audio|mac.exe]]''' and '''[[Tag_(tagger)|tag.exe]]''' to your [[REACT]] '''tools''' directory.

IF NOT @ImageExt@==ape GOTO end_ape_image
SET dest="@ImageDir_Ape@"
IF NOT EXIST %dest% MKDIR %dest%
@tools@\mac.exe "@source@" "@image@" @Opt_Ape@
@tools@\tag.exe %RG_Ape% -t "%ArtistField%=@cdartist@" -t album="@album@" -t totaltracks="@numtracks@" -t year="@year@" -t genre="@genre@" -t comment="@comment@" -t encodedby="%USERNAME%" -t encodersettings="Monkey's Audio @Ver_Ape@ @Opt_Ape@" -f cuesheet="@cuesheet@" -f eaclog="@eaclog@" "@image@"
MOVE /Y "@image@" %dest%
MOVE /Y "@cuesheet@" %dest%
IF %have_cover%==1 COPY /Y "@cover@" %dest%\"@basename@.jpg"
:end_ape_image

===REM ---- Tracks ---- ===
Add the text below under the comment above, with the other similar lines.

This section uses [[ACDIR]] to create [[Monkey's Audio]] track files. It is complicated by the fact that [[Monkey's Audio]] does not support piping, or inline tagging. The section uses [[ACDIR]] to first split the image [[WAV|WAVE]] into tracks [[WAV|WAVEs]], and then uses [[ACDIR]] again to execute mutiple commands for each track, these being:

# Use [[Monkey's Audio|mac.exe]] to encode the relevant track [[WAV|WAVE]].
# Use [[Tag_(tagger)|tag.exe]] to add [[APEv2]] tags to the [[Monkey's Audio]] file.
# Delete the [[WAV|WAVE]] file.

IF NOT @Ape@==1 GOTO end_ape_tracks
SET dest="@TrackDir_Ape@"
IF NOT EXIST %dest% MKDIR %dest%
PUSHD %dest%
IF @various@==1 SET VA_tag=-t $qalbum artist=@VA@$q
@tools@\acdir.exe --overwrite --output "%TrackName%.wav" --extract "@sourcecuesheet@"
@tools@\acdir.exe --exec "@tools@\mac.exe $q%TrackName%.wav$q $q%TrackName%.ape$q @Opt_Ape@ && @tools@\tag.exe %RG_Ape_acdir% %VA_tag% -t artist=$#a -t album=$#T -t title=$#t -t track=$n/$N -t year=$q@year@$q -t genre=$q@genre@$q -t comment=$q@comment@$q -t encodedby=$q%USERNAME%$q -t encodersettings=$qMonkey's Audio @Ver_Ape@ @Opt_Ape@$q $q%TrackName%.ape$q && DEL $q%TrackName%.wav$q" "@sourcecuesheet@"
COPY /Y "@eaclog@" "EAClog.txt"
IF %have_cover%==1 COPY /Y "@cover@" "folder.jpg"
IF EXIST "@albumfile@.[*].cue" COPY /Y "@albumfile@.[*].cue" .
POPD
:end_ape_tracks

====Piping to Mac.exe====
The offical version of mac.exe does not support piping, but the version that can be found on the [http://etree.org/shnutils/shntool/ shntool] website does. If you are using this version you can save some time, by replacing the code above with the following:

IF NOT @Ape@==1 GOTO end_ape_tracks
SET dest="@TrackDir_Ape@"
IF NOT EXIST %dest% MKDIR %dest%
PUSHD %dest%
IF @various@==1 SET VA_tag=-t $qalbum artist=@VA@$q
@tools@\acdir.exe --overwrite --output "%TrackName%.ape" --pipe "@tools@\mac.exe - $#o @Opt_Ape@ && @tools@\tag.exe %RG_Ape_acdir% %VA_tag% -t artist=$#a -t album=$#T -t title=$#t -t track=$n/$N -t year=$q@year@$q -t genre=$q@genre@$q -t comment=$q@comment@$q -t encodedby=$q%USERNAME%$q -t encodersettings=$qMonkey's Audio @Ver_Ape@ @Opt_Ape@$q $q%TrackName%.ape$q" "@sourcecuesheet@"
COPY /Y "@eaclog@" "EAClog.txt"
IF %have_cover%==1 COPY /Y "@cover@" "folder.jpg"
IF EXIST "@albumfile@.[*].cue" COPY /Y "@albumfile@.[*].cue" .
POPD
TITLE "@album@"
POPD
:end_ape_tracks

This allows [[ACDIR]] to pipe the audio data to [[Monkey's Audio|mac.exe]], rather than creating temporary WAVE files.

==REACT-track.cfg==

===REM ============== Begin Main Script ================== ===
Add the text below under the comment above, with the other similar lines.

SET TrackDir_Ape="@TrackDir_Ape@"

===REM ---- Track ---- ===
Add the text below under the comment above, with the other similar lines.

As [[Monkey's Audio]] does not support inline tagging this section uses '''[[Monkey's Audio|mac.exe]]''' to encode, and then '''[[Tag_(tagger)|tag.exe]]''' to add [[APEv2]] tags to the newly-created [[Monkey's Audio]] file. You will need to add '''[[Monkey's Audio|mac.exe]]''' and '''[[Tag_(tagger)|tag.exe]]''' to your [[REACT]] '''tools''' directory.

IF NOT @Ape@==1 GOTO end_ape_tracks
IF NOT EXIST %TrackDir_Ape% MKDIR %TrackDir_Ape%
PUSHD %TrackDir_Ape%
IF @various@==1 SET VA_tag=-t "album artist=@VA@"
ECHO ON
@tools@\mac.exe "@source@" "%TrackName%.ape" @Opt_Ape@
@tools@\tag.exe %VA_tag% -t artist="@artist@" -t album="@album@" -t track="@track@/@numtracks@" -t title="@title@" -t year="@year@" -t genre="@genre@" -t comment="@comment@" -t encodedby="%USERNAME%" -t encodersettings="Monkey's Audio @Ver_Ape@ @Opt_Ape@" "%TrackName%.ape"
@ECHO OFF
IF %have_cover%==1 IF NOT EXIST folder.jpg COPY "@cover@" folder.jpg
TITLE @track@/@numtracks@ - "@album@"
POPD
:end_ape_tracks

==Related Thread==
This tip is a result of a the discussion in the thread [http://www.hydrogenaudio.org/forums/index.php?showtopic=62321 Using REACT 2.0 - I need help.......].

==See Also==
* [[Monkey's Audio]]
* [[Tag_(tagger)|Case's Tag]]

==External Links==
* [http://nyaochi.sakura.ne.jp/xoops/modules/mysoftwares/tc_2.html ACDIR]

[[Category:REACT|Adding Support For Monkey's Audio]]

REACT:Adding Support For Monkey's Audio

2008-04-06T18:01:31Z

Synthetic Soul: Initial version

To configure [[REACT]] to use an encoder that is not supported with the original INI and CFG files you will need to make changes to both the INI and CFG file you require.

Below you will find additional text that you will need to add to your config files to use [[Monkey's Audio]] with [[REACT]]. This is meant as an example, to demonstrate what is required to add any codec that you choose. The naming schemes and meta data used are based on the examples in the initial INI and CFG files; you may want to change them to fit your methodology.

==REACT.ini==

===Settings===
Specify that we want to use [[Monkey's Audio]] as our image format.

ImageExt=ape

===UserTrackFormats===
Specify that we want to encode tracks using [[Monkey's Audio]].

Ape=1

===UserOutputNames===
Specify the directories for [[Monkey's Audio]] images and tracks.

ImageDir_Ape=@OutRoot@\APE-images\$cdartist$
TrackDir_Ape=@OutRoot@\APE\$cdartist$\[$year$] $album$

===UserSettings===
Specify any encoding options and the version used.

Opt_Ape=-c2000
Ver_Ape=4.01

==REACT-image.cfg==

===REM ** Transfer RG values from Wavgain calculations, instead of recalculation.===
Add the text below under the comment above, with the other similar lines.

SET RG_Ape=-t "replaygain_album_gain=%album_gain% dB" -t "replaygain_album_peak=%album_peak%"
SET RG_Ape_acdir=-t $qreplaygain_album_gain=%album_gain% dB$q -t $qreplaygain_album_peak=%album_peak%$q

===REM ---- Image ----===
Add the text below under the comment above, with the other similar lines.

As [[Monkey's Audio]] does not support inline tagging this section uses '''[[Monkey's Audio|mac.exe]]''' to encode, and then '''[[Tag_(tagger)|tag.exe]]''' to add [[APEv2]] tags to the newly-created [[Monkey's Audio]] file. You will need to add '''[[Monkey's Audio|mac.exe]]''' and '''[[Tag_(tagger)|tag.exe]]''' to your [[REACT]] '''tools''' directory.

IF NOT @ImageExt@==ape GOTO end_Ape_image
SET dest="@ImageDir_Ape@"
IF NOT EXIST %dest% MKDIR %dest%
@tools@\mac.exe "@source@" "@image@" @Opt_Ape@
@tools@\tag.exe %RG_Ape% -t "%ArtistField%=@cdartist@" -t album="@album@" -t totaltracks="@numtracks@" -t year="@year@" -t genre="@genre@" -t comment="@comment@" -t encodedby="%USERNAME%" -t encodersettings="Monkey's Audio @Ver_Ape@ @Opt_Ape@" -f cuesheet="@cuesheet@" -f eaclog="@eaclog@" "@image@"
MOVE /Y "@image@" %dest%
MOVE /Y "@cuesheet@" %dest%
IF %have_cover%==1 COPY /Y "@cover@" %dest%\"@basename@.jpg"
:end_Ape_image

===REM ---- Tracks ---- ===
Add the text below under the comment above, with the other similar lines.

This section uses [[ACDIR]] to create [[Monkey's Audio]] track files. It is complicated by the fact that [[Monkey's Audio]] does not support piping, or inline tagging. The section uses [[ACDIR]] to first split the image [[WAV|WAVE]] into tracks [[WAV|WAVEs]], and then uses [[ACDIR]] again to execute mutiple commands for each track, these being:

# Use [[Monkey's Audio|mac.exe]] to encode the relevant track [[WAV|WAVE]].
# Use [[Tag_(tagger)|tag.exe]] to add [[APEv2]] tags to the [[Monkey's Audio]] file.
# Delete the [[WAV|WAVE]] file.

IF NOT @Ape@==1 GOTO end_Ape_tracks
SET dest="@TrackDir_Ape@"
IF NOT EXIST %dest% MKDIR %dest%
PUSHD %dest%
IF @various@==1 SET VA_tag=-t $qalbum artist=@VA@$q
@tools@\acdir.exe --overwrite --output "%TrackName%.wav" --extract "@sourcecuesheet@"
@tools@\acdir.exe --exec "@tools@\mac.exe $q%TrackName%.wav$q $q%TrackName%.ape$q @Opt_Ape@ && @tools@\tag.exe %RG_Ape_acdir% %VA_tag% -t artist=$#a -t album=$#T -t title=$#t -t track=$n/$N -t year=$q@year@$q -t genre=$q@genre@$q -t comment=$q@comment@$q -t encodedby=$q%USERNAME%$q -t encodersettings=$qMonkey's Audio @Ver_Ape@ @Opt_Ape@$q $q%TrackName%.ape$q && DEL $q%TrackName%.wav$q" "@sourcecuesheet@"
COPY /Y "@eaclog@" "EAClog.txt"
IF %have_cover%==1 COPY /Y "@cover@" "folder.jpg"
IF EXIST "@albumfile@.[*].cue" COPY /Y "@albumfile@.[*].cue" .
POPD
:end_Ape_tracks

==REACT-track.cfg==

===REM ============== Begin Main Script ================== ===
Add the text below under the comment above, with the other similar lines.

SET TrackDir_Ape="@TrackDir_Ape@"

===REM ---- Track ---- ===
Add the text below under the comment above, with the other similar lines.

As [[Monkey's Audio]] does not support inline tagging this section uses '''[[Monkey's Audio|mac.exe]]''' to encode, and then '''[[Tag_(tagger)|tag.exe]]''' to add [[APEv2]] tags to the newly-created [[Monkey's Audio]] file. You will need to add '''[[Monkey's Audio|mac.exe]]''' and '''[[Tag_(tagger)|tag.exe]]''' to your [[REACT]] '''tools''' directory.

IF NOT @Ape@==1 GOTO end_Ape_tracks
IF NOT EXIST %TrackDir_Ape% MKDIR %TrackDir_Ape%
PUSHD %TrackDir_Ape%
IF @various@==1 SET VA_tag=-t "album artist=@VA@"
ECHO ON
@tools@\mac.exe "@source@" "%TrackName%.ape" @Opt_Ape@
@tools@\tag.exe %VA_tag% -t artist="@artist@" -t album="@album@" -t track="@track@/@numtracks@" -t title="@title@" -t year="@year@" -t genre="@genre@" -t comment="@comment@" -t encodedby="%USERNAME%" -t encodersettings="Monkey's Audio @Ver_Ape@ @Opt_Ape@" "%TrackName%.ape"
@ECHO OFF
IF %have_cover%==1 IF NOT EXIST folder.jpg COPY "@cover@" folder.jpg
TITLE @track@/@numtracks@ - "@album@"
POPD
:end_Ape_tracks

==Related Thread==
This tip is a result of a the discussion in the thread [http://www.hydrogenaudio.org/forums/index.php?showtopic=62321 Using REACT 2.0 - I need help.......].

==See Also==
* [[Monkey's Audio]]
* [[Tag_(tagger)|Case's Tag]]

==External Links==
* [http://nyaochi.sakura.ne.jp/xoops/modules/mysoftwares/tc_2.html ACDIR]

[[Category:REACT|Adding Support For Monkey's Audio]]

REACT

2008-03-20T09:16:42Z

Synthetic Soul: Removed specific mod version

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.

REACT v2.0 as published does not currently work with EAC 0.99 prebeta 1-3 due to a naming scheme mismatch between old and new EAC versions, and also has a number of known bugs addressed with [[REACT:Mods#Synthetic_Soul.27s_Mod|Synthetic Soul's Mod]] of REACT.
==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.
OutRoot is the common directory used under many file naming schemes. Individual directories and naming schemes for each format are set with respective ImageDir_Flac, TrackDir_AAC, etc. When saving formats to different drives OutRoot must be replaced with address spelled out. 
Different naming schemes are available for Various Artist CDs. see variable options under METADATA 
TrackName_NA - file naming for single artist 
TrackName_VA - file naming for various artist 
TrackName_SA_acdir=$n - $~t - ACDIR is used when ripping an image and splitting it into tracks. It will be passing [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=35158&view=findpost&p=327260 EAC variables] directly through. The tilde [http://nyaochi.sakura.ne.jp/xoops/modules/mysoftwares/tc_2.html replaces illegal filename characters with a space]. 
File naming schemes are largely up to personal usage and preference but some examples are 
[http://www.teqnilogik.com/tutorials/eac.htm#SettingEACOptions example 1]
[http://www.hydrogenaudio.org/forums/index.php?showtopic=956 example 2]
[http://www.hydrogenaudio.org/forums/index.php?showtopic=47558 example 3]
[http://www.hydrogenaudio.org/forums/index.php?showtopic=31698 example 4]

===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=50273

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

Download [[User:Synthetic Soul|Synthetic Soul's]] mod (for EAC 0.99 support and more) from this page : [[REACT:Mods]]

[[Category:REACT]]

REACT:Mods

2008-02-04T09:44:42Z

Synthetic Soul: Updated to 2.0.ssb16p

==Synthetic Soul's Mod==

[[Image:React-mod.png|thumb|Screenshot demonstrating the Additional Meta Data dialogue]]

[[User:Synthetic Soul|Synthetic Soul]] maintains a mod of [[REACT|REACT 2.0]].

===Key Points===

* Additional Meta Data dialogue allows you to easily edit supplemental disc and track information.
* Track-level tokens supported.
* Additional meta data added to cuesheets, as REM statements.
* Fixes issue in REACT with '%' in any field ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] ).
* Fixes issue in REACT with '&' in the track name when using REACT-track.cfg ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] ).
* Works with new- (EAC 0.99 prebeta 1) and old-style log files.
* Will only rewrite INI file on major or minor version change, not a new build.
* Use Test & Copy by adding <code>Test=1</code> under the Settings section of REACT.ini.

===Description===

The main purpose of this mod is to allow users to easily provide additional meta data to the [[REACT]] configs. This is achieved by the introduction of an Additional Meta Data dialogue, which allows users to easily create, amend and delete additional tokens, which can be used either to set tag values (e.g.: @discnumber@) , or as variables used in conditions within the config to alter the processing path (e.g.: @_disctype@).

The dialogue is opened using '''Alt+F5'''. The new dialogue is non-modal, but will stay on top of the EAC main window; if you minimise [[EAC]] the dialogue is minimised also. If you close the dialogue it is simply hidden from view, so your list items will stay intact. Therefore, if you need to set various meta data for each disc that you are ripping, you may choose to keep the dialogue open throughout the process; however, if you only need to use it to alter values infrequently, you can leave it hidden, but know that the values are still available to your config file.

The current list state is recorded in a new file called "meta.ini" in your REACT folder. The values in this INI are eventually used to replace tokens with values when your config runs. The INI is updated any time that you update or delete an item.

====Setting Defaults====

Default tokens and their values can be set in the REACT.ini file, under the newly created '''DefaultMetaData''' section. When [[REACT]] is initially opened, or the user changes a disc, the token values are reset to these defaults. The dialogue allows you to quickly and easily amend the token values on a per disc basic, rather than having to edit the INI manually (see '[[REACT:Mods#A Basic Alternative|A Basic Alternative]]').

A simple example would be the @discnumber@ and @totaldiscs@ tokens, which are initially set to a default of '1'. If you are ripping a multi-disc album you can alter these values as required, in the knowledge that they will revert to '1' when a new disc is inserted. The article '[[REACT:Adding Support For Disc Information]]' details config changes that will use these tokens to add disc information to your files, and amend the folder structure, if @totaldiscs@ exceeds one.

====Processing Tokens====

Your additional tokens are inserted into any [[Cuesheet|cuesheets]] created using REM statements, so are available to ACDIR, and any other application that can parse [[Cuesheet|cuesheets]] with REM statements. Album-level tokens are added at the top of the [[Cuesheet|cuesheet]], with the other global values. Track-level tokens are added beneath the appropriate TRACK statement. Therefore, if you are ripping to an image, you can still use these values with any tracks you create, using ACDIR's $R{} and $r{} syntax, e.g.: $R{DISCNUMBER} and $r{COMPOSER}.

If you do not want certain tokens added to the cuesheet you can prefix the token name with an underscore, e.g.: @_disctype@. These are assumed to be temporary, or processing, tokens, used purely for conditionally executing sections of your config.

====Track-Level Tokens====

Most tokens are album-related. If you want to set track-level tokens you should use the format '''<token name>[<track number>]''', e.g.: '''composer[1]''' to set the composer token value for track one. Your config should refer to the token only by name, e.g.: @composer@. When processing track one, @composer@ will be replaced by the value of composer[1], when processing track two, @composer@ will be replaced by the value of composer[2], etc.

====Using The Tokens====

You can use both @ and $-style tokens in your config. When using $ tokens any integer value will be zero-padded ("4" -> "04") and any string values will be converted to a filename-friendly value, using the standard [[REACT]] character replacement. Therefore, if you create a token called '''discname''' you can use @discname@ when tagging, and $discname$ when creating a file or folder name.

===A Basic Alternative===
If you want to use additional tokens in your config but do not want to use this mod you ''can'' add additional variables to the existing '''UserTrackFormats''', '''UserOutputNames''', and, ''more pertinently'', '''UserSettings''' sections of REACT.ini. You will need to update these variables by hand in a text editor if the value required for the disc you are ripping differs from the current value set.

===Changelog===
2.0.ssb5, 03/05/07
* First public release.

2.0.ssb6, 04/05/07
* Additional Meta Data dialogue made child of EAC window.
* Changed function prefix from fGUI to fDiag to save confusion.

2.0.ssb8, 14/05/07
* Moved default values into REACT.ini.
* Fixed the code that writes track-level meta data to the cuesheet.
* Current token values now stored in "meta.ini", not "metadata.ini".
* Moved a little more code from the main source file into the include.

2.0.ssb9, 14/05/07
* Track cuesheets now supported.

2.0.ssb10, 30/05/07
* Added underscore prefix to identify temporary tokens.
* Fixed REACT issue with "%" in any field. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] )
* Fixed REACT issue with "&" in the track name when using REACT-track.cfg. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] )

2.0.ssb11, 01/07/07
* Works with new- (EAC 0.99 prebeta 1) and old-style (EAC 0.95 beta 4 and earlier) log files. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=501821 post] )
* Will only rewrite INI file on major or minor version change, not a new build.

2.0.ssb12, 02/07/07
* Log file handling now works correctly for track ripping.

2.0.ssb13, 04/07/07
* Reverted cover filename to "<album>.jpg" irrespective of EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=502330 post] )

2.0.ssb15, 17/07/07
* Reverted @albumfile@ to "<sourcedir>\<album>", irrespective of the EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=505038 post] )
* Add <code>Test=1</code> under the Settings section of REACT.ini to use Test and Copy mode.

2.0.ssb16, 29/07/07
* Fixed issues with meta data changing mid-process. meta.ini is now only updated with the GUI values immediately before a rip begins.
* Fixed bug with @ and $ values. @totaldiscs@ will now correctly return "3", while $totaldiscs$ will return "03".

2.0.ssb16b, 15/08/07
* Fixed issue with log file name when ripping a VA album to tracks ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=510414 post] ).

2.0.ssb16c, 21/08/07
* Add <code>CoverDownloaderXUI=1</CODE> to the [Settings] section of your REACT.ini when using Album Art XUI, and REACT will cope with JPEG, GIF, and PNG album art ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=511640 post] ).

2.0.ssb16d, 21/08/07
* Added BMP support to above.

2.0.ssb16e, 23/08/07
* Fixed bug with above, where the artist and album did not change with the disc.

2.0.ssb16f, 11/09/07
* Hitting Ctrl+F2 to reconfigure EAC will now ensure that the working directories used by EAC are in synch ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=515730 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=512481 post] ).

2.0.ssb16g, 17/09/07
* You can now process an existing wav/cue/log(/jpg) file-set by passing the full cuesheet path to REACT as a single parameter. This will treat the files as if they had just been created by EAC as per normal execution.

2.0.ssb16h, 17/09/07
* Set <code>CoverDownloaderLocalPath</code>, in the [Settings] section of your REACT.ini, to the path of your existing album art if you would rather chose those over any downloaded using the cover downloader. You may use $artist$ and $album$ tokens in the path, e.g.:
CoverDownloaderLocalPath=C:\Documents and Settings\My Name\My Documents\My Music\$artist$\$album$\folder.jpg

2.0.ssb16i, 12/11/07
* Fixed a bug with <code>CreateAllCuesheets</code> when detecting gaps is required ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529370 post] ).
* Reinstated <code>TracksHotVal</code>, after unwittingly removing the functionality.

2.0.ssb16j, 14/11/07
* Artist and album names are now correctly escaped in the album art command lines ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).
* Apostrophes in the log file name are now correctly replaced with a space (in track mode) ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).

2.0.ssb16k, 16/11/07
* Apostrophes no longer wrongly replaced, and double quotes now simply removed from album art command line. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=530101 post] ).
* UserOutputNames INI section no longer escaped, so you can again use Window's tokens, e.g.: %USERPROFILE% ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=530166 post] ).
* REACT now checks that EAC is the active window before sending the commands to create the four cuesheets.

2.0.ssb16l, 19/11/07
* Log file name in track mode now, finally, calculated correctly.
* The <code>RunCoverDownloader</code> values as documented in [[REACT|the wiki page]] should now work as expected.

2.0.ssb16m, 28/11/07
* The number of tracks to process is now calculated from a cuesheet in track mode.
* Expanded CreateAllCuesheets code to notify the user if a problem occurs.

2.0.ssb16n, 30/11/07
* Added Akkurat's improvements to the CreateAllCuesheets processing.
* Added nago's multi-thread amendments.
* Updated configs and INI are now included in the download.

2.0.ssb16o, 29/01/08
* Fixed a bug regarding track-level tokens with double-digit track numbers.

2.0.ssb16p, 02/02/08
* Fixed a bug with backslashes in additional meta data not being written to cuesheets.
* Double quotes in additional meta data are now converted to apostrophes when written to the batch file.

===Download===
[http://www.synthetic-soul.co.uk/temp/REACT_2.0.ssb16p.zip REACT 2.0.ssb16p]

[[Category:REACT|Mods]]

REACT:Mods

2008-01-29T11:05:45Z

Synthetic Soul: Updated to 2.0.ssb16o

==Synthetic Soul's Mod==

[[Image:React-mod.png|thumb|Screenshot demonstrating the Additional Meta Data dialogue]]

[[User:Synthetic Soul|Synthetic Soul]] maintains a mod of [[REACT|REACT 2.0]].

===Key Points===

* Additional Meta Data dialogue allows you to easily edit supplemental disc and track information.
* Track-level tokens supported.
* Additional meta data added to cuesheets, as REM statements.
* Fixes issue in REACT with '%' in any field ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] ).
* Fixes issue in REACT with '&' in the track name when using REACT-track.cfg ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] ).
* Works with new- (EAC 0.99 prebeta 1) and old-style log files.
* Will only rewrite INI file on major or minor version change, not a new build.
* Use Test & Copy by adding <code>Test=1</code> under the Settings section of REACT.ini.

===Description===

The main purpose of this mod is to allow users to easily provide additional meta data to the [[REACT]] configs. This is achieved by the introduction of an Additional Meta Data dialogue, which allows users to easily create, amend and delete additional tokens, which can be used either to set tag values (e.g.: @discnumber@) , or as variables used in conditions within the config to alter the processing path (e.g.: @_disctype@).

The dialogue is opened using '''Alt+F5'''. The new dialogue is non-modal, but will stay on top of the EAC main window; if you minimise [[EAC]] the dialogue is minimised also. If you close the dialogue it is simply hidden from view, so your list items will stay intact. Therefore, if you need to set various meta data for each disc that you are ripping, you may choose to keep the dialogue open throughout the process; however, if you only need to use it to alter values infrequently, you can leave it hidden, but know that the values are still available to your config file.

The current list state is recorded in a new file called "meta.ini" in your REACT folder. The values in this INI are eventually used to replace tokens with values when your config runs. The INI is updated any time that you update or delete an item.

====Setting Defaults====

Default tokens and their values can be set in the REACT.ini file, under the newly created '''DefaultMetaData''' section. When [[REACT]] is initially opened, or the user changes a disc, the token values are reset to these defaults. The dialogue allows you to quickly and easily amend the token values on a per disc basic, rather than having to edit the INI manually (see '[[REACT:Mods#A Basic Alternative|A Basic Alternative]]').

A simple example would be the @discnumber@ and @totaldiscs@ tokens, which are initially set to a default of '1'. If you are ripping a multi-disc album you can alter these values as required, in the knowledge that they will revert to '1' when a new disc is inserted. The article '[[REACT:Adding Support For Disc Information]]' details config changes that will use these tokens to add disc information to your files, and amend the folder structure, if @totaldiscs@ exceeds one.

====Processing Tokens====

Your additional tokens are inserted into any [[Cuesheet|cuesheets]] created using REM statements, so are available to ACDIR, and any other application that can parse [[Cuesheet|cuesheets]] with REM statements. Album-level tokens are added at the top of the [[Cuesheet|cuesheet]], with the other global values. Track-level tokens are added beneath the appropriate TRACK statement. Therefore, if you are ripping to an image, you can still use these values with any tracks you create, using ACDIR's $R{} and $r{} syntax, e.g.: $R{DISCNUMBER} and $r{COMPOSER}.

If you do not want certain tokens added to the cuesheet you can prefix the token name with an underscore, e.g.: @_disctype@. These are assumed to be temporary, or processing, tokens, used purely for conditionally executing sections of your config.

====Track-Level Tokens====

Most tokens are album-related. If you want to set track-level tokens you should use the format '''<token name>[<track number>]''', e.g.: '''composer[1]''' to set the composer token value for track one. Your config should refer to the token only by name, e.g.: @composer@. When processing track one, @composer@ will be replaced by the value of composer[1], when processing track two, @composer@ will be replaced by the value of composer[2], etc.

====Using The Tokens====

You can use both @ and $-style tokens in your config. When using $ tokens any integer value will be zero-padded ("4" -> "04") and any string values will be converted to a filename-friendly value, using the standard [[REACT]] character replacement. Therefore, if you create a token called '''discname''' you can use @discname@ when tagging, and $discname$ when creating a file or folder name.

===A Basic Alternative===
If you want to use additional tokens in your config but do not want to use this mod you ''can'' add additional variables to the existing '''UserTrackFormats''', '''UserOutputNames''', and, ''more pertinently'', '''UserSettings''' sections of REACT.ini. You will need to update these variables by hand in a text editor if the value required for the disc you are ripping differs from the current value set.

===Changelog===
2.0.ssb5, 03/05/07
* First public release.

2.0.ssb6, 04/05/07
* Additional Meta Data dialogue made child of EAC window.
* Changed function prefix from fGUI to fDiag to save confusion.

2.0.ssb8, 14/05/07
* Moved default values into REACT.ini.
* Fixed the code that writes track-level meta data to the cuesheet.
* Current token values now stored in "meta.ini", not "metadata.ini".
* Moved a little more code from the main source file into the include.

2.0.ssb9, 14/05/07
* Track cuesheets now supported.

2.0.ssb10, 30/05/07
* Added underscore prefix to identify temporary tokens.
* Fixed REACT issue with "%" in any field. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] )
* Fixed REACT issue with "&" in the track name when using REACT-track.cfg. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] )

2.0.ssb11, 01/07/07
* Works with new- (EAC 0.99 prebeta 1) and old-style (EAC 0.95 beta 4 and earlier) log files. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=501821 post] )
* Will only rewrite INI file on major or minor version change, not a new build.

2.0.ssb12, 02/07/07
* Log file handling now works correctly for track ripping.

2.0.ssb13, 04/07/07
* Reverted cover filename to "<album>.jpg" irrespective of EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=502330 post] )

2.0.ssb15, 17/07/07
* Reverted @albumfile@ to "<sourcedir>\<album>", irrespective of the EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=505038 post] )
* Add <code>Test=1</code> under the Settings section of REACT.ini to use Test and Copy mode.

2.0.ssb16, 29/07/07
* Fixed issues with meta data changing mid-process. meta.ini is now only updated with the GUI values immediately before a rip begins.
* Fixed bug with @ and $ values. @totaldiscs@ will now correctly return "3", while $totaldiscs$ will return "03".

2.0.ssb16b, 15/08/07
* Fixed issue with log file name when ripping a VA album to tracks ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=510414 post] ).

2.0.ssb16c, 21/08/07
* Add <code>CoverDownloaderXUI=1</CODE> to the [Settings] section of your REACT.ini when using Album Art XUI, and REACT will cope with JPEG, GIF, and PNG album art ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=511640 post] ).

2.0.ssb16d, 21/08/07
* Added BMP support to above.

2.0.ssb16e, 23/08/07
* Fixed bug with above, where the artist and album did not change with the disc.

2.0.ssb16f, 11/09/07
* Hitting Ctrl+F2 to reconfigure EAC will now ensure that the working directories used by EAC are in synch ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=515730 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=512481 post] ).

2.0.ssb16g, 17/09/07
* You can now process an existing wav/cue/log(/jpg) file-set by passing the full cuesheet path to REACT as a single parameter. This will treat the files as if they had just been created by EAC as per normal execution.

2.0.ssb16h, 17/09/07
* Set <code>CoverDownloaderLocalPath</code>, in the [Settings] section of your REACT.ini, to the path of your existing album art if you would rather chose those over any downloaded using the cover downloader. You may use $artist$ and $album$ tokens in the path, e.g.:
CoverDownloaderLocalPath=C:\Documents and Settings\My Name\My Documents\My Music\$artist$\$album$\folder.jpg

2.0.ssb16i, 12/11/07
* Fixed a bug with <code>CreateAllCuesheets</code> when detecting gaps is required ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529370 post] ).
* Reinstated <code>TracksHotVal</code>, after unwittingly removing the functionality.

2.0.ssb16j, 14/11/07
* Artist and album names are now correctly escaped in the album art command lines ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).
* Apostrophes in the log file name are now correctly replaced with a space (in track mode) ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).

2.0.ssb16k, 16/11/07
* Apostrophes no longer wrongly replaced, and double quotes now simply removed from album art command line. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=530101 post] ).
* UserOutputNames INI section no longer escaped, so you can again use Window's tokens, e.g.: %USERPROFILE% ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=530166 post] ).
* REACT now checks that EAC is the active window before sending the commands to create the four cuesheets.

2.0.ssb16l, 19/11/07
* Log file name in track mode now, finally, calculated correctly.
* The <code>RunCoverDownloader</code> values as documented in [[REACT|the wiki page]] should now work as expected.

2.0.ssb16m, 28/11/07
* The number of tracks to process is now calculated from a cuesheet in track mode.
* Expanded CreateAllCuesheets code to notify the user if a problem occurs.

2.0.ssb16n, 30/11/07
* Added Akkurat's improvements to the CreateAllCuesheets processing.
* Added nago's multi-thread amendments.
* Updated configs and INI are now included in the download.

2.0.ssb16o, 29/01/08
* Fixed a bug regarding track-level tokens with double-digit track numbers.

===Download===
[http://www.synthetic-soul.co.uk/temp/REACT_2.0.ssb16o.zip REACT 2.0.ssb16o]

[[Category:REACT|Mods]]

TAK

2008-01-18T14:26:27Z

Synthetic Soul:

{{Codec Infobox
| name = Tom's lossless Audio Kompressor
| logo =
| type = lossless
| purpose = lossless audio compression.
| maintainer = Thomas Becker
| recommended_encoder = TAK encoder
| recommended_text = TAK v1.0.3
| website = [http://thbeck.de/Tak/Tak.html ThBeck.de/Tak/Tak.html] ''(german)''
}}

== Description ==
'''Tom's lossless Audio Kompressor''' ('''TAK''') is a lossless audio compressor which promises compression performance similar to [[Monkey's Audio]] “High” and decompression speed similar to [[Free Lossless Audio Codec|FLAC]].

=== Features ===
* High compression
* Fast compression and decompression speed
* Streaming support (necessary headers for decompressing the audio are written to the stream every 2 seconds)
* Piping support for encoding
* Error tolerance (single bit error will never affect more than 250 ms)
* Error detection (each frame protected by a 24-bit checksum (CRC))

=== Pros ===
* Fast encoding speed (while providing better compression TAK encodes as fast as [[Free Lossless Audio Codec|FLAC]] -8 in TAK's “Insane” and several times faster in “Turbo” mode)
* Fast decompression speed (on par with FLAC / [[WavPack]])
* Good compression levels (on par with [[Monkey's Audio]] High)
* Error Robustness
* Fast Seeking

=== Cons ===
* Closed Source (at the moment)
* No hardware support
* Very limited software support (playback: [[Winamp]] & [[foobar2000]] plugins, tagging: Mp3Tag)

== Hardware and Software That Support TAK ==
=== Hardware ===
* None

=== Software ===
==== Windows ====
* TAK SDK 1.0.5 – Software Development Kit for TAK [http://www.hydrogenaudio.org/forums/index.php?showtopic=54159 here]
* Winamp Plugin 1.0.7 [http://www.hydrogenaudio.org/forums/index.php?showtopic=54159 here]
* foo_input_tak, TAK decoder for [[foobar2000]] [http://www.hydrogenaudio.org/forums/index.php?showtopic=54087 here] (supports tagging and [[Replay Gain]])
* [[Mp3tag]] – universal tag editor with support for TAK
* shntool (since version 3.0.6)

==== Linux ====
* The TAK reference applications (GUI as well as commandline) are known to run on Linux via Wine.

== Recommended Settings ==
* Default compression: “-p2” (formerly ''Normal'') is the most attractive setting, providing an excellent compromise between compression and encoding speed. (At compression levels close to [[Monkey's Audio]] High (<0.4% difference), it is able to encode more quickly.)
takc -e [input file]
* Highest compression: “-pMax” (same as -p5m) (This will create files which are comparable in size to file created using [[Monkey's Audio]] High. Decompression speed is comparable to [[WavPack]] Normal.)
takc -e -pMax [input file]
* Fastest compression: “-p0” (This will create files which are comparable in size to [[Monkey's Audio]] Fast or [[WavPack]] High. Decompression speed is comparable to [[Free Lossless Audio Codec|FLAC]] 0.)
takc -e -p0 [input file]

=== TAK Performance Graph ===
[[Image:TAK_performance_graph.png|frame|center|Graph showing encoding and decoding rate against compression, using data from Synthetic Soul's test on TAK 1.0.1 (see [[TAK#External Links|External Links]])]]

== Using TAK ==
=== TAK with [[foobar2000]] ===
* Copy the takc.exe to your [[foobar2000]] directory
* Go to File → Preferences → Tools → Converter
* Set it up as shown:
[[Image:Tak_foobar_converter.png|frame|center|Screenshot of foobar 0.9.5 Converter settings for TAK 1.0.3]]
'''Note:''' replace -p2 with the desired compression level.

* TAK introduced encoding from STDIN in version 1.0.3, eliminating the need for a temporary file and greatly improving overall compression time. If you are using an earlier version of TAK use the following command line instead:
-e -p2 %s %d
* Use [[APEv2 specification|APEv2]] tagging (will be used as internal tagging)

=== TAK with EAC ===
Please read the [[EAC and TAK|wiki guide]], which details how to create TAK files with [[Exact Audio Copy|EAC]].

== Future Features ==
* Unicode support
* MD5 audio checksums for verification and identification
* A German version
* Embedded cue sheets
* Embedded cover art
* Multichannel audio

== Frequently Asked Questions ==
; Is the codec safe for use?
: Yes. To check, convert a WAVE to TAK and back and compare the two (or use foobar's bitcompare tool).
; Why should I use TAK?
: TAK offers high compression ratios with great decoding rates.
; What can I compress with TAK?
: TAK 1.0 can compress any integer-format (up to 24 bits per channel) PCM RIFF WAVE file (.wav). Piping support as of v1.0.3 is implemented, so converting lossless files to WAV first is not necessary.
; What about hardware support?
: None at the moment. Although, ''-p0 (Turbo)'', ''-p1 (Fast)'' and ''-p2 (Normal)'' are the candidates for hardware playback.
; When will the source be opened?
: Yes, TAK will be open-source, as soon as the code is ported to C or C++ and documented. However, Thomas has mentioned that he would like to improve the codec before opening the source.

== External Links ==
* [http://thbeck.de/Tak/Tak.html thbeck.de/Tak/Tak.html] – Official Website ''(german)''
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=54160 TAK Release Announcement / Discussion Thread on HA] ''(english)''
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=54159 TAK Downloads]
* [http://synthetic-soul.co.uk/comparison/lossless/ synthetic-soul.co.uk/comparison/lossless] – Comparison with Other Codecs (by Synthetic Soul)
* [http://flac.sourceforge.net/comparison.html flac.sourceforge.net/comparison.html] – An Updated Comparison (from FLAC Homepage)

[[Category:Lossless]]
[[Category:Encoder/Decoder]]

TAK

2008-01-18T14:25:30Z

Synthetic Soul: Updated TAK with fooabr section (mainly the screenshot)

{{Codec Infobox
| name = Tom's lossless Audio Kompressor
| logo =
| type = lossless
| purpose = lossless audio compression.
| maintainer = Thomas Becker
| recommended_encoder = TAK encoder
| recommended_text = TAK v1.0.3
| website = [http://thbeck.de/Tak/Tak.html ThBeck.de/Tak/Tak.html] ''(german)''
}}

== Description ==
'''Tom's lossless Audio Kompressor''' ('''TAK''') is a lossless audio compressor which promises compression performance similar to [[Monkey's Audio]] “High” and decompression speed similar to [[Free Lossless Audio Codec|FLAC]].

=== Features ===
* High compression
* Fast compression and decompression speed
* Streaming support (necessary headers for decompressing the audio are written to the stream every 2 seconds)
* Piping support for encoding
* Error tolerance (single bit error will never affect more than 250 ms)
* Error detection (each frame protected by a 24-bit checksum (CRC))

=== Pros ===
* Fast encoding speed (while providing better compression TAK encodes as fast as [[Free Lossless Audio Codec|FLAC]] -8 in TAK's “Insane” and several times faster in “Turbo” mode)
* Fast decompression speed (on par with FLAC / [[WavPack]])
* Good compression levels (on par with [[Monkey's Audio]] High)
* Error Robustness
* Fast Seeking

=== Cons ===
* Closed Source (at the moment)
* No hardware support
* Very limited software support (playback: [[Winamp]] & [[foobar2000]] plugins, tagging: Mp3Tag)

== Hardware and Software That Support TAK ==
=== Hardware ===
* None

=== Software ===
==== Windows ====
* TAK SDK 1.0.5 – Software Development Kit for TAK [http://www.hydrogenaudio.org/forums/index.php?showtopic=54159 here]
* Winamp Plugin 1.0.7 [http://www.hydrogenaudio.org/forums/index.php?showtopic=54159 here]
* foo_input_tak, TAK decoder for [[foobar2000]] [http://www.hydrogenaudio.org/forums/index.php?showtopic=54087 here] (supports tagging and [[Replay Gain]])
* [[Mp3tag]] – universal tag editor with support for TAK
* shntool (since version 3.0.6)

==== Linux ====
* The TAK reference applications (GUI as well as commandline) are known to run on Linux via Wine.

== Recommended Settings ==
* Default compression: “-p2” (formerly ''Normal'') is the most attractive setting, providing an excellent compromise between compression and encoding speed. (At compression levels close to [[Monkey's Audio]] High (<0.4% difference), it is able to encode more quickly.)
takc -e [input file]
* Highest compression: “-pMax” (same as -p5m) (This will create files which are comparable in size to file created using [[Monkey's Audio]] High. Decompression speed is comparable to [[WavPack]] Normal.)
takc -e -pMax [input file]
* Fastest compression: “-p0” (This will create files which are comparable in size to [[Monkey's Audio]] Fast or [[WavPack]] High. Decompression speed is comparable to [[Free Lossless Audio Codec|FLAC]] 0.)
takc -e -p0 [input file]

=== TAK Performance Graph ===
[[Image:TAK_performance_graph.png|frame|center|Graph showing encoding and decoding rate against compression, using data from Synthetic Soul's test on TAK 1.0.1 (see [[TAK#External Links|External Links]])]]

== Using TAK ==
=== TAK with [[foobar2000]] ===
* Copy the takc.exe to your [[foobar2000]] directory
* Go to File → Preferences → Tools → Converter
* Set it up as shown:
[[Image:Tak_foobar_converter.png|frame|center|Screenshot of foobar 0.9.5 Converter settings for TAK 1.0.3]]
'''Note:''' replace -p2 with the desired compression level.

* TAK introduced encoding from STDIN in version 1.0.3, eliminating the need for a temporary file and greatly improving overall compression time. If you are using an earlier version of TAK use the following command line instead:
-e -p2 %s %d.
* Use [[APEv2 specification|APEv2]] tagging (will be used as internal tagging)

=== TAK with EAC ===
Please read the [[EAC and TAK|wiki guide]], which details how to create TAK files with [[Exact Audio Copy|EAC]].

== Future Features ==
* Unicode support
* MD5 audio checksums for verification and identification
* A German version
* Embedded cue sheets
* Embedded cover art
* Multichannel audio

== Frequently Asked Questions ==
; Is the codec safe for use?
: Yes. To check, convert a WAVE to TAK and back and compare the two (or use foobar's bitcompare tool).
; Why should I use TAK?
: TAK offers high compression ratios with great decoding rates.
; What can I compress with TAK?
: TAK 1.0 can compress any integer-format (up to 24 bits per channel) PCM RIFF WAVE file (.wav). Piping support as of v1.0.3 is implemented, so converting lossless files to WAV first is not necessary.
; What about hardware support?
: None at the moment. Although, ''-p0 (Turbo)'', ''-p1 (Fast)'' and ''-p2 (Normal)'' are the candidates for hardware playback.
; When will the source be opened?
: Yes, TAK will be open-source, as soon as the code is ported to C or C++ and documented. However, Thomas has mentioned that he would like to improve the codec before opening the source.

== External Links ==
* [http://thbeck.de/Tak/Tak.html thbeck.de/Tak/Tak.html] – Official Website ''(german)''
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=54160 TAK Release Announcement / Discussion Thread on HA] ''(english)''
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=54159 TAK Downloads]
* [http://synthetic-soul.co.uk/comparison/lossless/ synthetic-soul.co.uk/comparison/lossless] – Comparison with Other Codecs (by Synthetic Soul)
* [http://flac.sourceforge.net/comparison.html flac.sourceforge.net/comparison.html] – An Updated Comparison (from FLAC Homepage)

[[Category:Lossless]]
[[Category:Encoder/Decoder]]

File:Tak foobar converter.png

2008-01-18T14:18:49Z

Synthetic Soul: Screenshot of foobar 0.9.5 Converter settings for TAK 1.0.3

Screenshot of foobar 0.9.5 Converter settings for TAK 1.0.3

REACT:Amending Cuesheet File References

2008-01-18T11:06:46Z

Synthetic Soul:

When using [[REACT]] to rip to individual tracks you can request all cuesheets to be created, by specifying the following in REACT.ini:

<pre>CreateAllCuesheets=1</pre>

This will create the following files in the working directory:

* '''"@albumfile@.[s].cue"''' (Single WAVE file)
* '''"@albumfile@.[mg].cue"''' (Multiple WAVE files with gaps (non-compliant))
* '''"@albumfile@.[m].cue"''' (Multiple WAVE files with gaps left out)
* '''"@albumfile@.[mc].cue"''' (Multiple WAVE files with corrected gaps)

The multi-file cuesheets will reference the tracks using the filename format set in [[EAC]], which should be "$cdartist$ - $album$ - $track$ - $title$" for standard albums, and specifying a ".wav" extension. However, this is unlikely to be the format that your track files are actually in, which means that the cuesheet will need to be amended in order to be useful.

Below, you will find example code for two solutions, using two different tools. '''You are recommended to use [http://gnuwin32.sourceforge.net/packages/gsar.htm GSAR] for this purpose''', as certain special characters, e.g.: the ampersand, if used in your filenames, may cause problems when using [http://gnuwin32.sourceforge.net/packages/sed.htm SED].

==Using GSAR==

The additional config code below uses the GNU tool [http://gnuwin32.sourceforge.net/packages/gsar.htm GSAR] to parse the cuesheet created by [[EAC]], and create a new cuesheet referencing the correctly-named files. This is achieved in the following way:

# When the first track is processed the cuesheet will be copied to a new cuesheet file named "$cdartist$ - $album$.cue". A batch command, settting the correct codepage, is written to a temporary batch file called "update-cuesheet.bat".
# Every time a track is processed, a GSAR command, to replace that track's filename, is written to the temporary batch file.
# When the last track is processed, a GSAR command is executed to escape percent signs (%) in the temporary batch file.
# The temporary batch file is executed, executing a GSAR command for each track.
# The file "update-cuesheet.bat" is deleted.

'''Creating the GSAR commands for each track'''

The following lines need to be added to the code which is run for the format you are using for each track:

<pre>
SET trackCueFile="$cdartist$ - $album$.cue"
IF NOT EXIST %trackCueFile% (
COPY "@albumfile@.[mg].cue" %trackCueFile%
ECHO CHCP 1252 ^| PROMPT>>update-cuesheet.bat
)
ECHO @tools@\GSAR.EXE "-s@basename@.wav" "-r%TrackName%.wv" -o %trackCueFile%>>update-cuesheet.bat</pre>

Here it is in the WavPack section:

<pre>
IF NOT @Wavpack@==1 GOTO end_wavpack_tracks
IF NOT EXIST %TrackDir_Wavpack% MKDIR %TrackDir_Wavpack%
PUSHD %TrackDir_Wavpack%
IF @various@==1 SET VA_tag=-w "album artist=@VA@"
ECHO ON
@tools@\wavpack.exe @Opt_Wavpack@ %VA_tag% -w artist="@artist@" -w album="@album@" -w track="@track@/@numtracks@" -w title="@title@" -w year="@year@" -w genre="@genre@" -w comment="@comment@" -w encodedby="%USERNAME%" -w encodersettings="Wavpack @Ver_Wavpack@ @Opt_Wavpack@" "@source@" "%TrackName%.wv"
@ECHO OFF
SET trackCueFile="$cdartist$ - $album$.cue"
IF NOT EXIST %trackCueFile% (
COPY "@albumfile@.[mg].cue" %trackCueFile%
ECHO CHCP 1252 ^| PROMPT>>update-cuesheet.bat
)
ECHO @tools@\GSAR.EXE "-s@basename@.wav" "-r%TrackName%.wv" -o %trackCueFile%>>update-cuesheet.bat
IF %have_cover%==1 IF NOT EXIST folder.jpg COPY "@cover@" folder.jpg
TITLE @track@/@numtracks@ - "@album@"
POPD
:end_wavpack_tracks
</pre>

Note that the extension ("wv") will need to be changed depending on the format that you are using. Additionally, if you are using MP3, you will need to use the following line instead, which correctly changes the file type to MP3 from WAVE:

<pre>ECHO @tools@\GSAR.EXE "-s@basename@.wav""" WAVE" "-r%TrackName%.mp3""" MP3" -o %trackCueFile%>>update-cuesheet.bat</pre>

Also, note that the example uses the "multiple WAVE files with gaps (non-compliant)" cuesheet as its source. This is the cuesheet that most users would require; however you can replace "@albumfile@.[mg].cue" with "@albumfile@.[m].cue" or "@albumfile@.[mc].cue" if you wish.

'''Executing the batch file'''

The following lines need to be added to the code which is run for the format you are using at the end of the config:

<pre>
@tools@\GSAR.EXE -s%% -r%%%% -o update-cuesheet.bat
CALL update-cuesheet.bat
DEL update-cuesheet.bat
</pre>

Here they are in the WavPack section:

<pre>
IF @Wavpack@==1 (
PUSHD %TrackDir_Wavpack%
IF %add_rg%==1 @tools@\wvgain.exe -a *.wv
REM COPY /Y "@eaclog@" "EAClog.txt"
@tools@\GSAR.EXE -s%% -r%%%% -o update-cuesheet.bat
CALL update-cuesheet.bat
DEL update-cuesheet.bat
POPD
)
</pre>

These three lines are universal, and can be added to any format's section with no need for change.

'''Requirements'''

You will need to download the Windows version of [http://gnuwin32.sourceforge.net/packages/gsar.htm GSAR], and put the executable in your [[REACT]] tools directory.

===Using GSAR For Other Requirements===

If you will be using GSAR for other string replacement in your config, you may need to ensure that two characters are escaped before creating your GSAR command line.

If you are dealing solely with filenames, as in the section above, you do not need to worry: these are both illegal filename characters and therefore cannot possibly raise an issue.

'''If you are not dealing solely in filenames''', you will need to ensure that any double quotes (") and colons (:) are escaped. Double quotes may be escaped by replacing one instance with three (" -> """) or by replacing it with the correct character code (" -> :034 (decimal) or " -> :x22 (hex)). Colons should be escaped by prefixing with another colon. (: -> ::)

E.g.: If your string is as follows:

A Test: using "both" characters

... any of the lines below may be used in its place:

A Test:: using """both"""" characters
A Test:: using :034both:034 characters
A Test:: using :x22both:x22 characters

Below is some example code to escape an existing batch file variable, "myVar", before passing it to GSAR:

<pre>
SET myVar=%myVar::=::%
SET myVar=%myVar:"=:x22%

@tools@\GSAR.EXE "-sSome Existing Text" "-r%myVar%" -o myfile.txt
</pre>

====Using GSAR to Escape Percent Signs Written to Batch Files====

When using a percent sign in your config it must be escaped like so: %%. This ensures that it is not mistaken for the beginning of a batch file variable (e.g.: %myVar%).

If your config needs to create and execute a batch file on the fly, as the example in [[REACT:Amending_Cuesheet_File_References#Using_GSAR|Using GSAR]] does, you will need to re-escape any percent signs, as the act of writing the batch file will unescape any written.

You can use [http://gnuwin32.sourceforge.net/packages/gsar.htm GSAR], before executing your batch file, to ensure that all percent signs written to the file are properly escaped.

GSAR.EXE -s%% -r%%%% -o update-cuesheet.bat

This command will escape all percent signs (% -> %%) in the file "update-cuesheet.bat". The -o switch tells GSAR to overwrite the file, rather than write the amended text to a new file.

==Using SED==

The additional config code below uses the GNU tool [http://gnuwin32.sourceforge.net/packages/sed.htm SED] to parse the cuesheet created by [[EAC]], and create a new cuesheet referencing the correctly-named files. This is achieved in the following way:

# Every time a track is processed a SED command, to replace that track's filename, is written to a temporary text file called "sedlist.txt".
# When the last track is processed this file is passed to SED which executes each command on the cuesheet text, and writes the new text to a new cuesheet file named "$cdartist$ - $album$.cue".
# The file "sedlist.txt" is deleted.

'''Writing the SED commands for each track'''

The following line needs to be added to the code which is run for the format you are using for each track:

<pre>ECHO s/FILE "@basename@\.wav"/FILE "%TrackName%\.wv"/>>sedlist.txt</pre>

Here it is in the WavPack section:

<pre>
IF NOT @Wavpack@==1 GOTO end_wavpack_tracks
IF NOT EXIST %TrackDir_Wavpack% MKDIR %TrackDir_Wavpack%
PUSHD %TrackDir_Wavpack%
IF @various@==1 SET VA_tag=-w "album artist=@VA@"
ECHO ON
@tools@\wavpack.exe @Opt_Wavpack@ %VA_tag% -w artist="@artist@" -w album="@album@" -w track="@track@/@numtracks@" -w title="@title@" -w year="@year@" -w genre="@genre@" -w comment="@comment@" -w encodedby="%USERNAME%" -w encodersettings="Wavpack @Ver_Wavpack@ @Opt_Wavpack@" "@source@" "%TrackName%.wv"
ECHO s/FILE "@basename@\.wav"/FILE "%TrackName%\.wv"/>>sedlist.txt
@ECHO OFF
IF %have_cover%==1 IF NOT EXIST folder.jpg COPY "@cover@" folder.jpg
TITLE @track@/@numtracks@ - "@album@"
POPD
:end_wavpack_tracks
</pre>

Note that the extension ("wv") will need to be changed depending on the format that you are using. Additionally, if you are using MP3, you will need to use the following line instead, which correctly changes the file type to MP3 from WAVE:

<pre>ECHO s/FILE "@basename@\.wav" WAVE/FILE "%TrackName%\.mp3" MP3/>>sedlist.txt</pre>

'''Executing SED'''

The following lines need to be added to the code which is run for the format you are using at the end of the config:

<pre>
@tools@\SED -f sedlist.txt <"@albumfile@.[mg].cue" >"$cdartist$ - $album$.cue"
DEL sedlist.txt
</pre>

Here they are in the WavPack section:

<pre>
IF @Wavpack@==1 (
PUSHD %TrackDir_Wavpack%
IF %add_rg%==1 @tools@\wvgain.exe -a *.wv
REM COPY /Y "@eaclog@" "EAClog.txt"
@tools@\SED -f sedlist.txt <"@albumfile@.[mg].cue" >"$cdartist$ - $album$.cue"
DEL sedlist.txt
POPD
)
</pre>

These two lines are universal, and can be added to any format's section with no need for change. Note though, that the example uses the "multiple WAVE files with gaps (non-compliant)" cuesheet as its source. This is the cuesheet that most users would require; however you can replace "@albumfile@.[mg].cue" with "@albumfile@.[m].cue" or "@albumfile@.[mc].cue" if you wish.

'''Requirements'''

You will need to download the Windows version of [http://gnuwin32.sourceforge.net/packages/sed.htm SED], including its dependencies ("libintl3.dll" and "libiconv2.dll"), and put all three files in your [[REACT]] tools directory.

==Related Thread==
This tip is a result of a string of posts between lipidicman and [[User:Synthetic Soul|Synthetic Soul]] in the [http://www.hydrogenaudio.org/forums/index.php?showtopic=50273 REACT 2 thread] beginning with [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=483839 this post].

[[Category:REACT|Amending Cuesheet File References]]

REACT:Amending Cuesheet File References

2008-01-18T10:03:52Z

Synthetic Soul: Grammar, missing text

When using [[REACT]] to rip to individual tracks you can request all cuesheets to be created, by specifying the following in REACT.ini:

<pre>CreateAllCuesheets=1</pre>

This will create the following files in the working directory:

* '''"@albumfile@.[s].cue"''' (Single WAVE file)
* '''"@albumfile@.[mg].cue"''' (Multiple WAVE files with gaps (non-compliant))
* '''"@albumfile@.[m].cue"''' (Multiple WAVE files with gaps left out)
* '''"@albumfile@.[mc].cue"''' (Multiple WAVE files with corrected gaps)

The multi-file cuesheets will reference the tracks using the filename format set in [[EAC]], which should be "$cdartist$ - $album$ - $track$ - $title$" for standard albums, and specifying a ".wav" extension. However, this is unlikely to be the format that your track files are actually in, which means that the cuesheet will need to be amended in order to be useful.

Below, you will find example code for two solutions, using two different tools. '''You are recommended to use [http://gnuwin32.sourceforge.net/packages/gsar.htm GSAR] for this purpose''', as certain special characters, e.g.: the ampersand, if used in your filenames, may cause problems when using [http://gnuwin32.sourceforge.net/packages/sed.htm SED].

==Using GSAR==

The additional config code below uses the GNU tool [http://gnuwin32.sourceforge.net/packages/gsar.htm GSAR] to parse the cuesheet created by [[EAC]], and create a new cuesheet referencing the correctly-named files. This is achieved in the following way:

# When the first track is processed the cuesheet will be copied to a new cuesheet file named "$cdartist$ - $album$.cue". A batch command, settting the correct codepage, is written to a temporary batch file called "update-cuesheet.bat".
# Every time a track is processed, a GSAR command, to replace that track's filename, is written to the temporary batch file.
# When the last track is processed, a GSAR command is executed to escape percent signs (%) in the temporary batch file.
# The temporary batch file is executed, executing a GSAR command for each track.
# The file "update-cuesheet.bat" is deleted.

'''Creating the GSAR commands for each track'''

The following lines need to be added to the code which is run for the format you are using for each track:

<pre>
SET trackCueFile="$cdartist$ - $album$.cue"
IF NOT EXIST %trackCueFile% (
COPY "@albumfile@.[mg].cue" %trackCueFile%
ECHO CHCP 1252 ^| PROMPT>>update-cuesheet.bat
)
ECHO @tools@\GSAR.EXE "-s@basename@.wav" "-r%TrackName%.wv" -o %trackCueFile%>>update-cuesheet.bat</pre>

Here it is in the WavPack section:

<pre>
IF NOT @Wavpack@==1 GOTO end_wavpack_tracks
IF NOT EXIST %TrackDir_Wavpack% MKDIR %TrackDir_Wavpack%
PUSHD %TrackDir_Wavpack%
IF @various@==1 SET VA_tag=-w "album artist=@VA@"
ECHO ON
@tools@\wavpack.exe @Opt_Wavpack@ %VA_tag% -w artist="@artist@" -w album="@album@" -w track="@track@/@numtracks@" -w title="@title@" -w year="@year@" -w genre="@genre@" -w comment="@comment@" -w encodedby="%USERNAME%" -w encodersettings="Wavpack @Ver_Wavpack@ @Opt_Wavpack@" "@source@" "%TrackName%.wv"
@ECHO OFF
SET trackCueFile="$cdartist$ - $album$.cue"
IF NOT EXIST %trackCueFile% (
COPY "@albumfile@.[mg].cue" %trackCueFile%
ECHO CHCP 1252 ^| PROMPT>>update-cuesheet.bat
)
ECHO @tools@\GSAR.EXE "-s@basename@.wav" "-r%TrackName%.wv" -o %trackCueFile%>>update-cuesheet.bat
IF %have_cover%==1 IF NOT EXIST folder.jpg COPY "@cover@" folder.jpg
TITLE @track@/@numtracks@ - "@album@"
POPD
:end_wavpack_tracks
</pre>

Note that the extension ("wv") will need to be changed depending on the format that you are using. Additionally, if you are using MP3, you will need to use the following line instead, which correctly changes the file type to MP3 from WAVE:

<pre>ECHO @tools@\GSAR.EXE "-s@basename@.wav""" WAVE" "-r%TrackName%.mp3""" MP3" -o %trackCueFile%>>update-cuesheet.bat</pre>

Also, note that the example uses the "multiple WAVE files with gaps (non-compliant)" cuesheet as its source. This is the cuesheet that most users would require; however you can replace "@albumfile@.[mg].cue" with "@albumfile@.[m].cue" or "@albumfile@.[mc].cue" if you wish.

'''Executing the batch file'''

The following lines need to be added to the code which is run for the format you are using at the end of the config:

<pre>
@tools@\GSAR.EXE -s%% -r%%%% -o update-cuesheet.bat
CALL update-cuesheet.bat
DEL update-cuesheet.bat
</pre>

Here they are in the WavPack section:

<pre>
IF @Wavpack@==1 (
PUSHD %TrackDir_Wavpack%
IF %add_rg%==1 @tools@\wvgain.exe -a *.wv
REM COPY /Y "@eaclog@" "EAClog.txt"
@tools@\GSAR.EXE -s%% -r%%%% -o update-cuesheet.bat
CALL update-cuesheet.bat
DEL update-cuesheet.bat
POPD
)
</pre>

These two lines are universal, and can be added to any format's section with no need for change.

'''Requirements'''

You will need to download the Windows version of [http://gnuwin32.sourceforge.net/packages/gsar.htm GSAR], and put the executable in your [[REACT]] tools directory.

===Using GSAR For Other Requirements===

If you will be using GSAR for other string replacement in your config, you may need to ensure that two characters are escaped before creating your GSAR command line.

If you are dealing solely with filenames, as in the section above, you do not need to worry: these are both illegal filename characters and therefore cannot possibly raise an issue.

'''If you are not dealing solely in filenames''', you will need to ensure that any double quotes (") and colons (:) are escaped. Double quotes may be escaped by replacing one instance with three (" -> """) or by replacing it with the correct character code (" -> :034 (decimal) or " -> :x22 (hex)). Colons should be escaped by prefixing with another colon. (: -> ::)

E.g.: If your string is as follows:

A Test: using "both" characters

... any of the lines below may be used in its place:

A Test:: using """both"""" characters
A Test:: using :034both:034 characters
A Test:: using :x22both:x22 characters

Below is some example code to escape an existing batch file variable, "myVar", before passing it to GSAR:

<pre>
SET myVar=%myVar::=::%
SET myVar=%myVar:"=:x22%

@tools@\GSAR.EXE "-sSome Existing Text" "-r%myVar%" -o myfile.txt
</pre>

====Using GSAR to Escape Percent Signs Written to Batch Files====

When using a percent sign in your config it must be escaped like so: %%. This ensures that it is not mistaken for the beginning of a batch file variable (e.g.: %myVar%).

If your config needs to create and execute a batch file on the fly, as the example in [[REACT:Amending_Cuesheet_File_References#Using_GSAR|Using GSAR]] does, you will need to re-escape any percent signs, as the act of writing the batch file will unescape any written.

You can use [http://gnuwin32.sourceforge.net/packages/gsar.htm GSAR], before executing your batch file, to ensure that all percent signs written to the file are properly escaped.

GSAR.EXE -s%% -r%%%% -o update-cuesheet.bat

This command will escape all percent signs (% -> %%) in the update-cuesheet.bat file. The -o switch tells GSAR to overwrite the update-cuesheet.bat file.

==Using SED==

The additional config code below uses the GNU tool [http://gnuwin32.sourceforge.net/packages/sed.htm SED] to parse the cuesheet created by [[EAC]], and create a new cuesheet referencing the correctly-named files. This is achieved in the following way:

# Every time a track is processed a SED command, to replace that track's filename, is written to a temporary text file called "sedlist.txt".
# When the last track is processed this file is passed to SED which executes each command on the cuesheet text, and writes the new text to a new cuesheet file named "$cdartist$ - $album$.cue".
# The file "sedlist.txt" is deleted.

'''Writing the SED commands for each track'''

The following line needs to be added to the code which is run for the format you are using for each track:

<pre>ECHO s/FILE "@basename@\.wav"/FILE "%TrackName%\.wv"/>>sedlist.txt</pre>

Here it is in the WavPack section:

<pre>
IF NOT @Wavpack@==1 GOTO end_wavpack_tracks
IF NOT EXIST %TrackDir_Wavpack% MKDIR %TrackDir_Wavpack%
PUSHD %TrackDir_Wavpack%
IF @various@==1 SET VA_tag=-w "album artist=@VA@"
ECHO ON
@tools@\wavpack.exe @Opt_Wavpack@ %VA_tag% -w artist="@artist@" -w album="@album@" -w track="@track@/@numtracks@" -w title="@title@" -w year="@year@" -w genre="@genre@" -w comment="@comment@" -w encodedby="%USERNAME%" -w encodersettings="Wavpack @Ver_Wavpack@ @Opt_Wavpack@" "@source@" "%TrackName%.wv"
ECHO s/FILE "@basename@\.wav"/FILE "%TrackName%\.wv"/>>sedlist.txt
@ECHO OFF
IF %have_cover%==1 IF NOT EXIST folder.jpg COPY "@cover@" folder.jpg
TITLE @track@/@numtracks@ - "@album@"
POPD
:end_wavpack_tracks
</pre>

Note that the extension ("wv") will need to be changed depending on the format that you are using. Additionally, if you are using MP3, you will need to use the following line instead, which correctly changes the file type to MP3 from WAVE:

<pre>ECHO s/FILE "@basename@\.wav" WAVE/FILE "%TrackName%\.mp3" MP3/>>sedlist.txt</pre>

'''Executing SED'''

The following lines need to be added to the code which is run for the format you are using at the end of the config:

<pre>
@tools@\SED -f sedlist.txt <"@albumfile@.[mg].cue" >"$cdartist$ - $album$.cue"
DEL sedlist.txt
</pre>

Here they are in the WavPack section:

<pre>
IF @Wavpack@==1 (
PUSHD %TrackDir_Wavpack%
IF %add_rg%==1 @tools@\wvgain.exe -a *.wv
REM COPY /Y "@eaclog@" "EAClog.txt"
@tools@\SED -f sedlist.txt <"@albumfile@.[mg].cue" >"$cdartist$ - $album$.cue"
DEL sedlist.txt
POPD
)
</pre>

These two lines are universal, and can be added to any format's section with no need for change. Note though, that the example uses the "multiple WAVE files with gaps (non-compliant)" cuesheet as its source. This is the cuesheet that most users would require; however you can replace "@albumfile@.[mg].cue" with "@albumfile@.[m].cue" or "@albumfile@.[mc].cue" if you wish.

'''Requirements'''

You will need to download the Windows version of [http://gnuwin32.sourceforge.net/packages/sed.htm SED], including its dependencies ("libintl3.dll" and "libiconv2.dll"), and put all three files in your [[REACT]] tools directory.

==Related Thread==
This tip is a result of a string of posts between lipidicman and [[User:Synthetic Soul|Synthetic Soul]] in the [http://www.hydrogenaudio.org/forums/index.php?showtopic=50273 REACT 2 thread] beginning with [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=483839 this post].

[[Category:REACT|Amending Cuesheet File References]]

REACT:Amending Cuesheet File References

2008-01-18T09:53:43Z

Synthetic Soul: Clarified filenames and GSAR

When using [[REACT]] to rip to individual tracks you can request all cuesheets to be created, by specifying the following in REACT.ini:

<pre>CreateAllCuesheets=1</pre>

This will create the following files in the working directory:

* '''"@albumfile@.[s].cue"''' (Single WAVE file)
* '''"@albumfile@.[mg].cue"''' (Multiple WAVE files with gaps (non-compliant))
* '''"@albumfile@.[m].cue"''' (Multiple WAVE files with gaps left out)
* '''"@albumfile@.[mc].cue"''' (Multiple WAVE files with corrected gaps)

The multi-file cuesheets will reference the tracks using the filename format set in [[EAC]], which should be "$cdartist$ - $album$ - $track$ - $title$" for standard albums, and specifying a ".wav" extension. However, this is unlikely to be the format that your track files are actually in, which means that the cuesheet will need to be amended in order to be useful.

Below, you will find example code for two solutions, using two different tools. '''You are recommended to use [http://gnuwin32.sourceforge.net/packages/gsar.htm GSAR] for this purpose''', as certain special characters, e.g.: the ampersand, if used in your filenames, may cause problems when using [http://gnuwin32.sourceforge.net/packages/sed.htm SED].

==Using GSAR==

The additional config code below uses the GNU tool [http://gnuwin32.sourceforge.net/packages/gsar.htm GSAR] to parse the cuesheet created by [[EAC]], and create a new cuesheet referencing the correctly-named files. This is achieved in the following way:

# When the first track is processed the cuesheet will be copied to a new cuesheet file named "$cdartist$ - $album$.cue". A batch command, settting the correct codepage, is written to a temporary batch file called "update-cuesheet.bat".
# Every time a track is processed, a GSAR command, to replace that track's filename, is written to the temporary batch file.
# When the last track is processed, a GSAR command is executed to escape percent signs (%) in the temporary batch file.
# The temporary batch file is executed, executing a GSAR command for each track.
# The file "update-cuesheet.bat" is deleted.

'''Creating the GSAR commands for each track'''

The following lines need to be added to the code which is run for the format you are using for each track:

<pre>
SET trackCueFile="$cdartist$ - $album$.cue"
IF NOT EXIST %trackCueFile% (
COPY "@albumfile@.[mg].cue" %trackCueFile%
ECHO CHCP 1252 ^| PROMPT>>update-cuesheet.bat
)
ECHO @tools@\GSAR.EXE "-s@basename@.wav" "-r%TrackName%.wv" -o %trackCueFile%>>update-cuesheet.bat</pre>

Here it is in the WavPack section:

<pre>
IF NOT @Wavpack@==1 GOTO end_wavpack_tracks
IF NOT EXIST %TrackDir_Wavpack% MKDIR %TrackDir_Wavpack%
PUSHD %TrackDir_Wavpack%
IF @various@==1 SET VA_tag=-w "album artist=@VA@"
ECHO ON
@tools@\wavpack.exe @Opt_Wavpack@ %VA_tag% -w artist="@artist@" -w album="@album@" -w track="@track@/@numtracks@" -w title="@title@" -w year="@year@" -w genre="@genre@" -w comment="@comment@" -w encodedby="%USERNAME%" -w encodersettings="Wavpack @Ver_Wavpack@ @Opt_Wavpack@" "@source@" "%TrackName%.wv"
@ECHO OFF
SET trackCueFile="$cdartist$ - $album$.cue"
IF NOT EXIST %trackCueFile% (
COPY "@albumfile@.[mg].cue" %trackCueFile%
ECHO CHCP 1252 ^| PROMPT>>update-cuesheet.bat
)
ECHO @tools@\GSAR.EXE "-s@basename@.wav" "-r%TrackName%.wv" -o %trackCueFile%>>update-cuesheet.bat
IF %have_cover%==1 IF NOT EXIST folder.jpg COPY "@cover@" folder.jpg
TITLE @track@/@numtracks@ - "@album@"
POPD
:end_wavpack_tracks
</pre>

Note that the extension ("wv") will need to be changed depending on the format that you are using. Additionally, if you are using MP3, you will need to use the following line instead, which correctly changes the file type to MP3 from WAVE:

<pre>ECHO @tools@\GSAR.EXE "-s@basename@.wav""" WAVE" "-r%TrackName%.mp3""" MP3" -o %trackCueFile%>>update-cuesheet.bat</pre>

Also, note that the example uses the "multiple WAVE files with gaps (non-compliant)" cuesheet as its source. This is the cuesheet that most users would require; however you can replace "@albumfile@.[mg].cue" with "@albumfile@.[m].cue" or "@albumfile@.[mc].cue" if you wish.

'''Executing the batch file'''

The following lines need to be added to the code which is run for the format you are using at the end of the config:

<pre>
@tools@\GSAR.EXE -s%% -r%%%% -o update-cuesheet.bat
CALL update-cuesheet.bat
DEL update-cuesheet.bat
</pre>

Here they are in the WavPack section:

<pre>
IF @Wavpack@==1 (
PUSHD %TrackDir_Wavpack%
IF %add_rg%==1 @tools@\wvgain.exe -a *.wv
REM COPY /Y "@eaclog@" "EAClog.txt"
@tools@\GSAR.EXE -s%% -r%%%% -o update-cuesheet.bat
CALL update-cuesheet.bat
DEL update-cuesheet.bat
POPD
)
</pre>

These two lines are universal, and can be added to any format's section with no need for change.

'''Requirements'''

You will need to download the Windows version of [http://gnuwin32.sourceforge.net/packages/gsar.htm GSAR], and put the executable in your [[REACT]] tools directory.

===Using GSAR For Other Requirements===

If you will be using GSAR for other string replacement in your config, you may need to ensure that two characters are escaped before creating your GSAR command line.

If you are dealing solely with filenames, as in the section above, you do not need to worry, as these are both illegal filename characters, and therefore cannot possibly raise an issue.

'''If you are not dealing solely in filenames''', you will need to ensure that any double quotes (") and colons (:) are escaped. Double quotes may be escaped by replacing one one instance with three (" -> """) or by replacing it with the correct character code (" -> :034 (decimal) or " -> :x22 (hex)).

E.g.: If your string is as follows:

A Test: using "both" characters

... any of the lines below may be used in its place:

A Test:: using """both"""" characters
A Test:: using :034both:034 characters
A Test:: using :x22both:x22 characters

Below is some example code to escape an existing batch file variable, "myVar", before passing it to GSAR:

<pre>
SET myVar=%myVar::=::%
SET myVar=%myVar:"=:x22%

@tools@\GSAR.EXE "-sSome Existing Text" "-r%myVar%" -o myfile.txt
</pre>

====Using GSAR to Escape Percent Signs Written to Batch Files====

When using a percent sign in your config it must be escaped like so: %%. This ensures that it is not mistaken for the beginning of a batch file variable (e.g.: %myVar%).

If your config needs to create and execute a batch file on the fly, as the example in [[REACT:Amending_Cuesheet_File_References#Using_GSAR|Using GSAR]] does, you will need to re-escape any percent signs, as the act of writing the batch file will unescape any written.

You can use [http://gnuwin32.sourceforge.net/packages/gsar.htm GSAR], before executing your batch file, to ensure that all percent signs written to the file are properly escaped.

GSAR.EXE -s%% -r%%%% -o update-cuesheet.bat

This command will escape all percent signs (% -> %%) in the update-cuesheet.bat file. The -o switch tells GSAR to overwrite the update-cuesheet.bat file.

==Using SED==

The additional config code below uses the GNU tool [http://gnuwin32.sourceforge.net/packages/sed.htm SED] to parse the cuesheet created by [[EAC]], and create a new cuesheet referencing the correctly-named files. This is achieved in the following way:

# Every time a track is processed a SED command, to replace that track's filename, is written to a temporary text file called "sedlist.txt".
# When the last track is processed this file is passed to SED which executes each command on the cuesheet text, and writes the new text to a new cuesheet file named "$cdartist$ - $album$.cue".
# The file "sedlist.txt" is deleted.

'''Writing the SED commands for each track'''

The following line needs to be added to the code which is run for the format you are using for each track:

<pre>ECHO s/FILE "@basename@\.wav"/FILE "%TrackName%\.wv"/>>sedlist.txt</pre>

Here it is in the WavPack section:

<pre>
IF NOT @Wavpack@==1 GOTO end_wavpack_tracks
IF NOT EXIST %TrackDir_Wavpack% MKDIR %TrackDir_Wavpack%
PUSHD %TrackDir_Wavpack%
IF @various@==1 SET VA_tag=-w "album artist=@VA@"
ECHO ON
@tools@\wavpack.exe @Opt_Wavpack@ %VA_tag% -w artist="@artist@" -w album="@album@" -w track="@track@/@numtracks@" -w title="@title@" -w year="@year@" -w genre="@genre@" -w comment="@comment@" -w encodedby="%USERNAME%" -w encodersettings="Wavpack @Ver_Wavpack@ @Opt_Wavpack@" "@source@" "%TrackName%.wv"
ECHO s/FILE "@basename@\.wav"/FILE "%TrackName%\.wv"/>>sedlist.txt
@ECHO OFF
IF %have_cover%==1 IF NOT EXIST folder.jpg COPY "@cover@" folder.jpg
TITLE @track@/@numtracks@ - "@album@"
POPD
:end_wavpack_tracks
</pre>

Note that the extension ("wv") will need to be changed depending on the format that you are using. Additionally, if you are using MP3, you will need to use the following line instead, which correctly changes the file type to MP3 from WAVE:

<pre>ECHO s/FILE "@basename@\.wav" WAVE/FILE "%TrackName%\.mp3" MP3/>>sedlist.txt</pre>

'''Executing SED'''

The following lines need to be added to the code which is run for the format you are using at the end of the config:

<pre>
@tools@\SED -f sedlist.txt <"@albumfile@.[mg].cue" >"$cdartist$ - $album$.cue"
DEL sedlist.txt
</pre>

Here they are in the WavPack section:

<pre>
IF @Wavpack@==1 (
PUSHD %TrackDir_Wavpack%
IF %add_rg%==1 @tools@\wvgain.exe -a *.wv
REM COPY /Y "@eaclog@" "EAClog.txt"
@tools@\SED -f sedlist.txt <"@albumfile@.[mg].cue" >"$cdartist$ - $album$.cue"
DEL sedlist.txt
POPD
)
</pre>

These two lines are universal, and can be added to any format's section with no need for change. Note though, that the example uses the "multiple WAVE files with gaps (non-compliant)" cuesheet as its source. This is the cuesheet that most users would require; however you can replace "@albumfile@.[mg].cue" with "@albumfile@.[m].cue" or "@albumfile@.[mc].cue" if you wish.

'''Requirements'''

You will need to download the Windows version of [http://gnuwin32.sourceforge.net/packages/sed.htm SED], including its dependencies ("libintl3.dll" and "libiconv2.dll"), and put all three files in your [[REACT]] tools directory.

==Related Thread==
This tip is a result of a string of posts between lipidicman and [[User:Synthetic Soul|Synthetic Soul]] in the [http://www.hydrogenaudio.org/forums/index.php?showtopic=50273 REACT 2 thread] beginning with [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=483839 this post].

[[Category:REACT|Amending Cuesheet File References]]

REACT:Amending Cuesheet File References

2008-01-18T09:42:04Z

Synthetic Soul: Updated text in Using GSAR For Other Requirements

When using [[REACT]] to rip to individual tracks you can request all cuesheets to be created, by specifying the following in REACT.ini:

<pre>CreateAllCuesheets=1</pre>

This will create the following files in the working directory:

* '''"@albumfile@.[s].cue"''' (Single WAVE file)
* '''"@albumfile@.[mg].cue"''' (Multiple WAVE files with gaps (non-compliant))
* '''"@albumfile@.[m].cue"''' (Multiple WAVE files with gaps left out)
* '''"@albumfile@.[mc].cue"''' (Multiple WAVE files with corrected gaps)

The multi-file cuesheets will reference the tracks using the filename format set in [[EAC]], which should be "$cdartist$ - $album$ - $track$ - $title$" for standard albums, and specifying a ".wav" extension. However, this is unlikely to be the format that your track files are actually in, which means that the cuesheet will need to be amended in order to be useful.

Below, you will find example code for two solutions, using two different tools. '''You are recommended to use [http://gnuwin32.sourceforge.net/packages/gsar.htm GSAR] for this purpose''', as certain special characters, e.g.: the ampersand, if used in your filenames, may cause problems when using [http://gnuwin32.sourceforge.net/packages/sed.htm SED].

==Using GSAR==

The additional config code below uses the GNU tool [http://gnuwin32.sourceforge.net/packages/gsar.htm GSAR] to parse the cuesheet created by [[EAC]], and create a new cuesheet referencing the correctly-named files. This is achieved in the following way:

# When the first track is processed the cuesheet will be copied to a new cuesheet file named "$cdartist$ - $album$.cue". A batch command, settting the correct codepage, is written to a temporary batch file called "update-cuesheet.bat".
# Every time a track is processed, a GSAR command, to replace that track's filename, is written to the temporary batch file.
# When the last track is processed, a GSAR command is executed to escape percent signs (%) in the temporary batch file.
# The temporary batch file is executed, executing a GSAR command for each track.
# The file "update-cuesheet.bat" is deleted.

'''Creating the GSAR commands for each track'''

The following lines need to be added to the code which is run for the format you are using for each track:

<pre>
SET trackCueFile="$cdartist$ - $album$.cue"
IF NOT EXIST %trackCueFile% (
COPY "@albumfile@.[mg].cue" %trackCueFile%
ECHO CHCP 1252 ^| PROMPT>>update-cuesheet.bat
)
ECHO @tools@\GSAR.EXE "-s@basename@.wav" "-r%TrackName%.wv" -o %trackCueFile%>>update-cuesheet.bat</pre>

Here it is in the WavPack section:

<pre>
IF NOT @Wavpack@==1 GOTO end_wavpack_tracks
IF NOT EXIST %TrackDir_Wavpack% MKDIR %TrackDir_Wavpack%
PUSHD %TrackDir_Wavpack%
IF @various@==1 SET VA_tag=-w "album artist=@VA@"
ECHO ON
@tools@\wavpack.exe @Opt_Wavpack@ %VA_tag% -w artist="@artist@" -w album="@album@" -w track="@track@/@numtracks@" -w title="@title@" -w year="@year@" -w genre="@genre@" -w comment="@comment@" -w encodedby="%USERNAME%" -w encodersettings="Wavpack @Ver_Wavpack@ @Opt_Wavpack@" "@source@" "%TrackName%.wv"
@ECHO OFF
SET trackCueFile="$cdartist$ - $album$.cue"
IF NOT EXIST %trackCueFile% (
COPY "@albumfile@.[mg].cue" %trackCueFile%
ECHO CHCP 1252 ^| PROMPT>>update-cuesheet.bat
)
ECHO @tools@\GSAR.EXE "-s@basename@.wav" "-r%TrackName%.wv" -o %trackCueFile%>>update-cuesheet.bat
IF %have_cover%==1 IF NOT EXIST folder.jpg COPY "@cover@" folder.jpg
TITLE @track@/@numtracks@ - "@album@"
POPD
:end_wavpack_tracks
</pre>

Note that the extension ("wv") will need to be changed depending on the format that you are using. Additionally, if you are using MP3, you will need to use the following line instead, which correctly changes the file type to MP3 from WAVE:

<pre>ECHO @tools@\GSAR.EXE "-s@basename@.wav""" WAVE" "-r%TrackName%.mp3""" MP3" -o %trackCueFile%>>update-cuesheet.bat</pre>

Also, note that the example uses the "multiple WAVE files with gaps (non-compliant)" cuesheet as its source. This is the cuesheet that most users would require; however you can replace "@albumfile@.[mg].cue" with "@albumfile@.[m].cue" or "@albumfile@.[mc].cue" if you wish.

'''Executing the batch file'''

The following lines need to be added to the code which is run for the format you are using at the end of the config:

<pre>
@tools@\GSAR.EXE -s%% -r%%%% -o update-cuesheet.bat
CALL update-cuesheet.bat
DEL update-cuesheet.bat
</pre>

Here they are in the WavPack section:

<pre>
IF @Wavpack@==1 (
PUSHD %TrackDir_Wavpack%
IF %add_rg%==1 @tools@\wvgain.exe -a *.wv
REM COPY /Y "@eaclog@" "EAClog.txt"
@tools@\GSAR.EXE -s%% -r%%%% -o update-cuesheet.bat
CALL update-cuesheet.bat
DEL update-cuesheet.bat
POPD
)
</pre>

These two lines are universal, and can be added to any format's section with no need for change.

'''Requirements'''

You will need to download the Windows version of [http://gnuwin32.sourceforge.net/packages/gsar.htm GSAR], and put the executable in your [[REACT]] tools directory.

===Using GSAR For Other Requirements===

If you will be using GSAR for other string replacement in your config, you will need to ensure that certain characters are escaped before creating your GSAR command line.

'''For all uses''', you will need to ensure that any double quotes (") and colons (:) are escaped. Double quotes may be escaped by replacing one one instance with three (" -> """) or by replacing it with the correct character code (" -> :034 (decimal) or " -> :x22 (hex)).

E.g.: If your string is as follows:

A Test: using "both" characters

... any of the lines below may be used in its place:

A Test:: using """both"""" characters
A Test:: using :034both:034 characters
A Test:: using :x22both:x22 characters

Below is some example code to escape an existing batch file variable, "myVar", before passing it to GSAR:

<pre>
SET myVar=%myVar::=::%
SET myVar=%myVar:"=:x22%

@tools@\GSAR.EXE "-sSome Existing Text" "-r%myVar%" -o myfile.txt
</pre>

'''Using GSAR to Escape Percent Signs Written to Batch Files'''

When using a percent sign in your config it must be escaped like so: %%. This ensures that it is not mistaken for the beginning of a batch file variable (e.g.: %myVar%).

If your config needs to create and execute a batch file on the fly, as the example in [[REACT:Amending_Cuesheet_File_References#Using_GSAR|Using GSAR]] does, you will need to re-escape any percent signs, as the act of writing the batch file will unescape any written.

You can use [http://gnuwin32.sourceforge.net/packages/gsar.htm GSAR], before executing your batch file, to ensure that all percent signs written to the file are properly escaped.

GSAR.EXE -s%% -r%%%% -o update-cuesheet.bat

This command will escape all percent signs (% -> %%) in the update-cuesheet.bat file. The -o switch tells GSAR to overwrite the update-cuesheet.bat file.

==Using SED==

The additional config code below uses the GNU tool [http://gnuwin32.sourceforge.net/packages/sed.htm SED] to parse the cuesheet created by [[EAC]], and create a new cuesheet referencing the correctly-named files. This is achieved in the following way:

# Every time a track is processed a SED command, to replace that track's filename, is written to a temporary text file called "sedlist.txt".
# When the last track is processed this file is passed to SED which executes each command on the cuesheet text, and writes the new text to a new cuesheet file named "$cdartist$ - $album$.cue".
# The file "sedlist.txt" is deleted.

'''Writing the SED commands for each track'''

The following line needs to be added to the code which is run for the format you are using for each track:

<pre>ECHO s/FILE "@basename@\.wav"/FILE "%TrackName%\.wv"/>>sedlist.txt</pre>

Here it is in the WavPack section:

<pre>
IF NOT @Wavpack@==1 GOTO end_wavpack_tracks
IF NOT EXIST %TrackDir_Wavpack% MKDIR %TrackDir_Wavpack%
PUSHD %TrackDir_Wavpack%
IF @various@==1 SET VA_tag=-w "album artist=@VA@"
ECHO ON
@tools@\wavpack.exe @Opt_Wavpack@ %VA_tag% -w artist="@artist@" -w album="@album@" -w track="@track@/@numtracks@" -w title="@title@" -w year="@year@" -w genre="@genre@" -w comment="@comment@" -w encodedby="%USERNAME%" -w encodersettings="Wavpack @Ver_Wavpack@ @Opt_Wavpack@" "@source@" "%TrackName%.wv"
ECHO s/FILE "@basename@\.wav"/FILE "%TrackName%\.wv"/>>sedlist.txt
@ECHO OFF
IF %have_cover%==1 IF NOT EXIST folder.jpg COPY "@cover@" folder.jpg
TITLE @track@/@numtracks@ - "@album@"
POPD
:end_wavpack_tracks
</pre>

Note that the extension ("wv") will need to be changed depending on the format that you are using. Additionally, if you are using MP3, you will need to use the following line instead, which correctly changes the file type to MP3 from WAVE:

<pre>ECHO s/FILE "@basename@\.wav" WAVE/FILE "%TrackName%\.mp3" MP3/>>sedlist.txt</pre>

'''Executing SED'''

The following lines need to be added to the code which is run for the format you are using at the end of the config:

<pre>
@tools@\SED -f sedlist.txt <"@albumfile@.[mg].cue" >"$cdartist$ - $album$.cue"
DEL sedlist.txt
</pre>

Here they are in the WavPack section:

<pre>
IF @Wavpack@==1 (
PUSHD %TrackDir_Wavpack%
IF %add_rg%==1 @tools@\wvgain.exe -a *.wv
REM COPY /Y "@eaclog@" "EAClog.txt"
@tools@\SED -f sedlist.txt <"@albumfile@.[mg].cue" >"$cdartist$ - $album$.cue"
DEL sedlist.txt
POPD
)
</pre>

These two lines are universal, and can be added to any format's section with no need for change. Note though, that the example uses the "multiple WAVE files with gaps (non-compliant)" cuesheet as its source. This is the cuesheet that most users would require; however you can replace "@albumfile@.[mg].cue" with "@albumfile@.[m].cue" or "@albumfile@.[mc].cue" if you wish.

'''Requirements'''

You will need to download the Windows version of [http://gnuwin32.sourceforge.net/packages/sed.htm SED], including its dependencies ("libintl3.dll" and "libiconv2.dll"), and put all three files in your [[REACT]] tools directory.

==Related Thread==
This tip is a result of a string of posts between lipidicman and [[User:Synthetic Soul|Synthetic Soul]] in the [http://www.hydrogenaudio.org/forums/index.php?showtopic=50273 REACT 2 thread] beginning with [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=483839 this post].

[[Category:REACT|Amending Cuesheet File References]]

REACT:Amending Cuesheet File References

2008-01-16T14:47:56Z

Synthetic Soul: Formatting

When using [[REACT]] to rip to individual tracks you can request all cuesheets to be created, by specifying the following in REACT.ini:

<pre>CreateAllCuesheets=1</pre>

This will create the following files in the working directory:

* '''"@albumfile@.[s].cue"''' (Single WAVE file)
* '''"@albumfile@.[mg].cue"''' (Multiple WAVE files with gaps (non-compliant))
* '''"@albumfile@.[m].cue"''' (Multiple WAVE files with gaps left out)
* '''"@albumfile@.[mc].cue"''' (Multiple WAVE files with corrected gaps)

The multi-file cuesheets will reference the tracks using the filename format set in [[EAC]], which should be "$cdartist$ - $album$ - $track$ - $title$" for standard albums, and specifying a ".wav" extension. However, this is unlikely to be the format that your track files are actually in, which means that the cuesheet will need to be amended in order to be useful.

Below, you will find example code for two solutions, using two different tools. '''You are recommended to use [http://gnuwin32.sourceforge.net/packages/gsar.htm GSAR] for this purpose''', as certain special characters, e.g.: the ampersand, if used in your filenames, may cause problems when using [http://gnuwin32.sourceforge.net/packages/sed.htm SED].

==Using GSAR==

The additional config code below uses the GNU tool [http://gnuwin32.sourceforge.net/packages/gsar.htm GSAR] to parse the cuesheet created by [[EAC]], and create a new cuesheet referencing the correctly-named files. This is achieved in the following way:

# When the first track is processed the cuesheet will be copied to a new cuesheet file named "$cdartist$ - $album$.cue".
# Every time a track is processed a GSAR command, to replace that track's filename, is written to a temporary batch file called "update-cuesheet.bat".
# When the last track is processed this batch file is executed, executing a GSAR command for each track.
# The file "update-cuesheet.bat" is deleted.

'''Creating the GSAR commands for each track'''

The following lines need to be added to the code which is run for the format you are using for each track:

<pre>SET trackCueFile="$cdartist$ - $album$.cue"
IF NOT EXIST %trackCueFile% COPY "@albumfile@.[mg].cue" %trackCueFile%
ECHO @tools@\GSAR.EXE "-s@basename@.wav" "-r%TrackName%.wv" -o %trackCueFile%>>update-cuesheet.bat</pre>

Here it is in the WavPack section:

<pre>
IF NOT @Wavpack@==1 GOTO end_wavpack_tracks
IF NOT EXIST %TrackDir_Wavpack% MKDIR %TrackDir_Wavpack%
PUSHD %TrackDir_Wavpack%
IF @various@==1 SET VA_tag=-w "album artist=@VA@"
ECHO ON
@tools@\wavpack.exe @Opt_Wavpack@ %VA_tag% -w artist="@artist@" -w album="@album@" -w track="@track@/@numtracks@" -w title="@title@" -w year="@year@" -w genre="@genre@" -w comment="@comment@" -w encodedby="%USERNAME%" -w encodersettings="Wavpack @Ver_Wavpack@ @Opt_Wavpack@" "@source@" "%TrackName%.wv"
@ECHO OFF
SET trackCueFile="$cdartist$ - $album$.cue"
IF NOT EXIST %trackCueFile% COPY "@albumfile@.[mg].cue" %trackCueFile%
ECHO @tools@\GSAR.EXE "-s@basename@.wav" "-r%TrackName%.wv" -o %trackCueFile%>>update-cuesheet.bat
IF %have_cover%==1 IF NOT EXIST folder.jpg COPY "@cover@" folder.jpg
TITLE @track@/@numtracks@ - "@album@"
POPD
:end_wavpack_tracks
</pre>

Note that the extension ("wv") will need to be changed depending on the format that you are using. Additionally, if you are using MP3, you will need to use the following line instead, which correctly changes the file type to MP3 from WAVE:

<pre>ECHO @tools@\GSAR.EXE "-s@basename@.wav""" WAVE" "-r%TrackName%.mp3""" MP3" -o %trackCueFile%>>update-cuesheet.bat</pre>

Also, note that the example uses the "multiple WAVE files with gaps (non-compliant)" cuesheet as its source. This is the cuesheet that most users would require; however you can replace "@albumfile@.[mg].cue" with "@albumfile@.[m].cue" or "@albumfile@.[mc].cue" if you wish.

'''Executing the batch file'''

The following lines need to be added to the code which is run for the format you are using at the end of the config:

<pre>
CALL update-cuesheet.bat
DEL update-cuesheet.bat
</pre>

Here they are in the WavPack section:

<pre>
IF @Wavpack@==1 (
PUSHD %TrackDir_Wavpack%
IF %add_rg%==1 @tools@\wvgain.exe -a *.wv
REM COPY /Y "@eaclog@" "EAClog.txt"
CALL update-cuesheet.bat
DEL update-cuesheet.bat
POPD
)
</pre>

These two lines are universal, and can be added to any format's section with no need for change.

'''Requirements'''

You will need to download the Windows version of [http://gnuwin32.sourceforge.net/packages/gsar.htm GSAR], and put the executable in your [[REACT]] tools directory.

==Using SED==

The additional config code below uses the GNU tool [http://gnuwin32.sourceforge.net/packages/sed.htm SED] to parse the cuesheet created by [[EAC]], and create a new cuesheet referencing the correctly-named files. This is achieved in the following way:

# Every time a track is processed a SED command, to replace that track's filename, is written to a temporary text file called "sedlist.txt".
# When the last track is processed this file is passed to SED which executes each command on the cuesheet text, and writes the new text to a new cuesheet file named "$cdartist$ - $album$.cue".
# The file "sedlist.txt" is deleted.

'''Writing the SED commands for each track'''

The following line needs to be added to the code which is run for the format you are using for each track:

<pre>ECHO s/FILE "@basename@\.wav"/FILE "%TrackName%\.wv"/>>sedlist.txt</pre>

Here it is in the WavPack section:

<pre>
IF NOT @Wavpack@==1 GOTO end_wavpack_tracks
IF NOT EXIST %TrackDir_Wavpack% MKDIR %TrackDir_Wavpack%
PUSHD %TrackDir_Wavpack%
IF @various@==1 SET VA_tag=-w "album artist=@VA@"
ECHO ON
@tools@\wavpack.exe @Opt_Wavpack@ %VA_tag% -w artist="@artist@" -w album="@album@" -w track="@track@/@numtracks@" -w title="@title@" -w year="@year@" -w genre="@genre@" -w comment="@comment@" -w encodedby="%USERNAME%" -w encodersettings="Wavpack @Ver_Wavpack@ @Opt_Wavpack@" "@source@" "%TrackName%.wv"
ECHO s/FILE "@basename@\.wav"/FILE "%TrackName%\.wv"/>>sedlist.txt
@ECHO OFF
IF %have_cover%==1 IF NOT EXIST folder.jpg COPY "@cover@" folder.jpg
TITLE @track@/@numtracks@ - "@album@"
POPD
:end_wavpack_tracks
</pre>

Note that the extension ("wv") will need to be changed depending on the format that you are using. Additionally, if you are using MP3, you will need to use the following line instead, which correctly changes the file type to MP3 from WAVE:

<pre>ECHO s/FILE "@basename@\.wav" WAVE/FILE "%TrackName%\.mp3" MP3/>>sedlist.txt</pre>

'''Executing SED'''

The following lines need to be added to the code which is run for the format you are using at the end of the config:

<pre>
@tools@\SED -f sedlist.txt <"@albumfile@.[mg].cue" >"$cdartist$ - $album$.cue"
DEL sedlist.txt
</pre>

Here they are in the WavPack section:

<pre>
IF @Wavpack@==1 (
PUSHD %TrackDir_Wavpack%
IF %add_rg%==1 @tools@\wvgain.exe -a *.wv
REM COPY /Y "@eaclog@" "EAClog.txt"
@tools@\SED -f sedlist.txt <"@albumfile@.[mg].cue" >"$cdartist$ - $album$.cue"
DEL sedlist.txt
POPD
)
</pre>

These two lines are universal, and can be added to any format's section with no need for change. Note though, that the example uses the "multiple WAVE files with gaps (non-compliant)" cuesheet as its source. This is the cuesheet that most users would require; however you can replace "@albumfile@.[mg].cue" with "@albumfile@.[m].cue" or "@albumfile@.[mc].cue" if you wish.

'''Requirements'''

You will need to download the Windows version of [http://gnuwin32.sourceforge.net/packages/sed.htm SED], including its dependencies ("libintl3.dll" and "libiconv2.dll"), and put all three files in your [[REACT]] tools directory.

==Related Thread==
This tip is a result of a string of posts between lipidicman and [[User:Synthetic Soul|Synthetic Soul]] in the [http://www.hydrogenaudio.org/forums/index.php?showtopic=50273 REACT 2 thread] beginning with [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=483839 this post].

[[Category:REACT|Amending Cuesheet File References]]

REACT:Amending Cuesheet File References

2008-01-16T14:42:35Z

Synthetic Soul: Added GSAR section

When using [[REACT]] to rip to individual tracks you can request all cuesheets to be created, by specifying the following in REACT.ini:

<pre>CreateAllCuesheets=1</pre>

This will create the following files in the working directory:

* '''"@albumfile@.[s].cue"''' (Single WAVE file)
* '''"@albumfile@.[mg].cue"''' (Multiple WAVE files with gaps (non-compliant))
* '''"@albumfile@.[m].cue"''' (Multiple WAVE files with gaps left out)
* '''"@albumfile@.[mc].cue"''' (Multiple WAVE files with corrected gaps)

The multi-file cuesheets will reference the tracks using the filename format set in [[EAC]], which should be "$cdartist$ - $album$ - $track$ - $title$" for standard albums, and specifying a ".wav" extension. However, this is unlikely to be the format that your track files are actually in, which means that the cuesheet will need to be amended in order to be useful.

Below, you will find example code for two solutions, using two different tools. '''You are recommended to use [http://gnuwin32.sourceforge.net/packages/gsar.htm GSAR] for this purpose''', as certain special characters, e.g.: the ampersand, if used in your filenames, may cause problems when using [http://gnuwin32.sourceforge.net/packages/sed.htm SED].

==Using GSAR==

The additional config code below uses the GNU tool [http://gnuwin32.sourceforge.net/packages/gsar.htm GSAR] to parse the cuesheet created by [[EAC]], and create a new cuesheet referencing the correctly-named files. This is achieved in the following way:

# When the first track is processed the cuesheet will be copied to a new cuesheet file named "$cdartist$ - $album$.cue".
# Every time a track is processed a GSAR command, to replace that track's filename, is written to a temporary batch file called "update-cuesheet.bat".
# When the last track is processed this batch file is executed, executing a GSAR command for each track.
# The file "update-cuesheet.bat" is deleted.

'''Creating the GSAR commands for each track'''

The following lines need to be added to the code which is run for the format you are using for each track:

<pre>SET trackCueFile="$cdartist$ - $album$.cue"
IF NOT EXIST %trackCueFile% COPY "@albumfile@.[mg].cue" %trackCueFile%
ECHO @tools@\GSAR.EXE "-s@basename@.wav" "-r%TrackName%.wv" -o %trackCueFile%>>update-cuesheet.bat</pre>

Here it is in the WavPack section:

<pre>
IF NOT @Wavpack@==1 GOTO end_wavpack_tracks
IF NOT EXIST %TrackDir_Wavpack% MKDIR %TrackDir_Wavpack%
PUSHD %TrackDir_Wavpack%
IF @various@==1 SET VA_tag=-w "album artist=@VA@"
ECHO ON
@tools@\wavpack.exe @Opt_Wavpack@ %VA_tag% -w artist="@artist@" -w album="@album@" -w track="@track@/@numtracks@" -w title="@title@" -w year="@year@" -w genre="@genre@" -w comment="@comment@" -w encodedby="%USERNAME%" -w encodersettings="Wavpack @Ver_Wavpack@ @Opt_Wavpack@" "@source@" "%TrackName%.wv"
@ECHO OFF
SET trackCueFile="$cdartist$ - $album$.cue"
IF NOT EXIST %trackCueFile% COPY "@albumfile@.[mg].cue" %trackCueFile%
ECHO @tools@\GSAR.EXE "-s@basename@.wav" "-r%TrackName%.wv" -o %trackCueFile%>>update-cuesheet.bat
IF %have_cover%==1 IF NOT EXIST folder.jpg COPY "@cover@" folder.jpg
TITLE @track@/@numtracks@ - "@album@"
POPD
:end_wavpack_tracks
</pre>

Note that the extension ("wv") will need to be changed depending on the format that you are using. Additionally, if you are using MP3, you will need to use the following line instead, which correctly changes the file type to MP3 from WAVE:

<pre>ECHO @tools@\GSAR.EXE "-s@basename@.wav""" WAVE" "-r%TrackName%.mp3""" MP3" -o %trackCueFile%>>update-cuesheet.bat</pre>

Also, note that the example uses the "multiple WAVE files with gaps (non-compliant)" cuesheet as its source. This is the cuesheet that most users would require; however you can replace "@albumfile@.[mg].cue" with "@albumfile@.[m].cue" or "@albumfile@.[mc].cue" if you wish.

'''Executing the batch file'''

The following lines need to be added to the code which is run for the format you are using at the end of the config:

<pre>
CALL update-cuesheet.bat
DEL update-cuesheet.bat
</pre>

Here they are in the WavPack section:

<pre>
IF @Wavpack@==1 (
PUSHD %TrackDir_Wavpack%
IF %add_rg%==1 @tools@\wvgain.exe -a *.wv
REM COPY /Y "@eaclog@" "EAClog.txt"
CALL update-cuesheet.bat
DEL update-cuesheet.bat
POPD
)
</pre>

These two lines are universal, and can be added to any format's section with no need for change.

===Requirements===
You will need to download the Windows version of [http://gnuwin32.sourceforge.net/packages/gsar.htm GSAR], and put the executable in your [[REACT]] tools directory.

==Using SED==

The additional config code below uses the GNU tool [http://gnuwin32.sourceforge.net/packages/sed.htm SED] to parse the cuesheet created by [[EAC]], and create a new cuesheet referencing the correctly-named files. This is achieved in the following way:

# Every time a track is processed a SED command, to replace that track's filename, is written to a temporary text file called "sedlist.txt".
# When the last track is processed this file is passed to SED which executes each command on the cuesheet text, and writes the new text to a new cuesheet file named "$cdartist$ - $album$.cue".
# The file "sedlist.txt" is deleted.

'''Writing the SED commands for each track'''

The following line needs to be added to the code which is run for the format you are using for each track:

<pre>ECHO s/FILE "@basename@\.wav"/FILE "%TrackName%\.wv"/>>sedlist.txt</pre>

Here it is in the WavPack section:

<pre>
IF NOT @Wavpack@==1 GOTO end_wavpack_tracks
IF NOT EXIST %TrackDir_Wavpack% MKDIR %TrackDir_Wavpack%
PUSHD %TrackDir_Wavpack%
IF @various@==1 SET VA_tag=-w "album artist=@VA@"
ECHO ON
@tools@\wavpack.exe @Opt_Wavpack@ %VA_tag% -w artist="@artist@" -w album="@album@" -w track="@track@/@numtracks@" -w title="@title@" -w year="@year@" -w genre="@genre@" -w comment="@comment@" -w encodedby="%USERNAME%" -w encodersettings="Wavpack @Ver_Wavpack@ @Opt_Wavpack@" "@source@" "%TrackName%.wv"
ECHO s/FILE "@basename@\.wav"/FILE "%TrackName%\.wv"/>>sedlist.txt
@ECHO OFF
IF %have_cover%==1 IF NOT EXIST folder.jpg COPY "@cover@" folder.jpg
TITLE @track@/@numtracks@ - "@album@"
POPD
:end_wavpack_tracks
</pre>

Note that the extension ("wv") will need to be changed depending on the format that you are using. Additionally, if you are using MP3, you will need to use the following line instead, which correctly changes the file type to MP3 from WAVE:

<pre>ECHO s/FILE "@basename@\.wav" WAVE/FILE "%TrackName%\.mp3" MP3/>>sedlist.txt</pre>

'''Executing SED'''

The following lines need to be added to the code which is run for the format you are using at the end of the config:

<pre>
@tools@\SED -f sedlist.txt <"@albumfile@.[mg].cue" >"$cdartist$ - $album$.cue"
DEL sedlist.txt
</pre>

Here they are in the WavPack section:

<pre>
IF @Wavpack@==1 (
PUSHD %TrackDir_Wavpack%
IF %add_rg%==1 @tools@\wvgain.exe -a *.wv
REM COPY /Y "@eaclog@" "EAClog.txt"
@tools@\SED -f sedlist.txt <"@albumfile@.[mg].cue" >"$cdartist$ - $album$.cue"
DEL sedlist.txt
POPD
)
</pre>

These two lines are universal, and can be added to any format's section with no need for change. Note though, that the example uses the "multiple WAVE files with gaps (non-compliant)" cuesheet as its source. This is the cuesheet that most users would require; however you can replace "@albumfile@.[mg].cue" with "@albumfile@.[m].cue" or "@albumfile@.[mc].cue" if you wish.

===Requirements===
You will need to download the Windows version of [http://gnuwin32.sourceforge.net/packages/sed.htm SED], including its dependencies ("libintl3.dll" and "libiconv2.dll"), and put all three files in your [[REACT]] tools directory.

==Related Thread==
This tip is a result of a string of posts between lipidicman and [[User:Synthetic Soul|Synthetic Soul]] in the [http://www.hydrogenaudio.org/forums/index.php?showtopic=50273 REACT 2 thread] beginning with [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=483839 this post].

[[Category:REACT|Amending Cuesheet File References]]

REACT:Mods

2007-12-06T13:47:50Z

Synthetic Soul: Corrected date

==Synthetic Soul's Mod==

[[Image:React-mod.png|thumb|Screenshot demonstrating the Additional Meta Data dialogue]]

[[User:Synthetic Soul|Synthetic Soul]] maintains a mod of [[REACT|REACT 2.0]].

===Key Points===

* Additional Meta Data dialogue allows you to easily edit supplemental disc and track information.
* Track-level tokens supported.
* Additional meta data added to cuesheets, as REM statements.
* Fixes issue in REACT with '%' in any field ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] ).
* Fixes issue in REACT with '&' in the track name when using REACT-track.cfg ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] ).
* Works with new- (EAC 0.99 prebeta 1) and old-style log files.
* Will only rewrite INI file on major or minor version change, not a new build.
* Use Test & Copy by adding <code>Test=1</code> under the Settings section of REACT.ini.

===Description===

The main purpose of this mod is to allow users to easily provide additional meta data to the [[REACT]] configs. This is achieved by the introduction of an Additional Meta Data dialogue, which allows users to easily create, amend and delete additional tokens, which can be used either to set tag values (e.g.: @discnumber@) , or as variables used in conditions within the config to alter the processing path (e.g.: @_disctype@).

The dialogue is opened using '''Alt+F5'''. The new dialogue is non-modal, but will stay on top of the EAC main window; if you minimise [[EAC]] the dialogue is minimised also. If you close the dialogue it is simply hidden from view, so your list items will stay intact. Therefore, if you need to set various meta data for each disc that you are ripping, you may choose to keep the dialogue open throughout the process; however, if you only need to use it to alter values infrequently, you can leave it hidden, but know that the values are still available to your config file.

The current list state is recorded in a new file called "meta.ini" in your REACT folder. The values in this INI are eventually used to replace tokens with values when your config runs. The INI is updated any time that you update or delete an item.

====Setting Defaults====

Default tokens and their values can be set in the REACT.ini file, under the newly created '''DefaultMetaData''' section. When [[REACT]] is initially opened, or the user changes a disc, the token values are reset to these defaults. The dialogue allows you to quickly and easily amend the token values on a per disc basic, rather than having to edit the INI manually (see '[[REACT:Mods#A Basic Alternative|A Basic Alternative]]').

A simple example would be the @discnumber@ and @totaldiscs@ tokens, which are initially set to a default of '1'. If you are ripping a multi-disc album you can alter these values as required, in the knowledge that they will revert to '1' when a new disc is inserted. The article '[[REACT:Adding Support For Disc Information]]' details config changes that will use these tokens to add disc information to your files, and amend the folder structure, if @totaldiscs@ exceeds one.

====Processing Tokens====

Your additional tokens are inserted into any [[Cuesheet|cuesheets]] created using REM statements, so are available to ACDIR, and any other application that can parse [[Cuesheet|cuesheets]] with REM statements. Album-level tokens are added at the top of the [[Cuesheet|cuesheet]], with the other global values. Track-level tokens are added beneath the appropriate TRACK statement. Therefore, if you are ripping to an image, you can still use these values with any tracks you create, using ACDIR's $R{} and $r{} syntax, e.g.: $R{DISCNUMBER} and $r{COMPOSER}.

If you do not want certain tokens added to the cuesheet you can prefix the token name with an underscore, e.g.: @_disctype@. These are assumed to be temporary, or processing, tokens, used purely for conditionally executing sections of your config.

====Track-Level Tokens====

Most tokens are album-related. If you want to set track-level tokens you should use the format '''<token name>[<track number>]''', e.g.: '''composer[1]''' to set the composer token value for track one. Your config should refer to the token only by name, e.g.: @composer@. When processing track one, @composer@ will be replaced by the value of composer[1], when processing track two, @composer@ will be replaced by the value of composer[2], etc.

====Using The Tokens====

You can use both @ and $-style tokens in your config. When using $ tokens any integer value will be zero-padded ("4" -> "04") and any string values will be converted to a filename-friendly value, using the standard [[REACT]] character replacement. Therefore, if you create a token called '''discname''' you can use @discname@ when tagging, and $discname$ when creating a file or folder name.

===A Basic Alternative===
If you want to use additional tokens in your config but do not want to use this mod you ''can'' add additional variables to the existing '''UserTrackFormats''', '''UserOutputNames''', and, ''more pertinently'', '''UserSettings''' sections of REACT.ini. You will need to update these variables by hand in a text editor if the value required for the disc you are ripping differs from the current value set.

===Changelog===
2.0.ssb5, 03/05/07
* First public release.

2.0.ssb6, 04/05/07
* Additional Meta Data dialogue made child of EAC window.
* Changed function prefix from fGUI to fDiag to save confusion.

2.0.ssb8, 14/05/07
* Moved default values into REACT.ini.
* Fixed the code that writes track-level meta data to the cuesheet.
* Current token values now stored in "meta.ini", not "metadata.ini".
* Moved a little more code from the main source file into the include.

2.0.ssb9, 14/05/07
* Track cuesheets now supported.

2.0.ssb10, 30/05/07
* Added underscore prefix to identify temporary tokens.
* Fixed REACT issue with "%" in any field. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] )
* Fixed REACT issue with "&" in the track name when using REACT-track.cfg. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] )

2.0.ssb11, 01/07/07
* Works with new- (EAC 0.99 prebeta 1) and old-style (EAC 0.95 beta 4 and earlier) log files. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=501821 post] )
* Will only rewrite INI file on major or minor version change, not a new build.

2.0.ssb12, 02/07/07
* Log file handling now works correctly for track ripping.

2.0.ssb13, 04/07/07
* Reverted cover filename to "<album>.jpg" irrespective of EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=502330 post] )

2.0.ssb15, 17/07/07
* Reverted @albumfile@ to "<sourcedir>\<album>", irrespective of the EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=505038 post] )
* Add <code>Test=1</code> under the Settings section of REACT.ini to use Test and Copy mode.

2.0.ssb16, 29/07/07
* Fixed issues with meta data changing mid-process. meta.ini is now only updated with the GUI values immediately before a rip begins.
* Fixed bug with @ and $ values. @totaldiscs@ will now correctly return "3", while $totaldiscs$ will return "03".

2.0.ssb16b, 15/08/07
* Fixed issue with log file name when ripping a VA album to tracks ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=510414 post] ).

2.0.ssb16c, 21/08/07
* Add <code>CoverDownloaderXUI=1</CODE> to the [Settings] section of your REACT.ini when using Album Art XUI, and REACT will cope with JPEG, GIF, and PNG album art ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=511640 post] ).

2.0.ssb16d, 21/08/07
* Added BMP support to above.

2.0.ssb16e, 23/08/07
* Fixed bug with above, where the artist and album did not change with the disc.

2.0.ssb16f, 11/09/07
* Hitting Ctrl+F2 to reconfigure EAC will now ensure that the working directories used by EAC are in synch ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=515730 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=512481 post] ).

2.0.ssb16g, 17/09/07
* You can now process an existing wav/cue/log(/jpg) file-set by passing the full cuesheet path to REACT as a single parameter. This will treat the files as if they had just been created by EAC as per normal execution.

2.0.ssb16h, 17/09/07
* Set <code>CoverDownloaderLocalPath</code>, in the [Settings] section of your REACT.ini, to the path of your existing album art if you would rather chose those over any downloaded using the cover downloader. You may use $artist$ and $album$ tokens in the path, e.g.:
CoverDownloaderLocalPath=C:\Documents and Settings\My Name\My Documents\My Music\$artist$\$album$\folder.jpg

2.0.ssb16i, 12/11/07
* Fixed a bug with <code>CreateAllCuesheets</code> when detecting gaps is required ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529370 post] ).
* Reinstated <code>TracksHotVal</code>, after unwittingly removing the functionality.

2.0.ssb16j, 14/11/07
* Artist and album names are now correctly escaped in the album art command lines ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).
* Apostrophes in the log file name are now correctly replaced with a space (in track mode) ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).

2.0.ssb16k, 16/11/07
* Apostrophes no longer wrongly replaced, and double quotes now simply removed from album art command line. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=530101 post] ).
* UserOutputNames INI section no longer escaped, so you can again use Window's tokens, e.g.: %USERPROFILE% ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=530166 post] ).
* REACT now checks that EAC is the active window before sending the commands to create the four cuesheets.

2.0.ssb16l, 19/11/07
* Log file name in track mode now, finally, calculated correctly.
* The <code>RunCoverDownloader</code> values as documented in [[REACT|the wiki page]] should now work as expected.

2.0.ssb16m, 28/11/07
* The number of tracks to process is now calculated from a cuesheet in track mode.
* Expanded CreateAllCuesheets code to notify the user if a problem occurs.

2.0.ssb16n, 30/11/07
* Added Akkurat's improvements to the CreateAllCuesheets processing.
* Added nago's multi-thread amendments.
* Updated configs and INI are now included in the download.

===Download===
[http://www.synthetic-soul.co.uk/temp/REACT_2.0.ssb16n.zip REACT 2.0.ssb16n]

[[Category:REACT|Mods]]

REACT:Mods

2007-12-04T09:23:27Z

Synthetic Soul: Updated to 2.0.ssb16n

==Synthetic Soul's Mod==

[[Image:React-mod.png|thumb|Screenshot demonstrating the Additional Meta Data dialogue]]

[[User:Synthetic Soul|Synthetic Soul]] maintains a mod of [[REACT|REACT 2.0]].

===Key Points===

* Additional Meta Data dialogue allows you to easily edit supplemental disc and track information.
* Track-level tokens supported.
* Additional meta data added to cuesheets, as REM statements.
* Fixes issue in REACT with '%' in any field ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] ).
* Fixes issue in REACT with '&' in the track name when using REACT-track.cfg ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] ).
* Works with new- (EAC 0.99 prebeta 1) and old-style log files.
* Will only rewrite INI file on major or minor version change, not a new build.
* Use Test & Copy by adding <code>Test=1</code> under the Settings section of REACT.ini.

===Description===

The main purpose of this mod is to allow users to easily provide additional meta data to the [[REACT]] configs. This is achieved by the introduction of an Additional Meta Data dialogue, which allows users to easily create, amend and delete additional tokens, which can be used either to set tag values (e.g.: @discnumber@) , or as variables used in conditions within the config to alter the processing path (e.g.: @_disctype@).

The dialogue is opened using '''Alt+F5'''. The new dialogue is non-modal, but will stay on top of the EAC main window; if you minimise [[EAC]] the dialogue is minimised also. If you close the dialogue it is simply hidden from view, so your list items will stay intact. Therefore, if you need to set various meta data for each disc that you are ripping, you may choose to keep the dialogue open throughout the process; however, if you only need to use it to alter values infrequently, you can leave it hidden, but know that the values are still available to your config file.

The current list state is recorded in a new file called "meta.ini" in your REACT folder. The values in this INI are eventually used to replace tokens with values when your config runs. The INI is updated any time that you update or delete an item.

====Setting Defaults====

Default tokens and their values can be set in the REACT.ini file, under the newly created '''DefaultMetaData''' section. When [[REACT]] is initially opened, or the user changes a disc, the token values are reset to these defaults. The dialogue allows you to quickly and easily amend the token values on a per disc basic, rather than having to edit the INI manually (see '[[REACT:Mods#A Basic Alternative|A Basic Alternative]]').

A simple example would be the @discnumber@ and @totaldiscs@ tokens, which are initially set to a default of '1'. If you are ripping a multi-disc album you can alter these values as required, in the knowledge that they will revert to '1' when a new disc is inserted. The article '[[REACT:Adding Support For Disc Information]]' details config changes that will use these tokens to add disc information to your files, and amend the folder structure, if @totaldiscs@ exceeds one.

====Processing Tokens====

Your additional tokens are inserted into any [[Cuesheet|cuesheets]] created using REM statements, so are available to ACDIR, and any other application that can parse [[Cuesheet|cuesheets]] with REM statements. Album-level tokens are added at the top of the [[Cuesheet|cuesheet]], with the other global values. Track-level tokens are added beneath the appropriate TRACK statement. Therefore, if you are ripping to an image, you can still use these values with any tracks you create, using ACDIR's $R{} and $r{} syntax, e.g.: $R{DISCNUMBER} and $r{COMPOSER}.

If you do not want certain tokens added to the cuesheet you can prefix the token name with an underscore, e.g.: @_disctype@. These are assumed to be temporary, or processing, tokens, used purely for conditionally executing sections of your config.

====Track-Level Tokens====

Most tokens are album-related. If you want to set track-level tokens you should use the format '''<token name>[<track number>]''', e.g.: '''composer[1]''' to set the composer token value for track one. Your config should refer to the token only by name, e.g.: @composer@. When processing track one, @composer@ will be replaced by the value of composer[1], when processing track two, @composer@ will be replaced by the value of composer[2], etc.

====Using The Tokens====

You can use both @ and $-style tokens in your config. When using $ tokens any integer value will be zero-padded ("4" -> "04") and any string values will be converted to a filename-friendly value, using the standard [[REACT]] character replacement. Therefore, if you create a token called '''discname''' you can use @discname@ when tagging, and $discname$ when creating a file or folder name.

===A Basic Alternative===
If you want to use additional tokens in your config but do not want to use this mod you ''can'' add additional variables to the existing '''UserTrackFormats''', '''UserOutputNames''', and, ''more pertinently'', '''UserSettings''' sections of REACT.ini. You will need to update these variables by hand in a text editor if the value required for the disc you are ripping differs from the current value set.

===Changelog===
2.0.ssb5, 03/05/07
* First public release.

2.0.ssb6, 04/05/07
* Additional Meta Data dialogue made child of EAC window.
* Changed function prefix from fGUI to fDiag to save confusion.

2.0.ssb8, 14/05/07
* Moved default values into REACT.ini.
* Fixed the code that writes track-level meta data to the cuesheet.
* Current token values now stored in "meta.ini", not "metadata.ini".
* Moved a little more code from the main source file into the include.

2.0.ssb9, 14/05/07
* Track cuesheets now supported.

2.0.ssb10, 30/05/07
* Added underscore prefix to identify temporary tokens.
* Fixed REACT issue with "%" in any field. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] )
* Fixed REACT issue with "&" in the track name when using REACT-track.cfg. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] )

2.0.ssb11, 01/07/07
* Works with new- (EAC 0.99 prebeta 1) and old-style (EAC 0.95 beta 4 and earlier) log files. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=501821 post] )
* Will only rewrite INI file on major or minor version change, not a new build.

2.0.ssb12, 02/07/07
* Log file handling now works correctly for track ripping.

2.0.ssb13, 04/07/07
* Reverted cover filename to "<album>.jpg" irrespective of EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=502330 post] )

2.0.ssb15, 17/07/07
* Reverted @albumfile@ to "<sourcedir>\<album>", irrespective of the EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=505038 post] )
* Add <code>Test=1</code> under the Settings section of REACT.ini to use Test and Copy mode.

2.0.ssb16, 29/07/07
* Fixed issues with meta data changing mid-process. meta.ini is now only updated with the GUI values immediately before a rip begins.
* Fixed bug with @ and $ values. @totaldiscs@ will now correctly return "3", while $totaldiscs$ will return "03".

2.0.ssb16b, 15/08/07
* Fixed issue with log file name when ripping a VA album to tracks ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=510414 post] ).

2.0.ssb16c, 21/08/07
* Add <code>CoverDownloaderXUI=1</CODE> to the [Settings] section of your REACT.ini when using Album Art XUI, and REACT will cope with JPEG, GIF, and PNG album art ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=511640 post] ).

2.0.ssb16d, 21/08/07
* Added BMP support to above.

2.0.ssb16e, 23/08/07
* Fixed bug with above, where the artist and album did not change with the disc.

2.0.ssb16f, 11/09/07
* Hitting Ctrl+F2 to reconfigure EAC will now ensure that the working directories used by EAC are in synch ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=515730 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=512481 post] ).

2.0.ssb16g, 17/09/07
* You can now process an existing wav/cue/log(/jpg) file-set by passing the full cuesheet path to REACT as a single parameter. This will treat the files as if they had just been created by EAC as per normal execution.

2.0.ssb16h, 17/09/07
* Set <code>CoverDownloaderLocalPath</code>, in the [Settings] section of your REACT.ini, to the path of your existing album art if you would rather chose those over any downloaded using the cover downloader. You may use $artist$ and $album$ tokens in the path, e.g.:
CoverDownloaderLocalPath=C:\Documents and Settings\My Name\My Documents\My Music\$artist$\$album$\folder.jpg

2.0.ssb16i, 12/11/07
* Fixed a bug with <code>CreateAllCuesheets</code> when detecting gaps is required ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529370 post] ).
* Reinstated <code>TracksHotVal</code>, after unwittingly removing the functionality.

2.0.ssb16j, 14/11/07
* Artist and album names are now correctly escaped in the album art command lines ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).
* Apostrophes in the log file name are now correctly replaced with a space (in track mode) ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).

2.0.ssb16k, 16/11/07
* Apostrophes no longer wrongly replaced, and double quotes now simply removed from album art command line. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=530101 post] ).
* UserOutputNames INI section no longer escaped, so you can again use Window's tokens, e.g.: %USERPROFILE% ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=530166 post] ).
* REACT now checks that EAC is the active window before sending the commands to create the four cuesheets.

2.0.ssb16l, 19/11/07
* Log file name in track mode now, finally, calculated correctly.
* The <code>RunCoverDownloader</code> values as documented in [[REACT|the wiki page]] should now work as expected.

2.0.ssb16m, 28/11/07
* The number of tracks to process is now calculated from a cuesheet in track mode.
* Expanded CreateAllCuesheets code to notify the user if a problem occurs.

2.0.ssb16n, 02/11/07
* Added Akkurat's improvements to the CreateAllCuesheets processing.
* Added nago's multi-thread amendments.
* Updated configs and INI are now included in the download.

===Download===
[http://www.synthetic-soul.co.uk/temp/REACT_2.0.ssb16n.zip REACT 2.0.ssb16n]

[[Category:REACT|Mods]]

REACT:Mods

2007-11-19T11:09:31Z

Synthetic Soul: Updated to 2.0.ssb16l

==Synthetic Soul's Mod==

[[Image:React-mod.png|thumb|Screenshot demonstrating the Additional Meta Data dialogue]]

[[User:Synthetic Soul|Synthetic Soul]] maintains a mod of [[REACT|REACT 2.0]].

===Key Points===

* Additional Meta Data dialogue allows you to easily edit supplemental disc and track information.
* Track-level tokens supported.
* Additional meta data added to cuesheets, as REM statements.
* Fixes issue in REACT with '%' in any field ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] ).
* Fixes issue in REACT with '&' in the track name when using REACT-track.cfg ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] ).
* Works with new- (EAC 0.99 prebeta 1) and old-style log files.
* Will only rewrite INI file on major or minor version change, not a new build.
* Use Test & Copy by adding <code>Test=1</code> under the Settings section of REACT.ini.

===Description===

The main purpose of this mod is to allow users to easily provide additional meta data to the [[REACT]] configs. This is achieved by the introduction of an Additional Meta Data dialogue, which allows users to easily create, amend and delete additional tokens, which can be used either to set tag values (e.g.: @discnumber@) , or as variables used in conditions within the config to alter the processing path (e.g.: @_disctype@).

The dialogue is opened using '''Alt+F5'''. The new dialogue is non-modal, but will stay on top of the EAC main window; if you minimise [[EAC]] the dialogue is minimised also. If you close the dialogue it is simply hidden from view, so your list items will stay intact. Therefore, if you need to set various meta data for each disc that you are ripping, you may choose to keep the dialogue open throughout the process; however, if you only need to use it to alter values infrequently, you can leave it hidden, but know that the values are still available to your config file.

The current list state is recorded in a new file called "meta.ini" in your REACT folder. The values in this INI are eventually used to replace tokens with values when your config runs. The INI is updated any time that you update or delete an item.

====Setting Defaults====

Default tokens and their values can be set in the REACT.ini file, under the newly created '''DefaultMetaData''' section. When [[REACT]] is initially opened, or the user changes a disc, the token values are reset to these defaults. The dialogue allows you to quickly and easily amend the token values on a per disc basic, rather than having to edit the INI manually (see '[[REACT:Mods#A Basic Alternative|A Basic Alternative]]').

A simple example would be the @discnumber@ and @totaldiscs@ tokens, which are initially set to a default of '1'. If you are ripping a multi-disc album you can alter these values as required, in the knowledge that they will revert to '1' when a new disc is inserted. The article '[[REACT:Adding Support For Disc Information]]' details config changes that will use these tokens to add disc information to your files, and amend the folder structure, if @totaldiscs@ exceeds one.

====Processing Tokens====

Your additional tokens are inserted into any [[Cuesheet|cuesheets]] created using REM statements, so are available to ACDIR, and any other application that can parse [[Cuesheet|cuesheets]] with REM statements. Album-level tokens are added at the top of the [[Cuesheet|cuesheet]], with the other global values. Track-level tokens are added beneath the appropriate TRACK statement. Therefore, if you are ripping to an image, you can still use these values with any tracks you create, using ACDIR's $R{} and $r{} syntax, e.g.: $R{DISCNUMBER} and $r{COMPOSER}.

If you do not want certain tokens added to the cuesheet you can prefix the token name with an underscore, e.g.: @_disctype@. These are assumed to be temporary, or processing, tokens, used purely for conditionally executing sections of your config.

====Track-Level Tokens====

Most tokens are album-related. If you want to set track-level tokens you should use the format '''<token name>[<track number>]''', e.g.: '''composer[1]''' to set the composer token value for track one. Your config should refer to the token only by name, e.g.: @composer@. When processing track one, @composer@ will be replaced by the value of composer[1], when processing track two, @composer@ will be replaced by the value of composer[2], etc.

====Using The Tokens====

You can use both @ and $-style tokens in your config. When using $ tokens any integer value will be zero-padded ("4" -> "04") and any string values will be converted to a filename-friendly value, using the standard [[REACT]] character replacement. Therefore, if you create a token called '''discname''' you can use @discname@ when tagging, and $discname$ when creating a file or folder name.

===A Basic Alternative===
If you want to use additional tokens in your config but do not want to use this mod you ''can'' add additional variables to the existing '''UserTrackFormats''', '''UserOutputNames''', and, ''more pertinently'', '''UserSettings''' sections of REACT.ini. You will need to update these variables by hand in a text editor if the value required for the disc you are ripping differs from the current value set.

===Changelog===
2.0.ssb5, 03/05/07
* First public release.

2.0.ssb6, 04/05/07
* Additional Meta Data dialogue made child of EAC window.
* Changed function prefix from fGUI to fDiag to save confusion.

2.0.ssb8, 14/05/07
* Moved default values into REACT.ini.
* Fixed the code that writes track-level meta data to the cuesheet.
* Current token values now stored in "meta.ini", not "metadata.ini".
* Moved a little more code from the main source file into the include.

2.0.ssb9, 14/05/07
* Track cuesheets now supported.

2.0.ssb10, 30/05/07
* Added underscore prefix to identify temporary tokens.
* Fixed REACT issue with "%" in any field. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] )
* Fixed REACT issue with "&" in the track name when using REACT-track.cfg. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] )

2.0.ssb11, 01/07/07
* Works with new- (EAC 0.99 prebeta 1) and old-style (EAC 0.95 beta 4 and earlier) log files. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=501821 post] )
* Will only rewrite INI file on major or minor version change, not a new build.

2.0.ssb12, 02/07/07
* Log file handling now works correctly for track ripping.

2.0.ssb13, 04/07/07
* Reverted cover filename to "<album>.jpg" irrespective of EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=502330 post] )

2.0.ssb15, 17/07/07
* Reverted @albumfile@ to "<sourcedir>\<album>", irrespective of the EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=505038 post] )
* Add <code>Test=1</code> under the Settings section of REACT.ini to use Test and Copy mode.

2.0.ssb16, 29/07/07
* Fixed issues with meta data changing mid-process. meta.ini is now only updated with the GUI values immediately before a rip begins.
* Fixed bug with @ and $ values. @totaldiscs@ will now correctly return "3", while $totaldiscs$ will return "03".

2.0.ssb16b, 15/08/07
* Fixed issue with log file name when ripping a VA album to tracks ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=510414 post] ).

2.0.ssb16c, 21/08/07
* Add <code>CoverDownloaderXUI=1</CODE> to the [Settings] section of your REACT.ini when using Album Art XUI, and REACT will cope with JPEG, GIF, and PNG album art ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=511640 post] ).

2.0.ssb16d, 21/08/07
* Added BMP support to above.

2.0.ssb16e, 23/08/07
* Fixed bug with above, where the artist and album did not change with the disc.

2.0.ssb16f, 11/09/07
* Hitting Ctrl+F2 to reconfigure EAC will now ensure that the working directories used by EAC are in synch ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=515730 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=512481 post] ).

2.0.ssb16g, 17/09/07
* You can now process an existing wav/cue/log(/jpg) file-set by passing the full cuesheet path to REACT as a single parameter. This will treat the files as if they had just been created by EAC as per normal execution.

2.0.ssb16h, 17/09/07
* Set <code>CoverDownloaderLocalPath</code>, in the [Settings] section of your REACT.ini, to the path of your existing album art if you would rather chose those over any downloaded using the cover downloader. You may use $artist$ and $album$ tokens in the path, e.g.:
CoverDownloaderLocalPath=C:\Documents and Settings\My Name\My Documents\My Music\$artist$\$album$\folder.jpg

2.0.ssb16i, 12/11/07
* Fixed a bug with <code>CreateAllCuesheets</code> when detecting gaps is required ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529370 post] ).
* Reinstated <code>TracksHotVal</code>, after unwittingly removing the functionality.

2.0.ssb16j, 14/11/07
* Artist and album names are now correctly escaped in the album art command lines ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).
* Apostrophes in the log file name are now correctly replaced with a space (in track mode) ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).

2.0.ssb16k, 16/11/07
* Apostrophes no longer wrongly replaced, and double quotes now simply removed from album art command line. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=530101 post] ).
* UserOutputNames INI section no longer escaped, so you can again use Window's tokens, e.g.: %USERPROFILE% ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=530166 post] ).
* REACT now checks that EAC is the active window before sending the commands to create the four cuesheets.

2.0.ssb16l, 19/11/07
* Log file name in track mode now, finally, calculated correctly.
* The <code>RunCoverDownloader</code> values as documented in [[REACT|the wiki page]] should now work as expected.

===Download===
[http://www.synthetic-soul.co.uk/temp/REACT_2.0.ssb16l.zip REACT 2.0.ssb16l]

====Updated CFG files====
The zip below includes updated REACT.ini, REACT-track.cfg and REACT-image.cfg files, utilising various aspects of this mod, including (but not restricted to) support for TAK, the ampersand fix, and disc-related tags.

[http://www.synthetic-soul.co.uk/temp/REACT-cfgs_ssb16.zip REACT-cfgs_ssb16.zip]

[[Category:REACT|Mods]]

REACT:Mods

2007-11-17T08:33:46Z

Synthetic Soul: Removd l for now

==Synthetic Soul's Mod==

[[Image:React-mod.png|thumb|Screenshot demonstrating the Additional Meta Data dialogue]]

[[User:Synthetic Soul|Synthetic Soul]] maintains a mod of [[REACT|REACT 2.0]].

===Key Points===

* Additional Meta Data dialogue allows you to easily edit supplemental disc and track information.
* Track-level tokens supported.
* Additional meta data added to cuesheets, as REM statements.
* Fixes issue in REACT with '%' in any field ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] ).
* Fixes issue in REACT with '&' in the track name when using REACT-track.cfg ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] ).
* Works with new- (EAC 0.99 prebeta 1) and old-style log files.
* Will only rewrite INI file on major or minor version change, not a new build.
* Use Test & Copy by adding <code>Test=1</code> under the Settings section of REACT.ini.

===Description===

The main purpose of this mod is to allow users to easily provide additional meta data to the [[REACT]] configs. This is achieved by the introduction of an Additional Meta Data dialogue, which allows users to easily create, amend and delete additional tokens, which can be used either to set tag values (e.g.: @discnumber@) , or as variables used in conditions within the config to alter the processing path (e.g.: @_disctype@).

The dialogue is opened using '''Alt+F5'''. The new dialogue is non-modal, but will stay on top of the EAC main window; if you minimise [[EAC]] the dialogue is minimised also. If you close the dialogue it is simply hidden from view, so your list items will stay intact. Therefore, if you need to set various meta data for each disc that you are ripping, you may choose to keep the dialogue open throughout the process; however, if you only need to use it to alter values infrequently, you can leave it hidden, but know that the values are still available to your config file.

The current list state is recorded in a new file called "meta.ini" in your REACT folder. The values in this INI are eventually used to replace tokens with values when your config runs. The INI is updated any time that you update or delete an item.

====Setting Defaults====

Default tokens and their values can be set in the REACT.ini file, under the newly created '''DefaultMetaData''' section. When [[REACT]] is initially opened, or the user changes a disc, the token values are reset to these defaults. The dialogue allows you to quickly and easily amend the token values on a per disc basic, rather than having to edit the INI manually (see '[[REACT:Mods#A Basic Alternative|A Basic Alternative]]').

A simple example would be the @discnumber@ and @totaldiscs@ tokens, which are initially set to a default of '1'. If you are ripping a multi-disc album you can alter these values as required, in the knowledge that they will revert to '1' when a new disc is inserted. The article '[[REACT:Adding Support For Disc Information]]' details config changes that will use these tokens to add disc information to your files, and amend the folder structure, if @totaldiscs@ exceeds one.

====Processing Tokens====

Your additional tokens are inserted into any [[Cuesheet|cuesheets]] created using REM statements, so are available to ACDIR, and any other application that can parse [[Cuesheet|cuesheets]] with REM statements. Album-level tokens are added at the top of the [[Cuesheet|cuesheet]], with the other global values. Track-level tokens are added beneath the appropriate TRACK statement. Therefore, if you are ripping to an image, you can still use these values with any tracks you create, using ACDIR's $R{} and $r{} syntax, e.g.: $R{DISCNUMBER} and $r{COMPOSER}.

If you do not want certain tokens added to the cuesheet you can prefix the token name with an underscore, e.g.: @_disctype@. These are assumed to be temporary, or processing, tokens, used purely for conditionally executing sections of your config.

====Track-Level Tokens====

Most tokens are album-related. If you want to set track-level tokens you should use the format '''<token name>[<track number>]''', e.g.: '''composer[1]''' to set the composer token value for track one. Your config should refer to the token only by name, e.g.: @composer@. When processing track one, @composer@ will be replaced by the value of composer[1], when processing track two, @composer@ will be replaced by the value of composer[2], etc.

====Using The Tokens====

You can use both @ and $-style tokens in your config. When using $ tokens any integer value will be zero-padded ("4" -> "04") and any string values will be converted to a filename-friendly value, using the standard [[REACT]] character replacement. Therefore, if you create a token called '''discname''' you can use @discname@ when tagging, and $discname$ when creating a file or folder name.

===A Basic Alternative===
If you want to use additional tokens in your config but do not want to use this mod you ''can'' add additional variables to the existing '''UserTrackFormats''', '''UserOutputNames''', and, ''more pertinently'', '''UserSettings''' sections of REACT.ini. You will need to update these variables by hand in a text editor if the value required for the disc you are ripping differs from the current value set.

===Changelog===
2.0.ssb5, 03/05/07
* First public release.

2.0.ssb6, 04/05/07
* Additional Meta Data dialogue made child of EAC window.
* Changed function prefix from fGUI to fDiag to save confusion.

2.0.ssb8, 14/05/07
* Moved default values into REACT.ini.
* Fixed the code that writes track-level meta data to the cuesheet.
* Current token values now stored in "meta.ini", not "metadata.ini".
* Moved a little more code from the main source file into the include.

2.0.ssb9, 14/05/07
* Track cuesheets now supported.

2.0.ssb10, 30/05/07
* Added underscore prefix to identify temporary tokens.
* Fixed REACT issue with "%" in any field. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] )
* Fixed REACT issue with "&" in the track name when using REACT-track.cfg. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] )

2.0.ssb11, 01/07/07
* Works with new- (EAC 0.99 prebeta 1) and old-style (EAC 0.95 beta 4 and earlier) log files. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=501821 post] )
* Will only rewrite INI file on major or minor version change, not a new build.

2.0.ssb12, 02/07/07
* Log file handling now works correctly for track ripping.

2.0.ssb13, 04/07/07
* Reverted cover filename to "<album>.jpg" irrespective of EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=502330 post] )

2.0.ssb15, 17/07/07
* Reverted @albumfile@ to "<sourcedir>\<album>", irrespective of the EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=505038 post] )
* Add <code>Test=1</code> under the Settings section of REACT.ini to use Test and Copy mode.

2.0.ssb16, 29/07/07
* Fixed issues with meta data changing mid-process. meta.ini is now only updated with the GUI values immediately before a rip begins.
* Fixed bug with @ and $ values. @totaldiscs@ will now correctly return "3", while $totaldiscs$ will return "03".

2.0.ssb16b, 15/08/07
* Fixed issue with log file name when ripping a VA album to tracks ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=510414 post] ).

2.0.ssb16c, 21/08/07
* Add <code>CoverDownloaderXUI=1</CODE> to the [Settings] section of your REACT.ini when using Album Art XUI, and REACT will cope with JPEG, GIF, and PNG album art ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=511640 post] ).

2.0.ssb16d, 21/08/07
* Added BMP support to above.

2.0.ssb16e, 23/08/07
* Fixed bug with above, where the artist and album did not change with the disc.

2.0.ssb16f, 11/09/07
* Hitting Ctrl+F2 to reconfigure EAC will now ensure that the working directories used by EAC are in synch ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=515730 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=512481 post] ).

2.0.ssb16g, 17/09/07
* You can now process an existing wav/cue/log(/jpg) file-set by passing the full cuesheet path to REACT as a single parameter. This will treat the files as if they had just been created by EAC as per normal execution.

2.0.ssb16h, 17/09/07
* Set <code>CoverDownloaderLocalPath</code>, in the [Settings] section of your REACT.ini, to the path of your existing album art if you would rather chose those over any downloaded using the cover downloader. You may use $artist$ and $album$ tokens in the path, e.g.:
CoverDownloaderLocalPath=C:\Documents and Settings\My Name\My Documents\My Music\$artist$\$album$\folder.jpg

2.0.ssb16i, 12/11/07
* Fixed a bug with <code>CreateAllCuesheets</code> when detecting gaps is required ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529370 post] ).
* Reinstated <code>TracksHotVal</code>, after unwittingly removing the functionality.

2.0.ssb16j, 14/11/07
* Artist and album names are now correctly escaped in the album art command lines ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).
* Apostrophes in the log file name are now correctly replaced with a space (in track mode) ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).

2.0.ssb16k, 16/11/07
* 2.0.ssb16j was a disaster! Apostrophes no longer wrongly replaced, and double quotes now simply removed from album art command line. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=530101 post] ).
* UserOutputNames INI section no longer escaped, so you can again use Window's tokens, e.g.: %USERPROFILE% ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=530166 post] ).
* REACT now checks that EAC is the active window before sending the commands to create the four cuesheets.

===Download===
[http://www.synthetic-soul.co.uk/temp/REACT_2.0.ssb16k.zip REACT 2.0.ssb16k]

====Updated CFG files====
The zip below includes updated REACT.ini, REACT-track.cfg and REACT-image.cfg files, utilising various aspects of this mod, including (but not restricted to) support for TAK, the ampersand fix, and disc-related tags.

[http://www.synthetic-soul.co.uk/temp/REACT-cfgs_ssb16.zip REACT-cfgs_ssb16.zip]

[[Category:REACT|Mods]]

REACT:Mods

2007-11-17T08:13:29Z

Synthetic Soul:

==Synthetic Soul's Mod==

[[Image:React-mod.png|thumb|Screenshot demonstrating the Additional Meta Data dialogue]]

[[User:Synthetic Soul|Synthetic Soul]] maintains a mod of [[REACT|REACT 2.0]].

===Key Points===

* Additional Meta Data dialogue allows you to easily edit supplemental disc and track information.
* Track-level tokens supported.
* Additional meta data added to cuesheets, as REM statements.
* Fixes issue in REACT with '%' in any field ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] ).
* Fixes issue in REACT with '&' in the track name when using REACT-track.cfg ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] ).
* Works with new- (EAC 0.99 prebeta 1) and old-style log files.
* Will only rewrite INI file on major or minor version change, not a new build.
* Use Test & Copy by adding <code>Test=1</code> under the Settings section of REACT.ini.

===Description===

The main purpose of this mod is to allow users to easily provide additional meta data to the [[REACT]] configs. This is achieved by the introduction of an Additional Meta Data dialogue, which allows users to easily create, amend and delete additional tokens, which can be used either to set tag values (e.g.: @discnumber@) , or as variables used in conditions within the config to alter the processing path (e.g.: @_disctype@).

The dialogue is opened using '''Alt+F5'''. The new dialogue is non-modal, but will stay on top of the EAC main window; if you minimise [[EAC]] the dialogue is minimised also. If you close the dialogue it is simply hidden from view, so your list items will stay intact. Therefore, if you need to set various meta data for each disc that you are ripping, you may choose to keep the dialogue open throughout the process; however, if you only need to use it to alter values infrequently, you can leave it hidden, but know that the values are still available to your config file.

The current list state is recorded in a new file called "meta.ini" in your REACT folder. The values in this INI are eventually used to replace tokens with values when your config runs. The INI is updated any time that you update or delete an item.

====Setting Defaults====

Default tokens and their values can be set in the REACT.ini file, under the newly created '''DefaultMetaData''' section. When [[REACT]] is initially opened, or the user changes a disc, the token values are reset to these defaults. The dialogue allows you to quickly and easily amend the token values on a per disc basic, rather than having to edit the INI manually (see '[[REACT:Mods#A Basic Alternative|A Basic Alternative]]').

A simple example would be the @discnumber@ and @totaldiscs@ tokens, which are initially set to a default of '1'. If you are ripping a multi-disc album you can alter these values as required, in the knowledge that they will revert to '1' when a new disc is inserted. The article '[[REACT:Adding Support For Disc Information]]' details config changes that will use these tokens to add disc information to your files, and amend the folder structure, if @totaldiscs@ exceeds one.

====Processing Tokens====

Your additional tokens are inserted into any [[Cuesheet|cuesheets]] created using REM statements, so are available to ACDIR, and any other application that can parse [[Cuesheet|cuesheets]] with REM statements. Album-level tokens are added at the top of the [[Cuesheet|cuesheet]], with the other global values. Track-level tokens are added beneath the appropriate TRACK statement. Therefore, if you are ripping to an image, you can still use these values with any tracks you create, using ACDIR's $R{} and $r{} syntax, e.g.: $R{DISCNUMBER} and $r{COMPOSER}.

If you do not want certain tokens added to the cuesheet you can prefix the token name with an underscore, e.g.: @_disctype@. These are assumed to be temporary, or processing, tokens, used purely for conditionally executing sections of your config.

====Track-Level Tokens====

Most tokens are album-related. If you want to set track-level tokens you should use the format '''<token name>[<track number>]''', e.g.: '''composer[1]''' to set the composer token value for track one. Your config should refer to the token only by name, e.g.: @composer@. When processing track one, @composer@ will be replaced by the value of composer[1], when processing track two, @composer@ will be replaced by the value of composer[2], etc.

====Using The Tokens====

You can use both @ and $-style tokens in your config. When using $ tokens any integer value will be zero-padded ("4" -> "04") and any string values will be converted to a filename-friendly value, using the standard [[REACT]] character replacement. Therefore, if you create a token called '''discname''' you can use @discname@ when tagging, and $discname$ when creating a file or folder name.

===A Basic Alternative===
If you want to use additional tokens in your config but do not want to use this mod you ''can'' add additional variables to the existing '''UserTrackFormats''', '''UserOutputNames''', and, ''more pertinently'', '''UserSettings''' sections of REACT.ini. You will need to update these variables by hand in a text editor if the value required for the disc you are ripping differs from the current value set.

===Changelog===
2.0.ssb5, 03/05/07
* First public release.

2.0.ssb6, 04/05/07
* Additional Meta Data dialogue made child of EAC window.
* Changed function prefix from fGUI to fDiag to save confusion.

2.0.ssb8, 14/05/07
* Moved default values into REACT.ini.
* Fixed the code that writes track-level meta data to the cuesheet.
* Current token values now stored in "meta.ini", not "metadata.ini".
* Moved a little more code from the main source file into the include.

2.0.ssb9, 14/05/07
* Track cuesheets now supported.

2.0.ssb10, 30/05/07
* Added underscore prefix to identify temporary tokens.
* Fixed REACT issue with "%" in any field. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] )
* Fixed REACT issue with "&" in the track name when using REACT-track.cfg. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] )

2.0.ssb11, 01/07/07
* Works with new- (EAC 0.99 prebeta 1) and old-style (EAC 0.95 beta 4 and earlier) log files. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=501821 post] )
* Will only rewrite INI file on major or minor version change, not a new build.

2.0.ssb12, 02/07/07
* Log file handling now works correctly for track ripping.

2.0.ssb13, 04/07/07
* Reverted cover filename to "<album>.jpg" irrespective of EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=502330 post] )

2.0.ssb15, 17/07/07
* Reverted @albumfile@ to "<sourcedir>\<album>", irrespective of the EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=505038 post] )
* Add <code>Test=1</code> under the Settings section of REACT.ini to use Test and Copy mode.

2.0.ssb16, 29/07/07
* Fixed issues with meta data changing mid-process. meta.ini is now only updated with the GUI values immediately before a rip begins.
* Fixed bug with @ and $ values. @totaldiscs@ will now correctly return "3", while $totaldiscs$ will return "03".

2.0.ssb16b, 15/08/07
* Fixed issue with log file name when ripping a VA album to tracks ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=510414 post] ).

2.0.ssb16c, 21/08/07
* Add <code>CoverDownloaderXUI=1</CODE> to the [Settings] section of your REACT.ini when using Album Art XUI, and REACT will cope with JPEG, GIF, and PNG album art ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=511640 post] ).

2.0.ssb16d, 21/08/07
* Added BMP support to above.

2.0.ssb16e, 23/08/07
* Fixed bug with above, where the artist and album did not change with the disc.

2.0.ssb16f, 11/09/07
* Hitting Ctrl+F2 to reconfigure EAC will now ensure that the working directories used by EAC are in synch ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=515730 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=512481 post] ).

2.0.ssb16g, 17/09/07
* You can now process an existing wav/cue/log(/jpg) file-set by passing the full cuesheet path to REACT as a single parameter. This will treat the files as if they had just been created by EAC as per normal execution.

2.0.ssb16h, 17/09/07
* Set <code>CoverDownloaderLocalPath</code>, in the [Settings] section of your REACT.ini, to the path of your existing album art if you would rather chose those over any downloaded using the cover downloader. You may use $artist$ and $album$ tokens in the path, e.g.:
CoverDownloaderLocalPath=C:\Documents and Settings\My Name\My Documents\My Music\$artist$\$album$\folder.jpg

2.0.ssb16i, 12/11/07
* Fixed a bug with <code>CreateAllCuesheets</code> when detecting gaps is required ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529370 post] ).
* Reinstated <code>TracksHotVal</code>, after unwittingly removing the functionality.

2.0.ssb16j, 14/11/07
* Artist and album names are now correctly escaped in the album art command lines ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).
* Apostrophes in the log file name are now correctly replaced with a space (in track mode) ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).

2.0.ssb16k, 16/11/07
* 2.0.ssb16j was a disaster! Apostrophes no longer wrongly replaced, and double quotes now simply removed from album art command line. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=530101 post] ).
* UserOutputNames INI section no longer escaped, so you can again use Window's tokens, e.g.: %USERPROFILE% ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=530166 post] ).
* REACT now checks that EAC is the active window before sending the commands to create the four cuesheets.

2.0.ssb16l, 17/11/07
* Log file name in track mode now calculated correctly (again).
* The <code>RunCoverDownloader</code> values as documented in [[REACT|the wiki page]] should now work as expected.

===Download===
[http://www.synthetic-soul.co.uk/temp/REACT_2.0.ssb16l.zip REACT 2.0.ssb16l]

====Updated CFG files====
The zip below includes updated REACT.ini, REACT-track.cfg and REACT-image.cfg files, utilising various aspects of this mod, including (but not restricted to) support for TAK, the ampersand fix, and disc-related tags.

[http://www.synthetic-soul.co.uk/temp/REACT-cfgs_ssb16.zip REACT-cfgs_ssb16.zip]

[[Category:REACT|Mods]]

REACT:Mods

2007-11-17T08:12:55Z

Synthetic Soul: Updated to 2.0.ssb16l

==Synthetic Soul's Mod==

[[Image:React-mod.png|thumb|Screenshot demonstrating the Additional Meta Data dialogue]]

[[User:Synthetic Soul|Synthetic Soul]] maintains a mod of [[REACT|REACT 2.0]].

===Key Points===

* Additional Meta Data dialogue allows you to easily edit supplemental disc and track information.
* Track-level tokens supported.
* Additional meta data added to cuesheets, as REM statements.
* Fixes issue in REACT with '%' in any field ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] ).
* Fixes issue in REACT with '&' in the track name when using REACT-track.cfg ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] ).
* Works with new- (EAC 0.99 prebeta 1) and old-style log files.
* Will only rewrite INI file on major or minor version change, not a new build.
* Use Test & Copy by adding <code>Test=1</code> under the Settings section of REACT.ini.

===Description===

The main purpose of this mod is to allow users to easily provide additional meta data to the [[REACT]] configs. This is achieved by the introduction of an Additional Meta Data dialogue, which allows users to easily create, amend and delete additional tokens, which can be used either to set tag values (e.g.: @discnumber@) , or as variables used in conditions within the config to alter the processing path (e.g.: @_disctype@).

The dialogue is opened using '''Alt+F5'''. The new dialogue is non-modal, but will stay on top of the EAC main window; if you minimise [[EAC]] the dialogue is minimised also. If you close the dialogue it is simply hidden from view, so your list items will stay intact. Therefore, if you need to set various meta data for each disc that you are ripping, you may choose to keep the dialogue open throughout the process; however, if you only need to use it to alter values infrequently, you can leave it hidden, but know that the values are still available to your config file.

The current list state is recorded in a new file called "meta.ini" in your REACT folder. The values in this INI are eventually used to replace tokens with values when your config runs. The INI is updated any time that you update or delete an item.

====Setting Defaults====

Default tokens and their values can be set in the REACT.ini file, under the newly created '''DefaultMetaData''' section. When [[REACT]] is initially opened, or the user changes a disc, the token values are reset to these defaults. The dialogue allows you to quickly and easily amend the token values on a per disc basic, rather than having to edit the INI manually (see '[[REACT:Mods#A Basic Alternative|A Basic Alternative]]').

A simple example would be the @discnumber@ and @totaldiscs@ tokens, which are initially set to a default of '1'. If you are ripping a multi-disc album you can alter these values as required, in the knowledge that they will revert to '1' when a new disc is inserted. The article '[[REACT:Adding Support For Disc Information]]' details config changes that will use these tokens to add disc information to your files, and amend the folder structure, if @totaldiscs@ exceeds one.

====Processing Tokens====

Your additional tokens are inserted into any [[Cuesheet|cuesheets]] created using REM statements, so are available to ACDIR, and any other application that can parse [[Cuesheet|cuesheets]] with REM statements. Album-level tokens are added at the top of the [[Cuesheet|cuesheet]], with the other global values. Track-level tokens are added beneath the appropriate TRACK statement. Therefore, if you are ripping to an image, you can still use these values with any tracks you create, using ACDIR's $R{} and $r{} syntax, e.g.: $R{DISCNUMBER} and $r{COMPOSER}.

If you do not want certain tokens added to the cuesheet you can prefix the token name with an underscore, e.g.: @_disctype@. These are assumed to be temporary, or processing, tokens, used purely for conditionally executing sections of your config.

====Track-Level Tokens====

Most tokens are album-related. If you want to set track-level tokens you should use the format '''<token name>[<track number>]''', e.g.: '''composer[1]''' to set the composer token value for track one. Your config should refer to the token only by name, e.g.: @composer@. When processing track one, @composer@ will be replaced by the value of composer[1], when processing track two, @composer@ will be replaced by the value of composer[2], etc.

====Using The Tokens====

You can use both @ and $-style tokens in your config. When using $ tokens any integer value will be zero-padded ("4" -> "04") and any string values will be converted to a filename-friendly value, using the standard [[REACT]] character replacement. Therefore, if you create a token called '''discname''' you can use @discname@ when tagging, and $discname$ when creating a file or folder name.

===A Basic Alternative===
If you want to use additional tokens in your config but do not want to use this mod you ''can'' add additional variables to the existing '''UserTrackFormats''', '''UserOutputNames''', and, ''more pertinently'', '''UserSettings''' sections of REACT.ini. You will need to update these variables by hand in a text editor if the value required for the disc you are ripping differs from the current value set.

===Changelog===
2.0.ssb5, 03/05/07
* First public release.

2.0.ssb6, 04/05/07
* Additional Meta Data dialogue made child of EAC window.
* Changed function prefix from fGUI to fDiag to save confusion.

2.0.ssb8, 14/05/07
* Moved default values into REACT.ini.
* Fixed the code that writes track-level meta data to the cuesheet.
* Current token values now stored in "meta.ini", not "metadata.ini".
* Moved a little more code from the main source file into the include.

2.0.ssb9, 14/05/07
* Track cuesheets now supported.

2.0.ssb10, 30/05/07
* Added underscore prefix to identify temporary tokens.
* Fixed REACT issue with "%" in any field. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] )
* Fixed REACT issue with "&" in the track name when using REACT-track.cfg. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] )

2.0.ssb11, 01/07/07
* Works with new- (EAC 0.99 prebeta 1) and old-style (EAC 0.95 beta 4 and earlier) log files. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=501821 post] )
* Will only rewrite INI file on major or minor version change, not a new build.

2.0.ssb12, 02/07/07
* Log file handling now works correctly for track ripping.

2.0.ssb13, 04/07/07
* Reverted cover filename to "<album>.jpg" irrespective of EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=502330 post] )

2.0.ssb15, 17/07/07
* Reverted @albumfile@ to "<sourcedir>\<album>", irrespective of the EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=505038 post] )
* Add <code>Test=1</code> under the Settings section of REACT.ini to use Test and Copy mode.

2.0.ssb16, 29/07/07
* Fixed issues with meta data changing mid-process. meta.ini is now only updated with the GUI values immediately before a rip begins.
* Fixed bug with @ and $ values. @totaldiscs@ will now correctly return "3", while $totaldiscs$ will return "03".

2.0.ssb16b, 15/08/07
* Fixed issue with log file name when ripping a VA album to tracks ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=510414 post] ).

2.0.ssb16c, 21/08/07
* Add <code>CoverDownloaderXUI=1</CODE> to the [Settings] section of your REACT.ini when using Album Art XUI, and REACT will cope with JPEG, GIF, and PNG album art ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=511640 post] ).

2.0.ssb16d, 21/08/07
* Added BMP support to above.

2.0.ssb16e, 23/08/07
* Fixed bug with above, where the artist and album did not change with the disc.

2.0.ssb16f, 11/09/07
* Hitting Ctrl+F2 to reconfigure EAC will now ensure that the working directories used by EAC are in synch ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=515730 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=512481 post] ).

2.0.ssb16g, 17/09/07
* You can now process an existing wav/cue/log(/jpg) file-set by passing the full cuesheet path to REACT as a single parameter. This will treat the files as if they had just been created by EAC as per normal execution.

2.0.ssb16h, 17/09/07
* Set <code>CoverDownloaderLocalPath</code>, in the [Settings] section of your REACT.ini, to the path of your existing album art if you would rather chose those over any downloaded using the cover downloader. You may use $artist$ and $album$ tokens in the path, e.g.:
CoverDownloaderLocalPath=C:\Documents and Settings\My Name\My Documents\My Music\$artist$\$album$\folder.jpg

2.0.ssb16i, 12/11/07
* Fixed a bug with <code>CreateAllCuesheets</code> when detecting gaps is required ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529370 post] ).
* Reinstated <code>TracksHotVal</code>, after unwittingly removing the functionality.

2.0.ssb16j, 14/11/07
* Artist and album names are now correctly escaped in the album art command lines ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).
* Apostrophes in the log file name are now correctly replaced with a space (in track mode) ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).

2.0.ssb16k, 16/11/07
* 2.0.ssb16j was a disaster! Apostrophes no longer wrongly replaced, and double quotes now simply removed from album art command line. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=530101 post] ).
* UserOutputNames INI section no longer escaped, so you can again use Window's tokens, e.g.: %USERPROFILE% ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=530166 post] ).
* REACT now checks that EAC is the active window before sending the commands to create the four cuesheets.

2.0.ssb16l, 16/11/07
* Log file name in track mode now calculated correctly (again).
* The <code>RunCoverDownloader</code> values as documented in [[REACT|the wiki page]] should now work as expected.

===Download===
[http://www.synthetic-soul.co.uk/temp/REACT_2.0.ssb16l.zip REACT 2.0.ssb16l]

====Updated CFG files====
The zip below includes updated REACT.ini, REACT-track.cfg and REACT-image.cfg files, utilising various aspects of this mod, including (but not restricted to) support for TAK, the ampersand fix, and disc-related tags.

[http://www.synthetic-soul.co.uk/temp/REACT-cfgs_ssb16.zip REACT-cfgs_ssb16.zip]

[[Category:REACT|Mods]]

REACT:Mods

2007-11-16T17:34:48Z

Synthetic Soul:

==Synthetic Soul's Mod==

[[Image:React-mod.png|thumb|Screenshot demonstrating the Additional Meta Data dialogue]]

[[User:Synthetic Soul|Synthetic Soul]] maintains a mod of [[REACT|REACT 2.0]].

===Key Points===

* Additional Meta Data dialogue allows you to easily edit supplemental disc and track information.
* Track-level tokens supported.
* Additional meta data added to cuesheets, as REM statements.
* Fixes issue in REACT with '%' in any field ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] ).
* Fixes issue in REACT with '&' in the track name when using REACT-track.cfg ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] ).
* Works with new- (EAC 0.99 prebeta 1) and old-style log files.
* Will only rewrite INI file on major or minor version change, not a new build.
* Use Test & Copy by adding <code>Test=1</code> under the Settings section of REACT.ini.

===Description===

The main purpose of this mod is to allow users to easily provide additional meta data to the [[REACT]] configs. This is achieved by the introduction of an Additional Meta Data dialogue, which allows users to easily create, amend and delete additional tokens, which can be used either to set tag values (e.g.: @discnumber@) , or as variables used in conditions within the config to alter the processing path (e.g.: @_disctype@).

The dialogue is opened using '''Alt+F5'''. The new dialogue is non-modal, but will stay on top of the EAC main window; if you minimise [[EAC]] the dialogue is minimised also. If you close the dialogue it is simply hidden from view, so your list items will stay intact. Therefore, if you need to set various meta data for each disc that you are ripping, you may choose to keep the dialogue open throughout the process; however, if you only need to use it to alter values infrequently, you can leave it hidden, but know that the values are still available to your config file.

The current list state is recorded in a new file called "meta.ini" in your REACT folder. The values in this INI are eventually used to replace tokens with values when your config runs. The INI is updated any time that you update or delete an item.

====Setting Defaults====

Default tokens and their values can be set in the REACT.ini file, under the newly created '''DefaultMetaData''' section. When [[REACT]] is initially opened, or the user changes a disc, the token values are reset to these defaults. The dialogue allows you to quickly and easily amend the token values on a per disc basic, rather than having to edit the INI manually (see '[[REACT:Mods#A Basic Alternative|A Basic Alternative]]').

A simple example would be the @discnumber@ and @totaldiscs@ tokens, which are initially set to a default of '1'. If you are ripping a multi-disc album you can alter these values as required, in the knowledge that they will revert to '1' when a new disc is inserted. The article '[[REACT:Adding Support For Disc Information]]' details config changes that will use these tokens to add disc information to your files, and amend the folder structure, if @totaldiscs@ exceeds one.

====Processing Tokens====

Your additional tokens are inserted into any [[Cuesheet|cuesheets]] created using REM statements, so are available to ACDIR, and any other application that can parse [[Cuesheet|cuesheets]] with REM statements. Album-level tokens are added at the top of the [[Cuesheet|cuesheet]], with the other global values. Track-level tokens are added beneath the appropriate TRACK statement. Therefore, if you are ripping to an image, you can still use these values with any tracks you create, using ACDIR's $R{} and $r{} syntax, e.g.: $R{DISCNUMBER} and $r{COMPOSER}.

If you do not want certain tokens added to the cuesheet you can prefix the token name with an underscore, e.g.: @_disctype@. These are assumed to be temporary, or processing, tokens, used purely for conditionally executing sections of your config.

====Track-Level Tokens====

Most tokens are album-related. If you want to set track-level tokens you should use the format '''<token name>[<track number>]''', e.g.: '''composer[1]''' to set the composer token value for track one. Your config should refer to the token only by name, e.g.: @composer@. When processing track one, @composer@ will be replaced by the value of composer[1], when processing track two, @composer@ will be replaced by the value of composer[2], etc.

====Using The Tokens====

You can use both @ and $-style tokens in your config. When using $ tokens any integer value will be zero-padded ("4" -> "04") and any string values will be converted to a filename-friendly value, using the standard [[REACT]] character replacement. Therefore, if you create a token called '''discname''' you can use @discname@ when tagging, and $discname$ when creating a file or folder name.

===A Basic Alternative===
If you want to use additional tokens in your config but do not want to use this mod you ''can'' add additional variables to the existing '''UserTrackFormats''', '''UserOutputNames''', and, ''more pertinently'', '''UserSettings''' sections of REACT.ini. You will need to update these variables by hand in a text editor if the value required for the disc you are ripping differs from the current value set.

===Changelog===
2.0.ssb5, 03/05/07
* First public release.

2.0.ssb6, 04/05/07
* Additional Meta Data dialogue made child of EAC window.
* Changed function prefix from fGUI to fDiag to save confusion.

2.0.ssb8, 14/05/07
* Moved default values into REACT.ini.
* Fixed the code that writes track-level meta data to the cuesheet.
* Current token values now stored in "meta.ini", not "metadata.ini".
* Moved a little more code from the main source file into the include.

2.0.ssb9, 14/05/07
* Track cuesheets now supported.

2.0.ssb10, 30/05/07
* Added underscore prefix to identify temporary tokens.
* Fixed REACT issue with "%" in any field. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] )
* Fixed REACT issue with "&" in the track name when using REACT-track.cfg. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] )

2.0.ssb11, 01/07/07
* Works with new- (EAC 0.99 prebeta 1) and old-style (EAC 0.95 beta 4 and earlier) log files. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=501821 post] )
* Will only rewrite INI file on major or minor version change, not a new build.

2.0.ssb12, 02/07/07
* Log file handling now works correctly for track ripping.

2.0.ssb13, 04/07/07
* Reverted cover filename to "<album>.jpg" irrespective of EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=502330 post] )

2.0.ssb15, 17/07/07
* Reverted @albumfile@ to "<sourcedir>\<album>", irrespective of the EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=505038 post] )
* Add <code>Test=1</code> under the Settings section of REACT.ini to use Test and Copy mode.

2.0.ssb16, 29/07/07
* Fixed issues with meta data changing mid-process. meta.ini is now only updated with the GUI values immediately before a rip begins.
* Fixed bug with @ and $ values. @totaldiscs@ will now correctly return "3", while $totaldiscs$ will return "03".

2.0.ssb16b, 15/08/07
* Fixed issue with log file name when ripping a VA album to tracks ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=510414 post] ).

2.0.ssb16c, 21/08/07
* Add <code>CoverDownloaderXUI=1</CODE> to the [Settings] section of your REACT.ini when using Album Art XUI, and REACT will cope with JPEG, GIF, and PNG album art ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=511640 post] ).

2.0.ssb16d, 21/08/07
* Added BMP support to above.

2.0.ssb16e, 23/08/07
* Fixed bug with above, where the artist and album did not change with the disc.

2.0.ssb16f, 11/09/07
* Hitting Ctrl+F2 to reconfigure EAC will now ensure that the working directories used by EAC are in synch ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=515730 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=512481 post] ).

2.0.ssb16g, 17/09/07
* You can now process an existing wav/cue/log(/jpg) file-set by passing the full cuesheet path to REACT as a single parameter. This will treat the files as if they had just been created by EAC as per normal execution.

2.0.ssb16h, 17/09/07
* Set <code>CoverDownloaderLocalPath</code>, in the [Settings] section of your REACT.ini, to the path of your existing album art if you would rather chose those over any downloaded using the cover downloader. You may use $artist$ and $album$ tokens in the path, e.g.:
CoverDownloaderLocalPath=C:\Documents and Settings\My Name\My Documents\My Music\$artist$\$album$\folder.jpg

2.0.ssb16i, 12/11/07
* Fixed a bug with <code>CreateAllCuesheets</code> when detecting gaps is required ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529370 post] ).
* Reinstated <code>TracksHotVal</code>, after unwittingly removing the functionality.

2.0.ssb16j, 14/11/07
* Artist and album names are now correctly escaped in the album art command lines ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).
* Apostrophes in the log file name are now correctly replaced with a space (in track mode) ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).

2.0.ssb16k, 16/11/07
* 2.0.ssb16j was a disaster! Apostrophes no longer wrongly replaced, and double quotes now simply removed from album art command line. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=530101 post] ).
* UserOutputNames INI section no longer escaped, so you can again use Window's tokens, e.g.: %USERPROFILE% ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=530166 post] ).
* REACT now checks that EAC is the active window before sending the commands to create the four cuesheets.

===Download===
[http://www.synthetic-soul.co.uk/temp/REACT_2.0.ssb16k.zip REACT 2.0.ssb16k]

====Updated CFG files====
The zip below includes updated REACT.ini, REACT-track.cfg and REACT-image.cfg files, utilising various aspects of this mod, including (but not restricted to) support for TAK, the ampersand fix, and disc-related tags.

[http://www.synthetic-soul.co.uk/temp/REACT-cfgs_ssb16.zip REACT-cfgs_ssb16.zip]

[[Category:REACT|Mods]]

REACT:Mods

2007-11-16T16:26:46Z

Synthetic Soul:

==Synthetic Soul's Mod==

[[Image:React-mod.png|thumb|Screenshot demonstrating the Additional Meta Data dialogue]]

[[User:Synthetic Soul|Synthetic Soul]] maintains a mod of [[REACT|REACT 2.0]].

===Key Points===

* Additional Meta Data dialogue allows you to easily edit supplemental disc and track information.
* Track-level tokens supported.
* Additional meta data added to cuesheets, as REM statements.
* Fixes issue in REACT with '%' in any field ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] ).
* Fixes issue in REACT with '&' in the track name when using REACT-track.cfg ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] ).
* Works with new- (EAC 0.99 prebeta 1) and old-style log files.
* Will only rewrite INI file on major or minor version change, not a new build.
* Use Test & Copy by adding <code>Test=1</code> under the Settings section of REACT.ini.

===Description===

The main purpose of this mod is to allow users to easily provide additional meta data to the [[REACT]] configs. This is achieved by the introduction of an Additional Meta Data dialogue, which allows users to easily create, amend and delete additional tokens, which can be used either to set tag values (e.g.: @discnumber@) , or as variables used in conditions within the config to alter the processing path (e.g.: @_disctype@).

The dialogue is opened using '''Alt+F5'''. The new dialogue is non-modal, but will stay on top of the EAC main window; if you minimise [[EAC]] the dialogue is minimised also. If you close the dialogue it is simply hidden from view, so your list items will stay intact. Therefore, if you need to set various meta data for each disc that you are ripping, you may choose to keep the dialogue open throughout the process; however, if you only need to use it to alter values infrequently, you can leave it hidden, but know that the values are still available to your config file.

The current list state is recorded in a new file called "meta.ini" in your REACT folder. The values in this INI are eventually used to replace tokens with values when your config runs. The INI is updated any time that you update or delete an item.

====Setting Defaults====

Default tokens and their values can be set in the REACT.ini file, under the newly created '''DefaultMetaData''' section. When [[REACT]] is initially opened, or the user changes a disc, the token values are reset to these defaults. The dialogue allows you to quickly and easily amend the token values on a per disc basic, rather than having to edit the INI manually (see '[[REACT:Mods#A Basic Alternative|A Basic Alternative]]').

A simple example would be the @discnumber@ and @totaldiscs@ tokens, which are initially set to a default of '1'. If you are ripping a multi-disc album you can alter these values as required, in the knowledge that they will revert to '1' when a new disc is inserted. The article '[[REACT:Adding Support For Disc Information]]' details config changes that will use these tokens to add disc information to your files, and amend the folder structure, if @totaldiscs@ exceeds one.

====Processing Tokens====

Your additional tokens are inserted into any [[Cuesheet|cuesheets]] created using REM statements, so are available to ACDIR, and any other application that can parse [[Cuesheet|cuesheets]] with REM statements. Album-level tokens are added at the top of the [[Cuesheet|cuesheet]], with the other global values. Track-level tokens are added beneath the appropriate TRACK statement. Therefore, if you are ripping to an image, you can still use these values with any tracks you create, using ACDIR's $R{} and $r{} syntax, e.g.: $R{DISCNUMBER} and $r{COMPOSER}.

If you do not want certain tokens added to the cuesheet you can prefix the token name with an underscore, e.g.: @_disctype@. These are assumed to be temporary, or processing, tokens, used purely for conditionally executing sections of your config.

====Track-Level Tokens====

Most tokens are album-related. If you want to set track-level tokens you should use the format '''<token name>[<track number>]''', e.g.: '''composer[1]''' to set the composer token value for track one. Your config should refer to the token only by name, e.g.: @composer@. When processing track one, @composer@ will be replaced by the value of composer[1], when processing track two, @composer@ will be replaced by the value of composer[2], etc.

====Using The Tokens====

You can use both @ and $-style tokens in your config. When using $ tokens any integer value will be zero-padded ("4" -> "04") and any string values will be converted to a filename-friendly value, using the standard [[REACT]] character replacement. Therefore, if you create a token called '''discname''' you can use @discname@ when tagging, and $discname$ when creating a file or folder name.

===A Basic Alternative===
If you want to use additional tokens in your config but do not want to use this mod you ''can'' add additional variables to the existing '''UserTrackFormats''', '''UserOutputNames''', and, ''more pertinently'', '''UserSettings''' sections of REACT.ini. You will need to update these variables by hand in a text editor if the value required for the disc you are ripping differs from the current value set.

===Changelog===
2.0.ssb5, 03/05/07
* First public release.

2.0.ssb6, 04/05/07
* Additional Meta Data dialogue made child of EAC window.
* Changed function prefix from fGUI to fDiag to save confusion.

2.0.ssb8, 14/05/07
* Moved default values into REACT.ini.
* Fixed the code that writes track-level meta data to the cuesheet.
* Current token values now stored in "meta.ini", not "metadata.ini".
* Moved a little more code from the main source file into the include.

2.0.ssb9, 14/05/07
* Track cuesheets now supported.

2.0.ssb10, 30/05/07
* Added underscore prefix to identify temporary tokens.
* Fixed REACT issue with "%" in any field. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] )
* Fixed REACT issue with "&" in the track name when using REACT-track.cfg. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] )

2.0.ssb11, 01/07/07
* Works with new- (EAC 0.99 prebeta 1) and old-style (EAC 0.95 beta 4 and earlier) log files. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=501821 post] )
* Will only rewrite INI file on major or minor version change, not a new build.

2.0.ssb12, 02/07/07
* Log file handling now works correctly for track ripping.

2.0.ssb13, 04/07/07
* Reverted cover filename to "<album>.jpg" irrespective of EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=502330 post] )

2.0.ssb15, 17/07/07
* Reverted @albumfile@ to "<sourcedir>\<album>", irrespective of the EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=505038 post] )
* Add <code>Test=1</code> under the Settings section of REACT.ini to use Test and Copy mode.

2.0.ssb16, 29/07/07
* Fixed issues with meta data changing mid-process. meta.ini is now only updated with the GUI values immediately before a rip begins.
* Fixed bug with @ and $ values. @totaldiscs@ will now correctly return "3", while $totaldiscs$ will return "03".

2.0.ssb16b, 15/08/07
* Fixed issue with log file name when ripping a VA album to tracks ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=510414 post] ).

2.0.ssb16c, 21/08/07
* Add <code>CoverDownloaderXUI=1</CODE> to the [Settings] section of your REACT.ini when using Album Art XUI, and REACT will cope with JPEG, GIF, and PNG album art ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=511640 post] ).

2.0.ssb16d, 21/08/07
* Added BMP support to above.

2.0.ssb16e, 23/08/07
* Fixed bug with above, where the artist and album did not change with the disc.

2.0.ssb16f, 11/09/07
* Hitting Ctrl+F2 to reconfigure EAC will now ensure that the working directories used by EAC are in synch ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=515730 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=512481 post] ).

2.0.ssb16g, 17/09/07
* You can now process an existing wav/cue/log(/jpg) file-set by passing the full cuesheet path to REACT as a single parameter. This will treat the files as if they had just been created by EAC as per normal execution.

2.0.ssb16h, 17/09/07
* Set <code>CoverDownloaderLocalPath</code>, in the [Settings] section of your REACT.ini, to the path of your existing album art if you would rather chose those over any downloaded using the cover downloader. You may use $artist$ and $album$ tokens in the path, e.g.:
CoverDownloaderLocalPath=C:\Documents and Settings\My Name\My Documents\My Music\$artist$\$album$\folder.jpg

2.0.ssb16i, 12/11/07
* Fixed a bug with <code>CreateAllCuesheets</code> when detecting gaps is required ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529370 post] ).
* Reinstated <code>TracksHotVal</code>, after unwittingly removing the functionality.

2.0.ssb16j, 14/11/07
* Artist and album names are now correctly escaped in the album art command lines ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).
* Apostrophes in the log file name are now correctly replaced with a space (in track mode) ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).

2.0.ssb16k, 16/11/07
* 2.0.ssb16j was a disaster! Apostrophes no longer wrongly replaced, and double quotes now simply removed from album art command line. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=530101 post] ).
* UserOutputNames INI section no longer escaped, so you can again use Window's tokens, e.g.: %USERPROFILE% ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=530166 post] ).

===Download===
[http://www.synthetic-soul.co.uk/temp/REACT_2.0.ssb16k.zip REACT 2.0.ssb16k]

====Updated CFG files====
The zip below includes updated REACT.ini, REACT-track.cfg and REACT-image.cfg files, utilising various aspects of this mod, including (but not restricted to) support for TAK, the ampersand fix, and disc-related tags.

[http://www.synthetic-soul.co.uk/temp/REACT-cfgs_ssb16.zip REACT-cfgs_ssb16.zip]

[[Category:REACT|Mods]]

REACT:Mods

2007-11-16T16:26:04Z

Synthetic Soul: Updated to 2.0.ssb16k

==Synthetic Soul's Mod==

[[Image:React-mod.png|thumb|Screenshot demonstrating the Additional Meta Data dialogue]]

[[User:Synthetic Soul|Synthetic Soul]] maintains a mod of [[REACT|REACT 2.0]].

===Key Points===

* Additional Meta Data dialogue allows you to easily edit supplemental disc and track information.
* Track-level tokens supported.
* Additional meta data added to cuesheets, as REM statements.
* Fixes issue in REACT with '%' in any field ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] ).
* Fixes issue in REACT with '&' in the track name when using REACT-track.cfg ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] ).
* Works with new- (EAC 0.99 prebeta 1) and old-style log files.
* Will only rewrite INI file on major or minor version change, not a new build.
* Use Test & Copy by adding <code>Test=1</code> under the Settings section of REACT.ini.

===Description===

The main purpose of this mod is to allow users to easily provide additional meta data to the [[REACT]] configs. This is achieved by the introduction of an Additional Meta Data dialogue, which allows users to easily create, amend and delete additional tokens, which can be used either to set tag values (e.g.: @discnumber@) , or as variables used in conditions within the config to alter the processing path (e.g.: @_disctype@).

The dialogue is opened using '''Alt+F5'''. The new dialogue is non-modal, but will stay on top of the EAC main window; if you minimise [[EAC]] the dialogue is minimised also. If you close the dialogue it is simply hidden from view, so your list items will stay intact. Therefore, if you need to set various meta data for each disc that you are ripping, you may choose to keep the dialogue open throughout the process; however, if you only need to use it to alter values infrequently, you can leave it hidden, but know that the values are still available to your config file.

The current list state is recorded in a new file called "meta.ini" in your REACT folder. The values in this INI are eventually used to replace tokens with values when your config runs. The INI is updated any time that you update or delete an item.

====Setting Defaults====

Default tokens and their values can be set in the REACT.ini file, under the newly created '''DefaultMetaData''' section. When [[REACT]] is initially opened, or the user changes a disc, the token values are reset to these defaults. The dialogue allows you to quickly and easily amend the token values on a per disc basic, rather than having to edit the INI manually (see '[[REACT:Mods#A Basic Alternative|A Basic Alternative]]').

A simple example would be the @discnumber@ and @totaldiscs@ tokens, which are initially set to a default of '1'. If you are ripping a multi-disc album you can alter these values as required, in the knowledge that they will revert to '1' when a new disc is inserted. The article '[[REACT:Adding Support For Disc Information]]' details config changes that will use these tokens to add disc information to your files, and amend the folder structure, if @totaldiscs@ exceeds one.

====Processing Tokens====

Your additional tokens are inserted into any [[Cuesheet|cuesheets]] created using REM statements, so are available to ACDIR, and any other application that can parse [[Cuesheet|cuesheets]] with REM statements. Album-level tokens are added at the top of the [[Cuesheet|cuesheet]], with the other global values. Track-level tokens are added beneath the appropriate TRACK statement. Therefore, if you are ripping to an image, you can still use these values with any tracks you create, using ACDIR's $R{} and $r{} syntax, e.g.: $R{DISCNUMBER} and $r{COMPOSER}.

If you do not want certain tokens added to the cuesheet you can prefix the token name with an underscore, e.g.: @_disctype@. These are assumed to be temporary, or processing, tokens, used purely for conditionally executing sections of your config.

====Track-Level Tokens====

Most tokens are album-related. If you want to set track-level tokens you should use the format '''<token name>[<track number>]''', e.g.: '''composer[1]''' to set the composer token value for track one. Your config should refer to the token only by name, e.g.: @composer@. When processing track one, @composer@ will be replaced by the value of composer[1], when processing track two, @composer@ will be replaced by the value of composer[2], etc.

====Using The Tokens====

You can use both @ and $-style tokens in your config. When using $ tokens any integer value will be zero-padded ("4" -> "04") and any string values will be converted to a filename-friendly value, using the standard [[REACT]] character replacement. Therefore, if you create a token called '''discname''' you can use @discname@ when tagging, and $discname$ when creating a file or folder name.

===A Basic Alternative===
If you want to use additional tokens in your config but do not want to use this mod you ''can'' add additional variables to the existing '''UserTrackFormats''', '''UserOutputNames''', and, ''more pertinently'', '''UserSettings''' sections of REACT.ini. You will need to update these variables by hand in a text editor if the value required for the disc you are ripping differs from the current value set.

===Changelog===
2.0.ssb5, 03/05/07
* First public release.

2.0.ssb6, 04/05/07
* Additional Meta Data dialogue made child of EAC window.
* Changed function prefix from fGUI to fDiag to save confusion.

2.0.ssb8, 14/05/07
* Moved default values into REACT.ini.
* Fixed the code that writes track-level meta data to the cuesheet.
* Current token values now stored in "meta.ini", not "metadata.ini".
* Moved a little more code from the main source file into the include.

2.0.ssb9, 14/05/07
* Track cuesheets now supported.

2.0.ssb10, 30/05/07
* Added underscore prefix to identify temporary tokens.
* Fixed REACT issue with "%" in any field. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] )
* Fixed REACT issue with "&" in the track name when using REACT-track.cfg. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] )

2.0.ssb11, 01/07/07
* Works with new- (EAC 0.99 prebeta 1) and old-style (EAC 0.95 beta 4 and earlier) log files. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=501821 post] )
* Will only rewrite INI file on major or minor version change, not a new build.

2.0.ssb12, 02/07/07
* Log file handling now works correctly for track ripping.

2.0.ssb13, 04/07/07
* Reverted cover filename to "<album>.jpg" irrespective of EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=502330 post] )

2.0.ssb15, 17/07/07
* Reverted @albumfile@ to "<sourcedir>\<album>", irrespective of the EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=505038 post] )
* Add <code>Test=1</code> under the Settings section of REACT.ini to use Test and Copy mode.

2.0.ssb16, 29/07/07
* Fixed issues with meta data changing mid-process. meta.ini is now only updated with the GUI values immediately before a rip begins.
* Fixed bug with @ and $ values. @totaldiscs@ will now correctly return "3", while $totaldiscs$ will return "03".

2.0.ssb16b, 15/08/07
* Fixed issue with log file name when ripping a VA album to tracks ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=510414 post] ).

2.0.ssb16c, 21/08/07
* Add <code>CoverDownloaderXUI=1</CODE> to the [Settings] section of your REACT.ini when using Album Art XUI, and REACT will cope with JPEG, GIF, and PNG album art ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=511640 post] ).

2.0.ssb16d, 21/08/07
* Added BMP support to above.

2.0.ssb16e, 23/08/07
* Fixed bug with above, where the artist and album did not change with the disc.

2.0.ssb16f, 11/09/07
* Hitting Ctrl+F2 to reconfigure EAC will now ensure that the working directories used by EAC are in synch ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=515730 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=512481 post] ).

2.0.ssb16g, 17/09/07
* You can now process an existing wav/cue/log(/jpg) file-set by passing the full cuesheet path to REACT as a single parameter. This will treat the files as if they had just been created by EAC as per normal execution.

2.0.ssb16h, 17/09/07
* Set <code>CoverDownloaderLocalPath</code>, in the [Settings] section of your REACT.ini, to the path of your existing album art if you would rather chose those over any downloaded using the cover downloader. You may use $artist$ and $album$ tokens in the path, e.g.:
CoverDownloaderLocalPath=C:\Documents and Settings\My Name\My Documents\My Music\$artist$\$album$\folder.jpg

2.0.ssb16i, 12/11/07
* Fixed a bug with <code>CreateAllCuesheets</code> when detecting gaps is required ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529370 post] ).
* Reinstated <code>TracksHotVal</code>, after unwittingly removing the functionality.

2.0.ssb16j, 14/11/07
* Artist and album names are now correctly escaped in the album art command lines ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).
* Apostrophes in the log file name are now correctly replaced with a space (in track mode) ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).

2.0.ssb16k, 14/11/07
* 2.0.ssb16j was a disaster! Apostrophes no longer wrongly replaced, and double quotes now simply removed from album art command line. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=530101 post] ).
* UserOutputNames INI section no longer escaped, so you can again use Window's tokens, e.g.: %USERPROFILE% ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=530166 post] ).

===Download===
[http://www.synthetic-soul.co.uk/temp/REACT_2.0.ssb16k.zip REACT 2.0.ssb16k]

====Updated CFG files====
The zip below includes updated REACT.ini, REACT-track.cfg and REACT-image.cfg files, utilising various aspects of this mod, including (but not restricted to) support for TAK, the ampersand fix, and disc-related tags.

[http://www.synthetic-soul.co.uk/temp/REACT-cfgs_ssb16.zip REACT-cfgs_ssb16.zip]

[[Category:REACT|Mods]]

REACT:Mods

2007-11-14T20:58:09Z

Synthetic Soul: Updated to 2.0.ssb16j

==Synthetic Soul's Mod==

[[Image:React-mod.png|thumb|Screenshot demonstrating the Additional Meta Data dialogue]]

[[User:Synthetic Soul|Synthetic Soul]] maintains a mod of [[REACT|REACT 2.0]].

===Key Points===

* Additional Meta Data dialogue allows you to easily edit supplemental disc and track information.
* Track-level tokens supported.
* Additional meta data added to cuesheets, as REM statements.
* Fixes issue in REACT with '%' in any field ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] ).
* Fixes issue in REACT with '&' in the track name when using REACT-track.cfg ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] ).
* Works with new- (EAC 0.99 prebeta 1) and old-style log files.
* Will only rewrite INI file on major or minor version change, not a new build.
* Use Test & Copy by adding <code>Test=1</code> under the Settings section of REACT.ini.

===Description===

The main purpose of this mod is to allow users to easily provide additional meta data to the [[REACT]] configs. This is achieved by the introduction of an Additional Meta Data dialogue, which allows users to easily create, amend and delete additional tokens, which can be used either to set tag values (e.g.: @discnumber@) , or as variables used in conditions within the config to alter the processing path (e.g.: @_disctype@).

The dialogue is opened using '''Alt+F5'''. The new dialogue is non-modal, but will stay on top of the EAC main window; if you minimise [[EAC]] the dialogue is minimised also. If you close the dialogue it is simply hidden from view, so your list items will stay intact. Therefore, if you need to set various meta data for each disc that you are ripping, you may choose to keep the dialogue open throughout the process; however, if you only need to use it to alter values infrequently, you can leave it hidden, but know that the values are still available to your config file.

The current list state is recorded in a new file called "meta.ini" in your REACT folder. The values in this INI are eventually used to replace tokens with values when your config runs. The INI is updated any time that you update or delete an item.

====Setting Defaults====

Default tokens and their values can be set in the REACT.ini file, under the newly created '''DefaultMetaData''' section. When [[REACT]] is initially opened, or the user changes a disc, the token values are reset to these defaults. The dialogue allows you to quickly and easily amend the token values on a per disc basic, rather than having to edit the INI manually (see '[[REACT:Mods#A Basic Alternative|A Basic Alternative]]').

A simple example would be the @discnumber@ and @totaldiscs@ tokens, which are initially set to a default of '1'. If you are ripping a multi-disc album you can alter these values as required, in the knowledge that they will revert to '1' when a new disc is inserted. The article '[[REACT:Adding Support For Disc Information]]' details config changes that will use these tokens to add disc information to your files, and amend the folder structure, if @totaldiscs@ exceeds one.

====Processing Tokens====

Your additional tokens are inserted into any [[Cuesheet|cuesheets]] created using REM statements, so are available to ACDIR, and any other application that can parse [[Cuesheet|cuesheets]] with REM statements. Album-level tokens are added at the top of the [[Cuesheet|cuesheet]], with the other global values. Track-level tokens are added beneath the appropriate TRACK statement. Therefore, if you are ripping to an image, you can still use these values with any tracks you create, using ACDIR's $R{} and $r{} syntax, e.g.: $R{DISCNUMBER} and $r{COMPOSER}.

If you do not want certain tokens added to the cuesheet you can prefix the token name with an underscore, e.g.: @_disctype@. These are assumed to be temporary, or processing, tokens, used purely for conditionally executing sections of your config.

====Track-Level Tokens====

Most tokens are album-related. If you want to set track-level tokens you should use the format '''<token name>[<track number>]''', e.g.: '''composer[1]''' to set the composer token value for track one. Your config should refer to the token only by name, e.g.: @composer@. When processing track one, @composer@ will be replaced by the value of composer[1], when processing track two, @composer@ will be replaced by the value of composer[2], etc.

====Using The Tokens====

You can use both @ and $-style tokens in your config. When using $ tokens any integer value will be zero-padded ("4" -> "04") and any string values will be converted to a filename-friendly value, using the standard [[REACT]] character replacement. Therefore, if you create a token called '''discname''' you can use @discname@ when tagging, and $discname$ when creating a file or folder name.

===A Basic Alternative===
If you want to use additional tokens in your config but do not want to use this mod you ''can'' add additional variables to the existing '''UserTrackFormats''', '''UserOutputNames''', and, ''more pertinently'', '''UserSettings''' sections of REACT.ini. You will need to update these variables by hand in a text editor if the value required for the disc you are ripping differs from the current value set.

===Changelog===
2.0.ssb5, 03/05/07
* First public release.

2.0.ssb6, 04/05/07
* Additional Meta Data dialogue made child of EAC window.
* Changed function prefix from fGUI to fDiag to save confusion.

2.0.ssb8, 14/05/07
* Moved default values into REACT.ini.
* Fixed the code that writes track-level meta data to the cuesheet.
* Current token values now stored in "meta.ini", not "metadata.ini".
* Moved a little more code from the main source file into the include.

2.0.ssb9, 14/05/07
* Track cuesheets now supported.

2.0.ssb10, 30/05/07
* Added underscore prefix to identify temporary tokens.
* Fixed REACT issue with "%" in any field. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] )
* Fixed REACT issue with "&" in the track name when using REACT-track.cfg. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] )

2.0.ssb11, 01/07/07
* Works with new- (EAC 0.99 prebeta 1) and old-style (EAC 0.95 beta 4 and earlier) log files. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=501821 post] )
* Will only rewrite INI file on major or minor version change, not a new build.

2.0.ssb12, 02/07/07
* Log file handling now works correctly for track ripping.

2.0.ssb13, 04/07/07
* Reverted cover filename to "<album>.jpg" irrespective of EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=502330 post] )

2.0.ssb15, 17/07/07
* Reverted @albumfile@ to "<sourcedir>\<album>", irrespective of the EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=505038 post] )
* Add <code>Test=1</code> under the Settings section of REACT.ini to use Test and Copy mode.

2.0.ssb16, 29/07/07
* Fixed issues with meta data changing mid-process. meta.ini is now only updated with the GUI values immediately before a rip begins.
* Fixed bug with @ and $ values. @totaldiscs@ will now correctly return "3", while $totaldiscs$ will return "03".

2.0.ssb16b, 15/08/07
* Fixed issue with log file name when ripping a VA album to tracks ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=510414 post] ).

2.0.ssb16c, 21/08/07
* Add <code>CoverDownloaderXUI=1</CODE> to the [Settings] section of your REACT.ini when using Album Art XUI, and REACT will cope with JPEG, GIF, and PNG album art ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=511640 post] ).

2.0.ssb16d, 21/08/07
* Added BMP support to above.

2.0.ssb16e, 23/08/07
* Fixed bug with above, where the artist and album did not change with the disc.

2.0.ssb16f, 11/09/07
* Hitting Ctrl+F2 to reconfigure EAC will now ensure that the working directories used by EAC are in synch ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=515730 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=512481 post] ).

2.0.ssb16g, 17/09/07
* You can now process an existing wav/cue/log(/jpg) file-set by passing the full cuesheet path to REACT as a single parameter. This will treat the files as if they had just been created by EAC as per normal execution.

2.0.ssb16h, 17/09/07
* Set <code>CoverDownloaderLocalPath</code>, in the [Settings] section of your REACT.ini, to the path of your existing album art if you would rather chose those over any downloaded using the cover downloader. You may use $artist$ and $album$ tokens in the path, e.g.:
CoverDownloaderLocalPath=C:\Documents and Settings\My Name\My Documents\My Music\$artist$\$album$\folder.jpg

2.0.ssb16i, 12/11/07
* Fixed a bug with <code>CreateAllCuesheets</code> when detecting gaps is required ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529370 post] ).
* Reinstated <code>TracksHotVal</code>, after unwittingly removing the functionality.

2.0.ssb16j, 14/11/07
* Artist and album names are now correctly escaped in the album art command lines ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).
* Apostrophes in the log file name are now correctly replaced with a space (in track mode) ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529854 post] ).

===Download===
[http://www.synthetic-soul.co.uk/temp/REACT_2.0.ssb16j.zip REACT 2.0.ssb16j]

====Updated CFG files====
The zip below includes updated REACT.ini, REACT-track.cfg and REACT-image.cfg files, utilising various aspects of this mod, including (but not restricted to) support for TAK, the ampersand fix, and disc-related tags.

[http://www.synthetic-soul.co.uk/temp/REACT-cfgs_ssb16.zip REACT-cfgs_ssb16.zip]

[[Category:REACT|Mods]]

REACT:Mods

2007-11-12T10:10:16Z

Synthetic Soul: Formatting

==Synthetic Soul's Mod==

[[Image:React-mod.png|thumb|Screenshot demonstrating the Additional Meta Data dialogue]]

[[User:Synthetic Soul|Synthetic Soul]] maintains a mod of [[REACT|REACT 2.0]].

===Key Points===

* Additional Meta Data dialogue allows you to easily edit supplemental disc and track information.
* Track-level tokens supported.
* Additional meta data added to cuesheets, as REM statements.
* Fixes issue in REACT with '%' in any field ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] ).
* Fixes issue in REACT with '&' in the track name when using REACT-track.cfg ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] ).
* Works with new- (EAC 0.99 prebeta 1) and old-style log files.
* Will only rewrite INI file on major or minor version change, not a new build.
* Use Test & Copy by adding <code>Test=1</code> under the Settings section of REACT.ini.

===Description===

The main purpose of this mod is to allow users to easily provide additional meta data to the [[REACT]] configs. This is achieved by the introduction of an Additional Meta Data dialogue, which allows users to easily create, amend and delete additional tokens, which can be used either to set tag values (e.g.: @discnumber@) , or as variables used in conditions within the config to alter the processing path (e.g.: @_disctype@).

The dialogue is opened using '''Alt+F5'''. The new dialogue is non-modal, but will stay on top of the EAC main window; if you minimise [[EAC]] the dialogue is minimised also. If you close the dialogue it is simply hidden from view, so your list items will stay intact. Therefore, if you need to set various meta data for each disc that you are ripping, you may choose to keep the dialogue open throughout the process; however, if you only need to use it to alter values infrequently, you can leave it hidden, but know that the values are still available to your config file.

The current list state is recorded in a new file called "meta.ini" in your REACT folder. The values in this INI are eventually used to replace tokens with values when your config runs. The INI is updated any time that you update or delete an item.

====Setting Defaults====

Default tokens and their values can be set in the REACT.ini file, under the newly created '''DefaultMetaData''' section. When [[REACT]] is initially opened, or the user changes a disc, the token values are reset to these defaults. The dialogue allows you to quickly and easily amend the token values on a per disc basic, rather than having to edit the INI manually (see '[[REACT:Mods#A Basic Alternative|A Basic Alternative]]').

A simple example would be the @discnumber@ and @totaldiscs@ tokens, which are initially set to a default of '1'. If you are ripping a multi-disc album you can alter these values as required, in the knowledge that they will revert to '1' when a new disc is inserted. The article '[[REACT:Adding Support For Disc Information]]' details config changes that will use these tokens to add disc information to your files, and amend the folder structure, if @totaldiscs@ exceeds one.

====Processing Tokens====

Your additional tokens are inserted into any [[Cuesheet|cuesheets]] created using REM statements, so are available to ACDIR, and any other application that can parse [[Cuesheet|cuesheets]] with REM statements. Album-level tokens are added at the top of the [[Cuesheet|cuesheet]], with the other global values. Track-level tokens are added beneath the appropriate TRACK statement. Therefore, if you are ripping to an image, you can still use these values with any tracks you create, using ACDIR's $R{} and $r{} syntax, e.g.: $R{DISCNUMBER} and $r{COMPOSER}.

If you do not want certain tokens added to the cuesheet you can prefix the token name with an underscore, e.g.: @_disctype@. These are assumed to be temporary, or processing, tokens, used purely for conditionally executing sections of your config.

====Track-Level Tokens====

Most tokens are album-related. If you want to set track-level tokens you should use the format '''<token name>[<track number>]''', e.g.: '''composer[1]''' to set the composer token value for track one. Your config should refer to the token only by name, e.g.: @composer@. When processing track one, @composer@ will be replaced by the value of composer[1], when processing track two, @composer@ will be replaced by the value of composer[2], etc.

====Using The Tokens====

You can use both @ and $-style tokens in your config. When using $ tokens any integer value will be zero-padded ("4" -> "04") and any string values will be converted to a filename-friendly value, using the standard [[REACT]] character replacement. Therefore, if you create a token called '''discname''' you can use @discname@ when tagging, and $discname$ when creating a file or folder name.

===A Basic Alternative===
If you want to use additional tokens in your config but do not want to use this mod you ''can'' add additional variables to the existing '''UserTrackFormats''', '''UserOutputNames''', and, ''more pertinently'', '''UserSettings''' sections of REACT.ini. You will need to update these variables by hand in a text editor if the value required for the disc you are ripping differs from the current value set.

===Changelog===
2.0.ssb5, 03/05/07
* First public release.

2.0.ssb6, 04/05/07
* Additional Meta Data dialogue made child of EAC window.
* Changed function prefix from fGUI to fDiag to save confusion.

2.0.ssb8, 14/05/07
* Moved default values into REACT.ini.
* Fixed the code that writes track-level meta data to the cuesheet.
* Current token values now stored in "meta.ini", not "metadata.ini".
* Moved a little more code from the main source file into the include.

2.0.ssb9, 14/05/07
* Track cuesheets now supported.

2.0.ssb10, 30/05/07
* Added underscore prefix to identify temporary tokens.
* Fixed REACT issue with "%" in any field. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] )
* Fixed REACT issue with "&" in the track name when using REACT-track.cfg. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] )

2.0.ssb11, 01/07/07
* Works with new- (EAC 0.99 prebeta 1) and old-style (EAC 0.95 beta 4 and earlier) log files. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=501821 post] )
* Will only rewrite INI file on major or minor version change, not a new build.

2.0.ssb12, 02/07/07
* Log file handling now works correctly for track ripping.

2.0.ssb13, 04/07/07
* Reverted cover filename to "<album>.jpg" irrespective of EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=502330 post] )

2.0.ssb15, 17/07/07
* Reverted @albumfile@ to "<sourcedir>\<album>", irrespective of the EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=505038 post] )
* Add <code>Test=1</code> under the Settings section of REACT.ini to use Test and Copy mode.

2.0.ssb16, 29/07/07
* Fixed issues with meta data changing mid-process. meta.ini is now only updated with the GUI values immediately before a rip begins.
* Fixed bug with @ and $ values. @totaldiscs@ will now correctly return "3", while $totaldiscs$ will return "03".

2.0.ssb16b, 15/08/07
* Fixed issue with log file name when ripping a VA album to tracks ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=510414 post] ).

2.0.ssb16c, 21/08/07
* Add <code>CoverDownloaderXUI=1</CODE> to the [Settings] section of your REACT.ini when using Album Art XUI, and REACT will cope with JPEG, GIF, and PNG album art ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=511640 post] ).

2.0.ssb16d, 21/08/07
* Added BMP support to above.

2.0.ssb16e, 23/08/07
* Fixed bug with above, where the artist and album did not change with the disc.

2.0.ssb16f, 11/09/07
* Hitting Ctrl+F2 to reconfigure EAC will now ensure that the working directories used by EAC are in synch ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=515730 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=512481 post] ).

2.0.ssb16g, 17/09/07
* You can now process an existing wav/cue/log(/jpg) file-set by passing the full cuesheet path to REACT as a single parameter. This will treat the files as if they had just been created by EAC as per normal execution.

2.0.ssb16h, 17/09/07
* Set <code>CoverDownloaderLocalPath</code>, in the [Settings] section of your REACT.ini, to the path of your existing album art if you would rather chose those over any downloaded using the cover downloader. You may use $artist$ and $album$ tokens in the path, e.g.:
CoverDownloaderLocalPath=C:\Documents and Settings\My Name\My Documents\My Music\$artist$\$album$\folder.jpg

2.0.ssb16i, 12/11/07
* Fixed a bug with <code>CreateAllCuesheets</code> when detecting gaps is required ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529370 post] ).
* Reinstated <code>TracksHotVal</code>, after unwittingly removing the functionality.

===Download===
[http://www.synthetic-soul.co.uk/temp/REACT_2.0.ssb16i.zip REACT 2.0.ssb16i]

====Updated CFG files====
The zip below includes updated REACT.ini, REACT-track.cfg and REACT-image.cfg files, utilising various aspects of this mod, including (but not restricted to) support for TAK, the ampersand fix, and disc-related tags.

[http://www.synthetic-soul.co.uk/temp/REACT-cfgs_ssb16.zip REACT-cfgs_ssb16.zip]

[[Category:REACT|Mods]]

REACT:Mods

2007-11-12T10:09:16Z

Synthetic Soul: Updated to 2.0.ssb16i

==Synthetic Soul's Mod==

[[Image:React-mod.png|thumb|Screenshot demonstrating the Additional Meta Data dialogue]]

[[User:Synthetic Soul|Synthetic Soul]] maintains a mod of [[REACT|REACT 2.0]].

===Key Points===

* Additional Meta Data dialogue allows you to easily edit supplemental disc and track information.
* Track-level tokens supported.
* Additional meta data added to cuesheets, as REM statements.
* Fixes issue in REACT with '%' in any field ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] ).
* Fixes issue in REACT with '&' in the track name when using REACT-track.cfg ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] ).
* Works with new- (EAC 0.99 prebeta 1) and old-style log files.
* Will only rewrite INI file on major or minor version change, not a new build.
* Use Test & Copy by adding <code>Test=1</code> under the Settings section of REACT.ini.

===Description===

The main purpose of this mod is to allow users to easily provide additional meta data to the [[REACT]] configs. This is achieved by the introduction of an Additional Meta Data dialogue, which allows users to easily create, amend and delete additional tokens, which can be used either to set tag values (e.g.: @discnumber@) , or as variables used in conditions within the config to alter the processing path (e.g.: @_disctype@).

The dialogue is opened using '''Alt+F5'''. The new dialogue is non-modal, but will stay on top of the EAC main window; if you minimise [[EAC]] the dialogue is minimised also. If you close the dialogue it is simply hidden from view, so your list items will stay intact. Therefore, if you need to set various meta data for each disc that you are ripping, you may choose to keep the dialogue open throughout the process; however, if you only need to use it to alter values infrequently, you can leave it hidden, but know that the values are still available to your config file.

The current list state is recorded in a new file called "meta.ini" in your REACT folder. The values in this INI are eventually used to replace tokens with values when your config runs. The INI is updated any time that you update or delete an item.

====Setting Defaults====

Default tokens and their values can be set in the REACT.ini file, under the newly created '''DefaultMetaData''' section. When [[REACT]] is initially opened, or the user changes a disc, the token values are reset to these defaults. The dialogue allows you to quickly and easily amend the token values on a per disc basic, rather than having to edit the INI manually (see '[[REACT:Mods#A Basic Alternative|A Basic Alternative]]').

A simple example would be the @discnumber@ and @totaldiscs@ tokens, which are initially set to a default of '1'. If you are ripping a multi-disc album you can alter these values as required, in the knowledge that they will revert to '1' when a new disc is inserted. The article '[[REACT:Adding Support For Disc Information]]' details config changes that will use these tokens to add disc information to your files, and amend the folder structure, if @totaldiscs@ exceeds one.

====Processing Tokens====

Your additional tokens are inserted into any [[Cuesheet|cuesheets]] created using REM statements, so are available to ACDIR, and any other application that can parse [[Cuesheet|cuesheets]] with REM statements. Album-level tokens are added at the top of the [[Cuesheet|cuesheet]], with the other global values. Track-level tokens are added beneath the appropriate TRACK statement. Therefore, if you are ripping to an image, you can still use these values with any tracks you create, using ACDIR's $R{} and $r{} syntax, e.g.: $R{DISCNUMBER} and $r{COMPOSER}.

If you do not want certain tokens added to the cuesheet you can prefix the token name with an underscore, e.g.: @_disctype@. These are assumed to be temporary, or processing, tokens, used purely for conditionally executing sections of your config.

====Track-Level Tokens====

Most tokens are album-related. If you want to set track-level tokens you should use the format '''<token name>[<track number>]''', e.g.: '''composer[1]''' to set the composer token value for track one. Your config should refer to the token only by name, e.g.: @composer@. When processing track one, @composer@ will be replaced by the value of composer[1], when processing track two, @composer@ will be replaced by the value of composer[2], etc.

====Using The Tokens====

You can use both @ and $-style tokens in your config. When using $ tokens any integer value will be zero-padded ("4" -> "04") and any string values will be converted to a filename-friendly value, using the standard [[REACT]] character replacement. Therefore, if you create a token called '''discname''' you can use @discname@ when tagging, and $discname$ when creating a file or folder name.

===A Basic Alternative===
If you want to use additional tokens in your config but do not want to use this mod you ''can'' add additional variables to the existing '''UserTrackFormats''', '''UserOutputNames''', and, ''more pertinently'', '''UserSettings''' sections of REACT.ini. You will need to update these variables by hand in a text editor if the value required for the disc you are ripping differs from the current value set.

===Changelog===
2.0.ssb5, 03/05/07
* First public release.

2.0.ssb6, 04/05/07
* Additional Meta Data dialogue made child of EAC window.
* Changed function prefix from fGUI to fDiag to save confusion.

2.0.ssb8, 14/05/07
* Moved default values into REACT.ini.
* Fixed the code that writes track-level meta data to the cuesheet.
* Current token values now stored in "meta.ini", not "metadata.ini".
* Moved a little more code from the main source file into the include.

2.0.ssb9, 14/05/07
* Track cuesheets now supported.

2.0.ssb10, 30/05/07
* Added underscore prefix to identify temporary tokens.
* Fixed REACT issue with "%" in any field. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] )
* Fixed REACT issue with "&" in the track name when using REACT-track.cfg. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] )

2.0.ssb11, 01/07/07
* Works with new- (EAC 0.99 prebeta 1) and old-style (EAC 0.95 beta 4 and earlier) log files. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=501821 post] )
* Will only rewrite INI file on major or minor version change, not a new build.

2.0.ssb12, 02/07/07
* Log file handling now works correctly for track ripping.

2.0.ssb13, 04/07/07
* Reverted cover filename to "<album>.jpg" irrespective of EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=502330 post] )

2.0.ssb15, 17/07/07
* Reverted @albumfile@ to "<sourcedir>\<album>", irrespective of the EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=505038 post] )
* Add <code>Test=1</code> under the Settings section of REACT.ini to use Test and Copy mode.

2.0.ssb16, 29/07/07
* Fixed issues with meta data changing mid-process. meta.ini is now only updated with the GUI values immediately before a rip begins.
* Fixed bug with @ and $ values. @totaldiscs@ will now correctly return "3", while $totaldiscs$ will return "03".

2.0.ssb16b, 15/08/07
* Fixed issue with log file name when ripping a VA album to tracks ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=510414 post] ).

2.0.ssb16c, 21/08/07
* Add <code>CoverDownloaderXUI=1</CODE> to the [Settings] section of your REACT.ini when using Album Art XUI, and REACT will cope with JPEG, GIF, and PNG album art ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=511640 post] ).

2.0.ssb16d, 21/08/07
* Added BMP support to above.

2.0.ssb16e, 23/08/07
* Fixed bug with above, where the artist and album did not change with the disc.

2.0.ssb16f, 11/09/07
* Hitting Ctrl+F2 to reconfigure EAC will now ensure that the working directories used by EAC are in synch ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=515730 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=512481 post] ).

2.0.ssb16g, 17/09/07
* You can now process an existing wav/cue/log(/jpg) file-set by passing the full cuesheet path to REACT as a single parameter. This will treat the files as if they had just been created by EAC as per normal execution.

2.0.ssb16h, 17/09/07
* Set <code>CoverDownloaderLocalPath</code>, in the [Settings] section of your REACT.ini, to the path of your existing album art if you would rather chose those over any downloaded using the cover downloader. You may use $artist$ and $album$ tokens in the path, e.g.:
CoverDownloaderLocalPath=C:\Documents and Settings\My Name\My Documents\My Music\$artist$\$album$\folder.jpg

2.0.ssb16i, 12/11/07
* Fixed a bug with CreateAllCuesheets when detecting gaps is required ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=529370 post] ).
* Reinstated TracksHotVal, after unwittingly removing the functionality.

===Download===
[http://www.synthetic-soul.co.uk/temp/REACT_2.0.ssb16i.zip REACT 2.0.ssb16h]

====Updated CFG files====
The zip below includes updated REACT.ini, REACT-track.cfg and REACT-image.cfg files, utilising various aspects of this mod, including (but not restricted to) support for TAK, the ampersand fix, and disc-related tags.

[http://www.synthetic-soul.co.uk/temp/REACT-cfgs_ssb16.zip REACT-cfgs_ssb16.zip]

[[Category:REACT|Mods]]

Lossless comparison

2007-09-19T14:18:16Z

Synthetic Soul: /* Other lossless compressions comparisons */ Updated my timestamp

The '''lossless comparison page''' aims to gather information about lossless codecs available so users can make an informed decision as to what lossless codec to choose for their needs.

== Introduction ==
Given the enormous amount of [[lossless]] audio compressor choices available, it is a very difficult task to choose the one most suited for each person's needs.

Several people only take into consideration compression performance when choosing a codec. But as the following table and article shows, there are several other features worth taking into consideration when making that choice.

For example, users wanting good multiplatform compatibility and robustness (E.G, people sharing live recordings) would favour [[WavPack]] or [[FLAC]]. Another user, looking for the very highest compression available, would go with [[OptimFROG]]. Someone wanting portable support would use [[FLAC]] or [[ALAC]], and so on.

En fin, this is not a matter worth getting too worked up about. If you later find out the codec you chose isn't the best for your needs, you can just transcompress to another format, without risk of losing quality.

'''Note:''' for latest comparison of lossless compression, scroll down to the [[Lossless comparison#External links|Links section of this page]].

== Comparison Table ==


{| cellspacing="2" style="text-align:center; border:1px solid blue;"
|width="120px"|'''Features'''
| width="95px" style="background: #00FFFF" | WavPack
| width="95px" style="background: #00FFFF" | ALAC
| width="95px" style="background: #00FFFF" | FLAC
| width="95px" style="background: #00FFFF" | Monkey's
| width="95px" style="background: #00FFFF" | OptimFROG
| width="95px" style="background: #00FFFF" | Shorten
|-
|align="left" style="background: #FFFF99" | Encoding speed
| style="background: #00FF00" | very fast
| style="background: #FFFFFF" | average
| style="background: #CCFFCC" | fast
| style="background: #CCFFCC" | fast
| style="background: #FF9900" | slow
| style="background: #00FF00" | very fast
|-
|align="left" style="background: #FFFF99" | Decoding speed
| style="background: #00FF00" | very fast
| style="background: #CCFFCC" | fast
| style="background: #00FF00" | very fast
| style="background: #FFFFFF" | average
| style="background: #FFFFFF" | average
| style="background: #00FF00" | very fast
|-
|align="left" style="background: #FFFF99" | Compression*
| style="background: #CCFFCC" | 58.0%
| style="background: #CCFFCC" | 58.50%
| style="background: #CCFFCC" | 58.70%
| style="background: #00FF00" | 55.50%
| style="background: #00FF00" | 54.70%
| style="background: #FF9900" | 63.50%
|-
|align="left" style="background: #FFFF99" | Flexibility**
| style="background: #00FF00" | very good
| style="background: #FF9900" | bad
| style="background: #00FF00" | very good
| style="background: #00FF00" | very good
| style="background: #00FF00" | very good
| style="background: #FF9900" | bad
|-
|style="background: #FFFFFF" |  
|-
|align="left" style="background: #FFFF99" | Error handling
| style="background: #00FF00" | yes
| style="background: #FFFFFF" |  
| style="background: #00FF00" | yes
| style="background: #FF9900" | no
| style="background: #00FF00" | yes
| style="background: #FF9900" | no
|-
|align="left" style="background: #FFFF99" | Seeking
| style="background: #00FF00" | yes
| style="background: #00FF00" | yes
| style="background: #00FF00" | yes
| style="background: #00FF00" | yes
| style="background: #00FF00" | yes
| style="background: #00FF00" | yes
|-|
|! align="left" style="background: #FFFF99" | Tagging ||! style="background: #00FF00" | ID3/APE ||! style="background: #00FF00" | QT tags ||! style="background: #00FF00" | Vorbis tags ||! style="background: #00FF00" | ID3/APE ||! style="background: #00FF00" | ID3/APE ||! style="background: #FF9900" | no
|-|
| align="left" style="background: #FFFF99" | Hardware support
| style="background: #FF9900" | limited
| style="background: #CCFFCC" | good
| style="background: #00FF00" | very good
| style="background: #FF9900" | limited
| style="background: #FF9900" | no
| style="background: #FF9900" | limited
|-|
|! align="left" style="background: #FFFF99" | Software support ||! style="background: #CCFFCC" | good ||! style="background: #FF9900" | bad ||! style="background: #00FF00" | very good ||! style="background: #CCFFCC" | good ||! style="background: #FFFFFF" | average ||! style="background: #00FF00" | very good
|-|
|! align="left" style="background: #FFFF99" | Hybrid/lossy ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no ||! style="background: #FF9900" | no ||! style="background: #FF9900" | no ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no
|-|
|! align="left" style="background: #FFFF99" | Replay Gain ||! style="background: #00FF00" | yes ||! style="background: #FFFFFF" | sort of ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no
|-|
|! align="left" style="background: #FFFF99" | RIFF chunks ||! style="background: #00FF00" | yes ||! style="background: #FFFFFF" |   ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes
|-|
|! align="left" style="background: #FFFF99" | Streaming ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no
|-|
|! align="left" style="background: #FFFF99" | Pipe support ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes
|-|
|! align="left" style="background: #FFFF99" | Open source ||! style="background: #00FF00" | yes ||! style="background: #CCFFCC" | Yes (decoding) ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no ||! style="background: #00FF00" | yes
|-|
|! align="left" style="background: #FFFF99" | Multichannel ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no ||! style="background: #FF9900" | no ||! style="background: #FF9900" | no
|-|
|! align="left" style="background: #FFFF99" | High resolution ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no
|-|
|! align="left" style="background: #FFFF99" | OS support ||! style="background: #00FF00" | All ||! style="background: #CCFFCC" | Win/Mac ||! style="background: #00FF00" | All ||! style="background: #00FF00" | All ||! style="background: #00FF00" | Win/Mac/Linux ||! style="background: #00FF00" | All
|}

''(table continued below)''

{| cellspacing="2" style="text-align:center; border:1px solid blue;"
|width="120px"|'''Features'''
| width="95px" style="background: #00FFFF" | WMA
| width="95px" style="background: #00FFFF" | LA
| width="95px" style="background: #00FFFF" | TTA
| width="95px" style="background: #00FFFF" | LPAC
| width="95px" style="background: #00FFFF" | MPEG-4 ALS
| width="95px" style="background: #00FFFF" | MPEG-4 SLS
| width="95px" style="background: #00FFFF" | Real Lossless
|-
|! align="left" style="background: #FFFF99" | Encoding speed ||! style="background: #FFFFFF" | average ||! style="background: #FF9900" | slow ||! style="background: #00FF00" | very fast ||! style="background: #FFFFFF" | average ||! style="background: #FFFFFF" | average ||! style="background: #FF9900" | slow ||! style="background: #FF9900" | slow
|-|
|! align="left" style="background: #FFFF99" | Decoding speed ||! style="background: #FFFFFF" | average ||! style="background: #FF9900" | slow ||! style="background: #CCFFCC" | fast ||! style="background: #CCFFCC" | fast ||! style="background: #CCFFCC" | fast ||! style="background: #FF9900" | slow ||! style="background: #CCFFCC" | fast
|-|
|! align="left" style="background: #FFFF99" | Compression* ||! style="background: #00FF00" | 56.30% ||! style="background: #00FF00" | 53.50% ||! style="background: #CCFFCC" | 57.10% ||! style="background: #CCFFCC" | 57.20% ||! style="background: #CCFFCC" | 57.10% ||! style="background: #CCFFCC" | ? ||! style="background: #CCFFCC" | 57.0%
|-|
|! align="left" style="background: #FFFF99" | Flexibility** ||! style="background: #FF9900" | bad ||! style="background: #FFFFFF" | average ||! style="background: #FF9900" | bad ||! style="background: #FF9900" | bad ||! style="background: #00FF00" | very good ||! style="background: #FF9900" | bad ||! style="background: #FF9900" | bad
|-
|! style="background: #FFFFFF" |  
|-
|! align="left" style="background: #FFFF99" | Error handling ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #FFFFFF" |  
|-|
|! align="left" style="background: #FFFF99" | Seeking ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | slow ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes
|-|
|! align="left" style="background: #FFFF99" | Tagging ||! style="background: #CCFFCC" | Proprietary ||! style="background: #CCFFCC" | ID3v1 ||! style="background: #CCFFCC" | ID3 ||! style="background: #FF9900" | no ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #CCFFCC" | Proprietary
|-|
| align="left" style="background: #FFFF99" | Hardware support
| style="background: #FF9900" | limited
| style="background: #FF9900" | no
| style="background: #FF9900" | limited
| style="background: #FF9900" | no
| style="background: #FF9900" | no
| style="background: #FF9900" | no
| style="background: #FF9900" | no
|-|
|! align="left" style="background: #FFFF99" | Software support ||! style="background: #CCFFCC" | good ||! style="background: #FF9900" | bad ||! style="background: #FFFFFF" | average ||! style="background: #FFFFFF" | average ||! style="background: #FF9900" | bad ||! style="background: #FF9900" | bad ||! style="background: #FF9900" | bad
|-|
|! align="left" style="background: #FFFF99" | Hybrid/lossy ||! style="background: #FF9900" | no ||! style="background: #FF9900" | no ||! style="background: #FF9900" | no ||! style="background: #FF9900" | no ||! style="background: #FF9900" | no ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no
|-|
|! align="left" style="background: #FFFF99" | Replay Gain ||! style="background: #FF9900" | no ||! style="background: #FF9900" | no ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no
|-|
|! align="left" style="background: #FFFF99" | RIFF chunks ||! style="background: #FF9900" | no ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no ||! style="background: #00FF00" | yes ||! style="background: #FFFFFF" |   ||! style="background: #FFFFFF" |   ||! style="background: #FFFFFF" |  
|-|
|! align="left" style="background: #FFFF99" | Streaming ||! style="background: #00FF00" | yes ||! style="background: #FFFFFF" |   ||! style="background: #FF9900" | no ||! style="background: #FF9900" | no ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes
|-|
|! align="left" style="background: #FFFF99" | Pipe support ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no ||! style="background: #FFFFFF" |   ||! style="background: #FFFFFF" |   ||! style="background: #FFFFFF" |   ||! style="background: #FF9900" | no
|-|
|! align="left" style="background: #FFFF99" | Open source ||! style="background: #FF9900" | no ||! style="background: #FF9900" | no ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no
|-|
|! align="left" style="background: #FFFF99" | Multichannel ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no
|-|
|! align="left" style="background: #FFFF99" | High resolution ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #00FF00" | yes ||! style="background: #FF9900" | no
|-|
|! align="left" style="background: #FFFF99" | OS support ||! style="background: #CCFFCC" | Win/Mac ||! style="background: #CCFFCC" | Win/Linux ||! style="background: #00FF00" | All ||! style="background: #CCFFCC" | Win/Linux/Sol ||! style="background: #00FF00" | All ||! style="background: #00FF00" | All ||! style="background: #00FF00" | Win/Mac/Linux
|}

<nowiki>*</nowiki> The Compression ratio is calculated with the division of compressed size by uncompressed size * 100. So, lower is better.

Encoding speed, Decoding speed and Compression ratio are based on each encoder's default settings.

<nowiki>**</nowiki> Flexibility refers to the amount of encoding choices offered to the users (Fast/low compression, Slow/high compression and everything inbetween)

These are the most popular lossless codecs, in alphabetical order:

== Apple Lossless Audio Codec (ALAC) ==
http://www.apple.com/itunes/import.html

[[ALAC]] is a codec developed by Apple for usage in [[Apple iPod|iPod]] and AirPort Express.

=== ALAC pros ===
* Very fast decoding
* [[Open source]] ([http://craz.net/programs/itunes/alac.html decoding only])
* Hardware support ([[Apple iPod|iPod]], AirPort Express)
* Streaming support
* Tagging support (QT tags)
* Excellent hardware-software-lossy format integration with [[iTunes]]/iPod.
* Supports [[multichannel]] audio and [[high resolution]]s

=== ALAC cons ===
* Closed source (encoding)
* Limited software support
* Compression efficiency not on par with other lossless codecs
* No hybrid/lossy mode

=== ALAC Other features ===
* Fits in the [[MP4]] container
* Can be used with the AirPort Express gadget

== Free Lossless Audio Codec (FLAC) ==
http://flac.sourceforge.net/

[[FLAC]] is a lossless codec developed by Josh Coalson. It's part of the Xiph multimedia portfolio, along with [[Ogg]], [[Vorbis]], [[Speex]] and [[Theora]].

=== FLAC pros ===
* [[Open source]]
* Very fast decoding
* Fast encoding
* Hardware support ([[Rio Karma|Karma]], Phatbox, etc.)
* Very good software support
* Error robustness
* Streaming support
* Supports [[multichannel]] audio and [[high resolution]]s
* Tagging support (FLAC tags)
* Supports [[RIFF]] chunks
* Pipe support
* [[Replay Gain]] compatible

=== FLAC cons ===
* No hybrid/lossy mode

=== FLAC Other features ===
* Supports embedded CUE sheets (with [http://flac.sourceforge.net/faq.html#general__no_cuesheet_tags limitations])
* Includes MD5 hashes for quick integrity checking
* Fits the [[Ogg]] and [[Matroska]] containers

== LosslessAudio (LA) ==
http://www.lossless-audio.com/

[[LA]] is a lossless codec developed by Michael Bevin.

=== LA pros ===
* Very high compression
* Tagging support ([[ID3v1]])
* Supports [[RIFF]] chunks
* Pipe support

=== LA cons ===
* Closed source
* Very slow encoding and decoding
* Doesn't support [[multichannel]] audio and [[high resolution]]s
* No hardware support
* No hybrid/lossy mode
* Bad software support
* Doesn't support [[Replay Gain]]

'''''It's important to mention that the LA foobar plugin is buggy and doesn't produce lossless streams!'''''

== Lossless Predictive Audio Coder (LPAC) ==
http://www.nue.tu-berlin.de/wer/liebchen/lpac.html

[[Lossless Predictive Audio Coder]] (LPAC) is a lossless codec developed by Tilman Liebchen. Development of it has been halted in favour of development of [[MPEG-4]] ALS.

=== LPAC pros ===
* Reasonable compression ratios
* [[High resolution]] audio support
* Supports [[RIFF]] chunks

=== LPAC cons ===
* Closed source
* No error robustness
* Slow seeking
* No tagging
* No [[multichannel]] support
* No hybrid/lossy mode
* No hardware support
* Doesn't support [[Replay Gain]]

== Monkey's Audio (APE) ==
http://www.monkeysaudio.com/

[[Monkey's Audio]] is a very efficient lossless compressor developed by Matt Ashland.

=== APE pros ===
* [[Open source]]
* High efficiency
* Good software support
* Simple and user friendly. Official GUI provided.
* Java version (multiplatform)
* Tagging support ([[ID3v1]], [[APE tags]])
* [[High resolution]] audio support
* Supports [[RIFF]] chunks (only in the GUI encoder)
* Pipe support (only in a [http://www.etree.org/shnutils/shntool/ special] version)

=== APE cons ===
* No [[multichannel]] support
* No error robustness
* No hybrid/lossy mode
* Limited hardware support ([http://www.engadget.com/2006/08/17/gemei-x-21-offers-ape-support/ Gemei X21])
* Doesn't support [[Replay Gain]]

=== APE Other features ===
* Includes MD5 hashes for quick integrity checking
* Supports APL image link files (similar to CUE sheets)

== MPEG-4 SLS ==
MPEG-4 SLS allows audio encoding from lossless scalable to [[AAC]].

=== SLS pros ===
* Transcoding to standard AAC or any higher lossy bitrate at the speed of copying a file
* Scalable decoding from lossless, to any bitrate down to the AAC core track
* Best lossless compression available when you count the AAC track (~5% gain over any other lossless compression + AAC)
* [[High resolution]] audio support
* Multi channel audio support
* [[Open source]] (MPEG-4 Reference code)
* Embedded in standard MP4 files, so supports same tagging and Replay Gain features as AAC does.

=== SLS cons ===
* No usable software available yet
* Pure lossless compression not the best there is
* Seems to be slow in encoding and decoding, but we have to wait for released software

=== SLS Other features ===
* Transform based lossless codec with optional LC AAC core track

== OptimFROG (OFR) ==
http://losslessaudiocompression.com/

[[OptimFROG]] is a lossless format developed by Florin Ghido to become the champion in audio compression.

=== OFR pros ===
* Very high compression
* Good software support
* Error robustness
* Streaming support
* Supports [[high resolution]]s
* Hybrid/lossy mode
* Tagging support ([[ID3]], [[APE tags]])
* Supports [[RIFF]] chunks
* [[Replay Gain]] compatible

=== OFR cons ===
* Closed source
* No [[multichannel]] audio support
* No hardware support
* Quite slow decoding

=== OFR Other features ===
* Supports 32bit float streams
* Includes MD5 hashes for quick integrity checking

== RealAudio Lossless (RAL) ==
http://www.realnetworks.com/products/codecs/realaudio.html

RealAudio lossless is the lossless codec developed by Real Networks for their multimedia portfolio

=== RAL pros ===
* Very fast decoding
* Streaming support
* Tagging support (proprietary)

=== RAL cons ===
* Closed source
* No [[multichannel]] and [[high resolution]] audio support
* Little software support (Real Player)
* No hardware support
* Compression efficiency not on par with other lossless codecs
* No hybrid/lossy mode
* No pipe support
* Doesn't support [[Replay Gain]]

== Shorten (SHN) ==
http://www.etree.org/shnutils/shorten/

[[Shorten]] is a very old and featureless lossless codec developed by Tony Robinson at SoftSound.

=== SHN pros ===
* [[Open source]]
* Fast decoding
* Very good software support
* Supports [[RIFF]] chunks
* Pipe support

=== SHN cons ===
* Quite inefficient
* No [[multichannel]] or [[high resolution]] audio support
* No hybrid/lossy mode
* No error robustness
* Not streamable
* No hardware support
* No native tagging
* Doesn't support [[Replay Gain]]

== True Audio (TTA) ==
http://www.true-audio.com/

[[TTA]] is a new lossless codec developed by a team of russian programmers.

=== TTA pros ===
* [[Open source]]
* Good efficiency
* Hardware support (obscure DVD player)
* Supports [[multichannel]] audio and [[high resolution]]s
* Tagging support ([[ID3]])
* [[Replay Gain]] compatible
* Error robustness

=== TTA cons ===
* No streaming support
* No hybrid/lossy mode
* Doesn't support [[RIFF]] chunks
* No pipe support

=== TTA Other features ===
* Fits the [[Matroska]] container

== WavPack (WV) ==
http://www.wavpack.com/

[[WavPack]] is a fast and featureful lossless codec developed by David Bryant.

=== WV pros ===
* [[Open source]]
* Very fast decoding
* Very fast encoding
* Good efficiency
* Error robustness
* Streaming support
* Hardware support ([http://www.rockbox.org/ RockBox])
* Supports [[multichannel]] audio and [[high resolution]]s
* Hybrid/lossy mode
* Tagging support ([[ID3v1]], [[APE tags]])
* Supports [[RIFF]] chunks
* Ability to create self extracting files for Win32 platform
* Pipe support
* Good software support
* [[Replay Gain]] compatible

=== WV cons ===
* Limited hardware player support

=== WV Other features ===
* Supports 32bit float streams
* Supports embedded CUE sheets
* Includes MD5 hashes for quick integrity checking
* Can encode in both symmetrical and assymmetrical modes.
* Fits the [[Matroska]] container

== Windows Media Audio Lossless (WMAL) ==
http://www.microsoft.com/windows/windowsmedia/9series/codecs/audio.aspx

WMA Lossless is the lossless codec developed by Microsoft to be featured in their Windows Media codec portfolio.

=== WMAL pros ===
* Streaming support
* Very good software support
* Supports [[multichannel]] audio and [[high resolution]]s.
* Tagging support (proprietary)
* Pipe support

=== WMAL cons ===
* Closed source
* No hybrid/lossy mode
* Limited hardware support ([http://en.wikipedia.org/wiki/Gigabeat Gigabeat V and S line from Toshiba])
* Doesn't support [[RIFF]] chunks
* Doesn't support [[Replay Gain]]

=== WMAL Other features ===
* Fits the [[ASF]] container

== Oddball Formats ==
There are several old lossless formats that aren't being featured in the article above. Reasons are: lack of widespread support, lack of features, bad efficiency and, most importantly, it seems noone is really interested in them.

Most of those would have disappeared by now, but they are being preserved for posterity at [[User:Rjamorim|rjamorim]]'s [http://www.rjamorim.com/rrw/ ReallyRareWares]

=== Advanced Digital Audio (ADA) ===
* http://www.rjamorim.com/rrw/ada.html

=== Bonk ===
* http://www.logarithmic.net/pfh/bonk

=== Marian's a-Pac ===
* http://www.marian.de/en/downloads#APAC
* http://www.rjamorim.com/rrw/apac.html

=== AudioZip ===
* http://www.rjamorim.com/rrw/audiozip.html

=== Dakx WAV ===
* http://www.dakx.com/
* http://www.rjamorim.com/rrw/daxwav.html

=== Entis Lab MIO ===
* http://www.entis.gr.jp/eri/frame.html
* http://www.rjamorim.com/rrw/mio.html

=== LiteWave ===
* http://www.clearjump.com/products/LiteWave.html
* http://www.rjamorim.com/rrw/litewave.html

=== Pegasus SPS ===
* http://www.krishnasoft.com/sps.htm
* http://www.rjamorim.com/rrw/pegasussps.html

=== RK Audio (RKAU) ===
* http://www.rjamorim.com/rrw/split2000.html

=== Sonarc ===
* http://www.rjamorim.com/rrw/sonarc.html

=== VocPack ===
* http://www.rjamorim.com/rrw/vocpack.html

=== WavArc ===
* http://www.rjamorim.com/rrw/wavarc.html

=== WaveZip/MUSICompress ===
* http://members.aol.com/_ht_a/sndspace/
* http://www.rjamorim.com/rrw/wavezip.html

== See also ==
* [[Lossless]]

== External links ==
=== Other lossless compressions comparisons ===
''Sorted based on last '''update''' date.''

* [http://uclc.info/LossLess.pdf Johan De Bock's speed oriented comparison] - best choices speedwise are indicated in green, mostly electronic music (last updated 2006-07-22)
* [http://web.inter.nl.net/users/hvdh/lossless/lossless.htm Hans Heijden's] -- used as reference to build the table (last updated 2006-07-07)
* [http://synthetic-soul.co.uk/comparison/lossless/ Synthetic Soul's comparison] (last update 2007-07-28)
* [http://synthetic-soul.co.uk/comparison/josef/ Josef Pohm's comparison, hosted by Synthetic Soul] (last update 2006-05-29)
* [http://www.bobulous.org.uk/misc/lossless_audio_2006.html Bobulous' lossless audio comparison] — a look at six lossless formats in terms of speed and file size (last updated 2006-05-22)
* [http://uclc.info/lossless_audio_compression_test.htm Johan De Bock's size oriented comparison] - aimed only at the maximum compression setting for each codec (based on a somewhat limited set of samples, however) (last updated 2006-05-19)
* [http://guruboolez.free.fr/lossless/ Guruboolez'] -- comparing only classical music (last updated 2005-02-27)
* [http://members.home.nl/w.speek/comparison.htm Speek's] (last updated 2005-02-07)

=== More on lossless compressions ===
* [http://losslessaudioblog.com/ The Lossless Audio Blog] - by windmiller, is a reliable and complete source of news about lossless compression.
* Go to the [http://www.hydrogenaudio.org/forums/index.php?showtopic=33226 Hydrogenaudio thread] to discuss this article.

[[Category:Guides]]

EAC and Lame

2007-09-19T12:27:08Z

Synthetic Soul: Added link to thread explaining why User Defined Encoder

===Software Needed===
* [http://exactaudiocopy.org/eac6.html Exact Audio Copy]
* [http://wiki.hydrogenaudio.org/index.php?title=Recommended_LAME Recommended LAME version]

===Installation===
'''Note:''' This guide assumes that EAC has been configured for secure ripping, if not please follow [[EAC_Drive_Configuration | this]] guide.
* Unzip the chosen LAME version into the same directory as EAC.
* If you would like to tag with APEv2 tags please download [http://www.saunalahti.fi/cse/files/wapet.zip wapet.zip] and unzip it into the '''same folder'''.

===Configuration===

* Open EAC and insert a CD into the drive.
* Click the '''EAC''' menu and select '''Compression Options'''.
* Click the '''External Compression''' Tab, and put a check box in '''Use external program for compression'''.
* Change '''Parameter passing scheme''' to '''User Defined Encoder''' (see [http://www.hydrogenaudio.org/forums/index.php?showtopic=57617 this thread] for reasoning).
* Change '''Use file extension''' to '''.mp3'''.
* Click the '''Browse''' button and locate the '''lame.exe''' that you unzipped into the EAC directory earlier.
'''Note:''' If you want to tag with APEv2 tags using Wapet please locate '''wapet.exe''', not lame.exe.
* Don't worry which bit rate is shown in the '''Bit rate''' drop down box, as this will not have any effect on the resultant MP3 file (See Note 4 at the bottom of this page).
* Don't worry about the '''Use CRC check''' setting; it won't affect the resultant MP3 file either.
* It's a good idea to tick '''Check for external programs return code'''.

* If you want to let EAC tag your files, you can safely tick '''Add ID3 tag'''; and in the '''Additional command line options''' box, copy and paste the following string:
'''-V 2 --vbr-new''' '''%s %d'''

* If you prefer not to let EAC tag your files, untick '''Add ID3 tag'''; and in the '''Additional command line options''' box, copy and paste one of the strings below, based on the tag format you prefer:

'''No Tags:'''

'''-V 2 --vbr-new''' '''%s %d'''

'''ID3v1:'''

'''-V 2 --vbr-new''' --id3v1-only --ta "%a" --tt "%t" --tg "%m" --tl "%g" --ty "%y" --tn "%n" '''%s %d'''

'''ID3v2:'''

'''-V 2 --vbr-new''' --id3v2-only --pad-id3v2 --ta "%a" --tt "%t" --tg "%m" --tl "%g" --ty "%y" --tn "%n" '''%s %d'''

'''ID3v1 and ID3v2:'''

'''-V 2 --vbr-new''' --add-id3v2 --pad-id3v2 --ta "%a" --tt "%t" --tg "%m" --tl "%g" --ty "%y" --tn "%n" '''%s %d'''

'''Automatic:'''

'''-V 2 --vbr-new''' --ta "%a" --tt "%t" --tg "%m" --tl "%g" --ty "%y" --tn "%n" '''%s %d'''
''Automatic'' means that by default only ID3v1 will be created. In case the length of at least one of the entries exceeds the permitted length of ID3v1, ID3v2 will be created in addition.

'''Note on ID3 tagging:''' Lame will exit with an error if you try to write a non-standard genre to either of the ID3 tags. If you experience this issue, either remove '''--tg "%m"''' from, or add '''--ignore-tag-errors''' to the command line; or simply allow EAC to tag since it doesn't have this problem.

'''APEv2: (This requires [http://www.saunalahti.fi/cse/files/wapet.zip wapet.exe]. Remember to browse for wapet.exe instead of lame.exe as the external encoding program.)'''

'''%d''' -t "Artist=%a" -t "Title=%t" -t "Album=%g" -t "Year=%y" -t "Track=%n" -t "Genre=%m" LAME.exe '''-V 2 --vbr-new''' '''%s %d'''

'''Note 1:''' lame.exe needs to be in the same directory as wapet.exe.

'''Note 2:''' If you wanted to change the [[LAME#Encoder_Presets| LAME preset]], the green text denotes the part that needs to be altered.

'''Note 3:''' The '''%s''' and '''%d''' at the end of each string are placeholders for EAC. '''%s''' means '''source''' filename and '''%d''' means '''destination''' filename.

'''Note 4:''' The '''%l...%l''' and '''%h...%h''' placeholders are used to add text according to whether the High quality or Low quality radio button is selected, as shown below:

'''%l--preset 128%l%h--preset standard%h''' '''%s %d'''

Therefore, if you select '''Low quality''', EAC will invoke the LAME encoder with the following command line parameters:

LAME.exe --preset 128 '''%s %d'''

..and if you select '''High quality''' EAC will invoke LAME with these command line parameters:

LAME.exe --preset standard '''%s %d'''

You can access the bitrate value in the dropdown list using the '''%r''' placeholder, For Example:

--preset %r '''%s %d'''

So, if you selected '''192 kBit/s''' in the '''Bit Rate''' drop-down list, the command line would be:

LAME.exe --preset 192 '''%s %d'''

It is a generally accepted fact that the bitrate selected in the drop-down list doesn't affect the command line. In essence this is true, as it will not affect the command line ''unless you use the %r placeholder''. However, using ABR or CBR over VBR is not recommended, and therefore you should never have to use the '''%r''' option.

<center>[[Image:EAC_LAME02.png|frame|center|LAME configured with ID3v1 tagging]]</center>

[[Category:Guides]]
[[Category:EAC Guides|LAME & EAC]]

REACT:Mods

2007-09-17T11:38:54Z

Synthetic Soul:

==Synthetic Soul's Mod==

[[Image:React-mod.png|thumb|Screenshot demonstrating the Additional Meta Data dialogue]]

[[User:Synthetic Soul|Synthetic Soul]] maintains a mod of [[REACT|REACT 2.0]].

===Key Points===

* Additional Meta Data dialogue allows you to easily edit supplemental disc and track information.
* Track-level tokens supported.
* Additional meta data added to cuesheets, as REM statements.
* Fixes issue in REACT with '%' in any field ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] ).
* Fixes issue in REACT with '&' in the track name when using REACT-track.cfg ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] ).
* Works with new- (EAC 0.99 prebeta 1) and old-style log files.
* Will only rewrite INI file on major or minor version change, not a new build.
* Use Test & Copy by adding <code>Test=1</code> under the Settings section of REACT.ini.

===Description===

The main purpose of this mod is to allow users to easily provide additional meta data to the [[REACT]] configs. This is achieved by the introduction of an Additional Meta Data dialogue, which allows users to easily create, amend and delete additional tokens, which can be used either to set tag values (e.g.: @discnumber@) , or as variables used in conditions within the config to alter the processing path (e.g.: @_disctype@).

The dialogue is opened using '''Alt+F5'''. The new dialogue is non-modal, but will stay on top of the EAC main window; if you minimise [[EAC]] the dialogue is minimised also. If you close the dialogue it is simply hidden from view, so your list items will stay intact. Therefore, if you need to set various meta data for each disc that you are ripping, you may choose to keep the dialogue open throughout the process; however, if you only need to use it to alter values infrequently, you can leave it hidden, but know that the values are still available to your config file.

The current list state is recorded in a new file called "meta.ini" in your REACT folder. The values in this INI are eventually used to replace tokens with values when your config runs. The INI is updated any time that you update or delete an item.

====Setting Defaults====

Default tokens and their values can be set in the REACT.ini file, under the newly created '''DefaultMetaData''' section. When [[REACT]] is initially opened, or the user changes a disc, the token values are reset to these defaults. The dialogue allows you to quickly and easily amend the token values on a per disc basic, rather than having to edit the INI manually (see '[[REACT:Mods#A Basic Alternative|A Basic Alternative]]').

A simple example would be the @discnumber@ and @totaldiscs@ tokens, which are initially set to a default of '1'. If you are ripping a multi-disc album you can alter these values as required, in the knowledge that they will revert to '1' when a new disc is inserted. The article '[[REACT:Adding Support For Disc Information]]' details config changes that will use these tokens to add disc information to your files, and amend the folder structure, if @totaldiscs@ exceeds one.

====Processing Tokens====

Your additional tokens are inserted into any [[Cuesheet|cuesheets]] created using REM statements, so are available to ACDIR, and any other application that can parse [[Cuesheet|cuesheets]] with REM statements. Album-level tokens are added at the top of the [[Cuesheet|cuesheet]], with the other global values. Track-level tokens are added beneath the appropriate TRACK statement. Therefore, if you are ripping to an image, you can still use these values with any tracks you create, using ACDIR's $R{} and $r{} syntax, e.g.: $R{DISCNUMBER} and $r{COMPOSER}.

If you do not want certain tokens added to the cuesheet you can prefix the token name with an underscore, e.g.: @_disctype@. These are assumed to be temporary, or processing, tokens, used purely for conditionally executing sections of your config.

====Track-Level Tokens====

Most tokens are album-related. If you want to set track-level tokens you should use the format '''<token name>[<track number>]''', e.g.: '''composer[1]''' to set the composer token value for track one. Your config should refer to the token only by name, e.g.: @composer@. When processing track one, @composer@ will be replaced by the value of composer[1], when processing track two, @composer@ will be replaced by the value of composer[2], etc.

====Using The Tokens====

You can use both @ and $-style tokens in your config. When using $ tokens any integer value will be zero-padded ("4" -> "04") and any string values will be converted to a filename-friendly value, using the standard [[REACT]] character replacement. Therefore, if you create a token called '''discname''' you can use @discname@ when tagging, and $discname$ when creating a file or folder name.

===A Basic Alternative===
If you want to use additional tokens in your config but do not want to use this mod you ''can'' add additional variables to the existing '''UserTrackFormats''', '''UserOutputNames''', and, ''more pertinently'', '''UserSettings''' sections of REACT.ini. You will need to update these variables by hand in a text editor if the value required for the disc you are ripping differs from the current value set.

===Changelog===
2.0.ssb5, 03/05/07
* First public release.

2.0.ssb6, 04/05/07
* Additional Meta Data dialogue made child of EAC window.
* Changed function prefix from fGUI to fDiag to save confusion.

2.0.ssb8, 14/05/07
* Moved default values into REACT.ini.
* Fixed the code that writes track-level meta data to the cuesheet.
* Current token values now stored in "meta.ini", not "metadata.ini".
* Moved a little more code from the main source file into the include.

2.0.ssb9, 14/05/07
* Track cuesheets now supported.

2.0.ssb10, 30/05/07
* Added underscore prefix to identify temporary tokens.
* Fixed REACT issue with "%" in any field. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] )
* Fixed REACT issue with "&" in the track name when using REACT-track.cfg. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] )

2.0.ssb11, 01/07/07
* Works with new- (EAC 0.99 prebeta 1) and old-style (EAC 0.95 beta 4 and earlier) log files. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=501821 post] )
* Will only rewrite INI file on major or minor version change, not a new build.

2.0.ssb12, 02/07/07
* Log file handling now works correctly for track ripping.

2.0.ssb13, 04/07/07
* Reverted cover filename to "<album>.jpg" irrespective of EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=502330 post] )

2.0.ssb15, 17/07/07
* Reverted @albumfile@ to "<sourcedir>\<album>", irrespective of the EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=505038 post] )
* Add <code>Test=1</code> under the Settings section of REACT.ini to use Test and Copy mode.

2.0.ssb16, 29/07/07
* Fixed issues with meta data changing mid-process. meta.ini is now only updated with the GUI values immediately before a rip begins.
* Fixed bug with @ and $ values. @totaldiscs@ will now correctly return "3", while $totaldiscs$ will return "03".

2.0.ssb16b, 15/08/07
* Fixed issue with log file name when ripping a VA album to tracks ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=510414 post] ).

2.0.ssb16c, 21/08/07
* Add <code>CoverDownloaderXUI=1</CODE> to the [Settings] section of your REACT.ini when using Album Art XUI, and REACT will cope with JPEG, GIF, and PNG album art ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=511640 post] ).

2.0.ssb16d, 21/08/07
* Added BMP support to above.

2.0.ssb16e, 23/08/07
* Fixed bug with above, where the artist and album did not change with the disc.

2.0.ssb16f, 11/09/07
* Hitting Ctrl+F2 to reconfigure EAC will now ensure that the working directories used by EAC are in synch ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=515730 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=512481 post] ).

2.0.ssb16g, 17/09/07
* You can now process an existing wav/cue/log(/jpg) file-set by passing the full cuesheet path to REACT as a single parameter. This will treat the files as if they had just been created by EAC as per normal execution.

2.0.ssb16h, 17/09/07
* Set <code>CoverDownloaderLocalPath</code>, in the [Settings] section of your REACT.ini, to the path of your existing album art if you would rather chose those over any downloaded using the cover downloader. You may use $artist$ and $album$ tokens in the path, e.g.:
CoverDownloaderLocalPath=C:\Documents and Settings\My Name\My Documents\My Music\$artist$\$album$\folder.jpg

===Download===
[http://www.synthetic-soul.co.uk/temp/REACT_2.0.ssb16h.zip REACT 2.0.ssb16h]

====Updated CFG files====
The zip below includes updated REACT.ini, REACT-track.cfg and REACT-image.cfg files, utilising various aspects of this mod, including (but not restricted to) support for TAK, the ampersand fix, and disc-related tags.

[http://www.synthetic-soul.co.uk/temp/REACT-cfgs_ssb16.zip REACT-cfgs_ssb16.zip]

[[Category:REACT|Mods]]

REACT:Mods

2007-09-17T11:36:11Z

Synthetic Soul: Updated to 2.0.ssb16h

==Synthetic Soul's Mod==

[[Image:React-mod.png|thumb|Screenshot demonstrating the Additional Meta Data dialogue]]

[[User:Synthetic Soul|Synthetic Soul]] maintains a mod of [[REACT|REACT 2.0]].

===Key Points===

* Additional Meta Data dialogue allows you to easily edit supplemental disc and track information.
* Track-level tokens supported.
* Additional meta data added to cuesheets, as REM statements.
* Fixes issue in REACT with '%' in any field ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] ).
* Fixes issue in REACT with '&' in the track name when using REACT-track.cfg ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] ).
* Works with new- (EAC 0.99 prebeta 1) and old-style log files.
* Will only rewrite INI file on major or minor version change, not a new build.
* Use Test & Copy by adding <code>Test=1</code> under the Settings section of REACT.ini.

===Description===

The main purpose of this mod is to allow users to easily provide additional meta data to the [[REACT]] configs. This is achieved by the introduction of an Additional Meta Data dialogue, which allows users to easily create, amend and delete additional tokens, which can be used either to set tag values (e.g.: @discnumber@) , or as variables used in conditions within the config to alter the processing path (e.g.: @_disctype@).

The dialogue is opened using '''Alt+F5'''. The new dialogue is non-modal, but will stay on top of the EAC main window; if you minimise [[EAC]] the dialogue is minimised also. If you close the dialogue it is simply hidden from view, so your list items will stay intact. Therefore, if you need to set various meta data for each disc that you are ripping, you may choose to keep the dialogue open throughout the process; however, if you only need to use it to alter values infrequently, you can leave it hidden, but know that the values are still available to your config file.

The current list state is recorded in a new file called "meta.ini" in your REACT folder. The values in this INI are eventually used to replace tokens with values when your config runs. The INI is updated any time that you update or delete an item.

====Setting Defaults====

Default tokens and their values can be set in the REACT.ini file, under the newly created '''DefaultMetaData''' section. When [[REACT]] is initially opened, or the user changes a disc, the token values are reset to these defaults. The dialogue allows you to quickly and easily amend the token values on a per disc basic, rather than having to edit the INI manually (see '[[REACT:Mods#A Basic Alternative|A Basic Alternative]]').

A simple example would be the @discnumber@ and @totaldiscs@ tokens, which are initially set to a default of '1'. If you are ripping a multi-disc album you can alter these values as required, in the knowledge that they will revert to '1' when a new disc is inserted. The article '[[REACT:Adding Support For Disc Information]]' details config changes that will use these tokens to add disc information to your files, and amend the folder structure, if @totaldiscs@ exceeds one.

====Processing Tokens====

Your additional tokens are inserted into any [[Cuesheet|cuesheets]] created using REM statements, so are available to ACDIR, and any other application that can parse [[Cuesheet|cuesheets]] with REM statements. Album-level tokens are added at the top of the [[Cuesheet|cuesheet]], with the other global values. Track-level tokens are added beneath the appropriate TRACK statement. Therefore, if you are ripping to an image, you can still use these values with any tracks you create, using ACDIR's $R{} and $r{} syntax, e.g.: $R{DISCNUMBER} and $r{COMPOSER}.

If you do not want certain tokens added to the cuesheet you can prefix the token name with an underscore, e.g.: @_disctype@. These are assumed to be temporary, or processing, tokens, used purely for conditionally executing sections of your config.

====Track-Level Tokens====

Most tokens are album-related. If you want to set track-level tokens you should use the format '''<token name>[<track number>]''', e.g.: '''composer[1]''' to set the composer token value for track one. Your config should refer to the token only by name, e.g.: @composer@. When processing track one, @composer@ will be replaced by the value of composer[1], when processing track two, @composer@ will be replaced by the value of composer[2], etc.

====Using The Tokens====

You can use both @ and $-style tokens in your config. When using $ tokens any integer value will be zero-padded ("4" -> "04") and any string values will be converted to a filename-friendly value, using the standard [[REACT]] character replacement. Therefore, if you create a token called '''discname''' you can use @discname@ when tagging, and $discname$ when creating a file or folder name.

===A Basic Alternative===
If you want to use additional tokens in your config but do not want to use this mod you ''can'' add additional variables to the existing '''UserTrackFormats''', '''UserOutputNames''', and, ''more pertinently'', '''UserSettings''' sections of REACT.ini. You will need to update these variables by hand in a text editor if the value required for the disc you are ripping differs from the current value set.

===Changelog===
2.0.ssb5, 03/05/07
* First public release.

2.0.ssb6, 04/05/07
* Additional Meta Data dialogue made child of EAC window.
* Changed function prefix from fGUI to fDiag to save confusion.

2.0.ssb8, 14/05/07
* Moved default values into REACT.ini.
* Fixed the code that writes track-level meta data to the cuesheet.
* Current token values now stored in "meta.ini", not "metadata.ini".
* Moved a little more code from the main source file into the include.

2.0.ssb9, 14/05/07
* Track cuesheets now supported.

2.0.ssb10, 30/05/07
* Added underscore prefix to identify temporary tokens.
* Fixed REACT issue with "%" in any field. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] )
* Fixed REACT issue with "&" in the track name when using REACT-track.cfg. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] )

2.0.ssb11, 01/07/07
* Works with new- (EAC 0.99 prebeta 1) and old-style (EAC 0.95 beta 4 and earlier) log files. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=501821 post] )
* Will only rewrite INI file on major or minor version change, not a new build.

2.0.ssb12, 02/07/07
* Log file handling now works correctly for track ripping.

2.0.ssb13, 04/07/07
* Reverted cover filename to "<album>.jpg" irrespective of EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=502330 post] )

2.0.ssb15, 17/07/07
* Reverted @albumfile@ to "<sourcedir>\<album>", irrespective of the EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=505038 post] )
* Add <code>Test=1</code> under the Settings section of REACT.ini to use Test and Copy mode.

2.0.ssb16, 29/07/07
* Fixed issues with meta data changing mid-process. meta.ini is now only updated with the GUI values immediately before a rip begins.
* Fixed bug with @ and $ values. @totaldiscs@ will now correctly return "3", while $totaldiscs$ will return "03".

2.0.ssb16b, 15/08/07
* Fixed issue with log file name when ripping a VA album to tracks ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=510414 post] ).

2.0.ssb16c, 21/08/07
* Add <code>CoverDownloaderXUI=1</CODE> to the [Settings] section of your REACT.ini when using Album Art XUI, and REACT will cope with JPEG, GIF, and PNG album art ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=511640 post] ).

2.0.ssb16d, 21/08/07
* Added BMP support to above.

2.0.ssb16e, 23/08/07
* Fixed bug with above, where the artist and album did not change with the disc.

2.0.ssb16f, 11/09/07
* Hitting Ctrl+F2 to reconfigure EAC will now ensure that the working directories used by EAC are in synch ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=515730 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=512481 post] ).

2.0.ssb16g, 17/09/07
* You can now process a WAVE/CUE/LOG combo by passing the full cuesheet path to REACT as a single parameter

2.0.ssb16h, 17/09/07
* Set <code>CoverDownloaderLocalPath</code> to the path of your existing album art if you would rather chose those over any downloaded using the cover downloader. You may use $artist$ and $album$ tokens in the path, e.g.:
CoverDownloaderLocalPath=C:\Documents and Settings\My Name\My Documents\My Music\$artist$\$album$\folder.jpg

===Download===
[http://www.synthetic-soul.co.uk/temp/REACT_2.0.ssb16h.zip REACT 2.0.ssb16h]

====Updated CFG files====
The zip below includes updated REACT.ini, REACT-track.cfg and REACT-image.cfg files, utilising various aspects of this mod, including (but not restricted to) support for TAK, the ampersand fix, and disc-related tags.

[http://www.synthetic-soul.co.uk/temp/REACT-cfgs_ssb16.zip REACT-cfgs_ssb16.zip]

[[Category:REACT|Mods]]

REACT:Mods

2007-09-11T10:48:22Z

Synthetic Soul: Updated to 2.0.ssb16f

==Synthetic Soul's Mod==

[[Image:React-mod.png|thumb|Screenshot demonstrating the Additional Meta Data dialogue]]

[[User:Synthetic Soul|Synthetic Soul]] maintains a mod of [[REACT|REACT 2.0]].

===Key Points===

* Additional Meta Data dialogue allows you to easily edit supplemental disc and track information.
* Track-level tokens supported.
* Additional meta data added to cuesheets, as REM statements.
* Fixes issue in REACT with '%' in any field ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] ).
* Fixes issue in REACT with '&' in the track name when using REACT-track.cfg ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] ).
* Works with new- (EAC 0.99 prebeta 1) and old-style log files.
* Will only rewrite INI file on major or minor version change, not a new build.
* Use Test & Copy by adding <code>Test=1</code> under the Settings section of REACT.ini.

===Description===

The main purpose of this mod is to allow users to easily provide additional meta data to the [[REACT]] configs. This is achieved by the introduction of an Additional Meta Data dialogue, which allows users to easily create, amend and delete additional tokens, which can be used either to set tag values (e.g.: @discnumber@) , or as variables used in conditions within the config to alter the processing path (e.g.: @_disctype@).

The dialogue is opened using '''Alt+F5'''. The new dialogue is non-modal, but will stay on top of the EAC main window; if you minimise [[EAC]] the dialogue is minimised also. If you close the dialogue it is simply hidden from view, so your list items will stay intact. Therefore, if you need to set various meta data for each disc that you are ripping, you may choose to keep the dialogue open throughout the process; however, if you only need to use it to alter values infrequently, you can leave it hidden, but know that the values are still available to your config file.

The current list state is recorded in a new file called "meta.ini" in your REACT folder. The values in this INI are eventually used to replace tokens with values when your config runs. The INI is updated any time that you update or delete an item.

====Setting Defaults====

Default tokens and their values can be set in the REACT.ini file, under the newly created '''DefaultMetaData''' section. When [[REACT]] is initially opened, or the user changes a disc, the token values are reset to these defaults. The dialogue allows you to quickly and easily amend the token values on a per disc basic, rather than having to edit the INI manually (see '[[REACT:Mods#A Basic Alternative|A Basic Alternative]]').

A simple example would be the @discnumber@ and @totaldiscs@ tokens, which are initially set to a default of '1'. If you are ripping a multi-disc album you can alter these values as required, in the knowledge that they will revert to '1' when a new disc is inserted. The article '[[REACT:Adding Support For Disc Information]]' details config changes that will use these tokens to add disc information to your files, and amend the folder structure, if @totaldiscs@ exceeds one.

====Processing Tokens====

Your additional tokens are inserted into any [[Cuesheet|cuesheets]] created using REM statements, so are available to ACDIR, and any other application that can parse [[Cuesheet|cuesheets]] with REM statements. Album-level tokens are added at the top of the [[Cuesheet|cuesheet]], with the other global values. Track-level tokens are added beneath the appropriate TRACK statement. Therefore, if you are ripping to an image, you can still use these values with any tracks you create, using ACDIR's $R{} and $r{} syntax, e.g.: $R{DISCNUMBER} and $r{COMPOSER}.

If you do not want certain tokens added to the cuesheet you can prefix the token name with an underscore, e.g.: @_disctype@. These are assumed to be temporary, or processing, tokens, used purely for conditionally executing sections of your config.

====Track-Level Tokens====

Most tokens are album-related. If you want to set track-level tokens you should use the format '''<token name>[<track number>]''', e.g.: '''composer[1]''' to set the composer token value for track one. Your config should refer to the token only by name, e.g.: @composer@. When processing track one, @composer@ will be replaced by the value of composer[1], when processing track two, @composer@ will be replaced by the value of composer[2], etc.

====Using The Tokens====

You can use both @ and $-style tokens in your config. When using $ tokens any integer value will be zero-padded ("4" -> "04") and any string values will be converted to a filename-friendly value, using the standard [[REACT]] character replacement. Therefore, if you create a token called '''discname''' you can use @discname@ when tagging, and $discname$ when creating a file or folder name.

===A Basic Alternative===
If you want to use additional tokens in your config but do not want to use this mod you ''can'' add additional variables to the existing '''UserTrackFormats''', '''UserOutputNames''', and, ''more pertinently'', '''UserSettings''' sections of REACT.ini. You will need to update these variables by hand in a text editor if the value required for the disc you are ripping differs from the current value set.

===Changelog===
2.0.ssb5, 03/05/07
* First public release.

2.0.ssb6, 04/05/07
* Additional Meta Data dialogue made child of EAC window.
* Changed function prefix from fGUI to fDiag to save confusion.

2.0.ssb8, 14/05/07
* Moved default values into REACT.ini.
* Fixed the code that writes track-level meta data to the cuesheet.
* Current token values now stored in "meta.ini", not "metadata.ini".
* Moved a little more code from the main source file into the include.

2.0.ssb9, 14/05/07
* Track cuesheets now supported.

2.0.ssb10, 30/05/07
* Added underscore prefix to identify temporary tokens.
* Fixed REACT issue with "%" in any field. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] )
* Fixed REACT issue with "&" in the track name when using REACT-track.cfg. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] )

2.0.ssb11, 01/07/07
* Works with new- (EAC 0.99 prebeta 1) and old-style (EAC 0.95 beta 4 and earlier) log files. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=501821 post] )
* Will only rewrite INI file on major or minor version change, not a new build.

2.0.ssb12, 02/07/07
* Log file handling now works correctly for track ripping.

2.0.ssb13, 04/07/07
* Reverted cover filename to "<album>.jpg" irrespective of EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=502330 post] )

2.0.ssb15, 17/07/07
* Reverted @albumfile@ to "<sourcedir>\<album>", irrespective of the EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=505038 post] )
* Add <code>Test=1</code> under the Settings section of REACT.ini to use Test and Copy mode.

2.0.ssb16, 29/07/07
* Fixed issues with meta data changing mid-process. meta.ini is now only updated with the GUI values immediately before a rip begins.
* Fixed bug with @ and $ values. @totaldiscs@ will now correctly return "3", while $totaldiscs$ will return "03".

2.0.ssb16b, 15/08/07
* Fixed issue with log file name when ripping a VA album to tracks ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=510414 post] ).

2.0.ssb16c, 21/08/07
* Add <code>CoverDownloaderXUI=1</CODE> to the [Settings] section of your REACT.ini when using Album Art XUI, and REACT will cope with JPEG, GIF, and PNG album art ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=511640 post] ).

2.0.ssb16d, 21/08/07
* Added BMP support to above.

2.0.ssb16e, 23/08/07
* Fixed bug with above, where the artist and album did not change with the disc.

2.0.ssb16f, 23/08/0711/09/07
* Hitting Ctrl+F2 to reconfigure EAC will now ensure that the working directories used by EAC are in synch ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=515730 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=512481 post] ).

===Download===
[http://www.synthetic-soul.co.uk/temp/REACT_2.0.ssb16f.zip REACT 2.0.ssb16f]

====Updated CFG files====
The zip below includes updated REACT.ini, REACT-track.cfg and REACT-image.cfg files, utilising various aspects of this mod, including (but not restricted to) support for TAK, the ampersand fix, and disc-related tags.

[http://www.synthetic-soul.co.uk/temp/REACT-cfgs_ssb16.zip REACT-cfgs_ssb16.zip]

[[Category:REACT|Mods]]

REACT:Mods

2007-09-09T06:26:58Z

Synthetic Soul: Updated to 2.0.ssb16e

==Synthetic Soul's Mod==

[[Image:React-mod.png|thumb|Screenshot demonstrating the Additional Meta Data dialogue]]

[[User:Synthetic Soul|Synthetic Soul]] maintains a mod of [[REACT|REACT 2.0]].

===Key Points===

* Additional Meta Data dialogue allows you to easily edit supplemental disc and track information.
* Track-level tokens supported.
* Additional meta data added to cuesheets, as REM statements.
* Fixes issue in REACT with '%' in any field ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] ).
* Fixes issue in REACT with '&' in the track name when using REACT-track.cfg ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] ).
* Works with new- (EAC 0.99 prebeta 1) and old-style log files.
* Will only rewrite INI file on major or minor version change, not a new build.
* Use Test & Copy by adding <code>Test=1</code> under the Settings section of REACT.ini.

===Description===

The main purpose of this mod is to allow users to easily provide additional meta data to the [[REACT]] configs. This is achieved by the introduction of an Additional Meta Data dialogue, which allows users to easily create, amend and delete additional tokens, which can be used either to set tag values (e.g.: @discnumber@) , or as variables used in conditions within the config to alter the processing path (e.g.: @_disctype@).

The dialogue is opened using '''Alt+F5'''. The new dialogue is non-modal, but will stay on top of the EAC main window; if you minimise [[EAC]] the dialogue is minimised also. If you close the dialogue it is simply hidden from view, so your list items will stay intact. Therefore, if you need to set various meta data for each disc that you are ripping, you may choose to keep the dialogue open throughout the process; however, if you only need to use it to alter values infrequently, you can leave it hidden, but know that the values are still available to your config file.

The current list state is recorded in a new file called "meta.ini" in your REACT folder. The values in this INI are eventually used to replace tokens with values when your config runs. The INI is updated any time that you update or delete an item.

====Setting Defaults====

Default tokens and their values can be set in the REACT.ini file, under the newly created '''DefaultMetaData''' section. When [[REACT]] is initially opened, or the user changes a disc, the token values are reset to these defaults. The dialogue allows you to quickly and easily amend the token values on a per disc basic, rather than having to edit the INI manually (see '[[REACT:Mods#A Basic Alternative|A Basic Alternative]]').

A simple example would be the @discnumber@ and @totaldiscs@ tokens, which are initially set to a default of '1'. If you are ripping a multi-disc album you can alter these values as required, in the knowledge that they will revert to '1' when a new disc is inserted. The article '[[REACT:Adding Support For Disc Information]]' details config changes that will use these tokens to add disc information to your files, and amend the folder structure, if @totaldiscs@ exceeds one.

====Processing Tokens====

Your additional tokens are inserted into any [[Cuesheet|cuesheets]] created using REM statements, so are available to ACDIR, and any other application that can parse [[Cuesheet|cuesheets]] with REM statements. Album-level tokens are added at the top of the [[Cuesheet|cuesheet]], with the other global values. Track-level tokens are added beneath the appropriate TRACK statement. Therefore, if you are ripping to an image, you can still use these values with any tracks you create, using ACDIR's $R{} and $r{} syntax, e.g.: $R{DISCNUMBER} and $r{COMPOSER}.

If you do not want certain tokens added to the cuesheet you can prefix the token name with an underscore, e.g.: @_disctype@. These are assumed to be temporary, or processing, tokens, used purely for conditionally executing sections of your config.

====Track-Level Tokens====

Most tokens are album-related. If you want to set track-level tokens you should use the format '''<token name>[<track number>]''', e.g.: '''composer[1]''' to set the composer token value for track one. Your config should refer to the token only by name, e.g.: @composer@. When processing track one, @composer@ will be replaced by the value of composer[1], when processing track two, @composer@ will be replaced by the value of composer[2], etc.

====Using The Tokens====

You can use both @ and $-style tokens in your config. When using $ tokens any integer value will be zero-padded ("4" -> "04") and any string values will be converted to a filename-friendly value, using the standard [[REACT]] character replacement. Therefore, if you create a token called '''discname''' you can use @discname@ when tagging, and $discname$ when creating a file or folder name.

===A Basic Alternative===
If you want to use additional tokens in your config but do not want to use this mod you ''can'' add additional variables to the existing '''UserTrackFormats''', '''UserOutputNames''', and, ''more pertinently'', '''UserSettings''' sections of REACT.ini. You will need to update these variables by hand in a text editor if the value required for the disc you are ripping differs from the current value set.

===Changelog===
2.0.ssb5, 03/05/07
* First public release.

2.0.ssb6, 04/05/07
* Additional Meta Data dialogue made child of EAC window.
* Changed function prefix from fGUI to fDiag to save confusion.

2.0.ssb8, 14/05/07
* Moved default values into REACT.ini.
* Fixed the code that writes track-level meta data to the cuesheet.
* Current token values now stored in "meta.ini", not "metadata.ini".
* Moved a little more code from the main source file into the include.

2.0.ssb9, 14/05/07
* Track cuesheets now supported.

2.0.ssb10, 30/05/07
* Added underscore prefix to identify temporary tokens.
* Fixed REACT issue with "%" in any field. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] )
* Fixed REACT issue with "&" in the track name when using REACT-track.cfg. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] )

2.0.ssb11, 01/07/07
* Works with new- (EAC 0.99 prebeta 1) and old-style (EAC 0.95 beta 4 and earlier) log files. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=501821 post] )
* Will only rewrite INI file on major or minor version change, not a new build.

2.0.ssb12, 02/07/07
* Log file handling now works correctly for track ripping.

2.0.ssb13, 04/07/07
* Reverted cover filename to "<album>.jpg" irrespective of EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=502330 post] )

2.0.ssb15, 17/07/07
* Reverted @albumfile@ to "<sourcedir>\<album>", irrespective of the EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=505038 post] )
* Add <code>Test=1</code> under the Settings section of REACT.ini to use Test and Copy mode.

2.0.ssb16, 29/07/07
* Fixed issues with meta data changing mid-process. meta.ini is now only updated with the GUI values immediately before a rip begins.
* Fixed bug with @ and $ values. @totaldiscs@ will now correctly return "3", while $totaldiscs$ will return "03".

2.0.ssb16b, 15/08/07
* Fixed issue with log file name when ripping a VA album to tracks ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=510414 post] ).

2.0.ssb16c, 21/08/07
* Add <code>CoverDownloaderXUI=1</CODE> to the [Settings] section of your REACT.ini when using Album Art XUI, and REACT will cope with JPEG, GIF, and PNG album art ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=511640 post] ).

2.0.ssb16d, 21/08/07
* Added BMP support to above.

2.0.ssb16e, 23/08/07
* Fixed bug with above, where the artist and album did not change with the disc.

===Download===
[http://www.synthetic-soul.co.uk/temp/REACT_2.0.ssb16e.zip REACT 2.0.ssb16e]

====Updated CFG files====
The zip below includes updated REACT.ini, REACT-track.cfg and REACT-image.cfg files, utilising various aspects of this mod, including (but not restricted to) support for TAK, the ampersand fix, and disc-related tags.

[http://www.synthetic-soul.co.uk/temp/REACT-cfgs_ssb16.zip REACT-cfgs_ssb16.zip]

[[Category:REACT|Mods]]

REACT:Mods

2007-08-21T13:08:08Z

Synthetic Soul: Added cfg download

==Synthetic Soul's Mod==

[[Image:React-mod.png|thumb|Screenshot demonstrating the Additional Meta Data dialogue]]

[[User:Synthetic Soul|Synthetic Soul]] maintains a mod of [[REACT|REACT 2.0]].

===Key Points===

* Additional Meta Data dialogue allows you to easily edit supplemental disc and track information.
* Track-level tokens supported.
* Additional meta data added to cuesheets, as REM statements.
* Fixes issue in REACT with '%' in any field ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] ).
* Fixes issue in REACT with '&' in the track name when using REACT-track.cfg ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] ).
* Works with new- (EAC 0.99 prebeta 1) and old-style log files.
* Will only rewrite INI file on major or minor version change, not a new build.
* Use Test & Copy by adding <code>Test=1</code> under the Settings section of REACT.ini.

===Description===

The main purpose of this mod is to allow users to easily provide additional meta data to the [[REACT]] configs. This is achieved by the introduction of an Additional Meta Data dialogue, which allows users to easily create, amend and delete additional tokens, which can be used either to set tag values (e.g.: @discnumber@) , or as variables used in conditions within the config to alter the processing path (e.g.: @_disctype@).

The dialogue is opened using '''Alt+F5'''. The new dialogue is non-modal, but will stay on top of the EAC main window; if you minimise [[EAC]] the dialogue is minimised also. If you close the dialogue it is simply hidden from view, so your list items will stay intact. Therefore, if you need to set various meta data for each disc that you are ripping, you may choose to keep the dialogue open throughout the process; however, if you only need to use it to alter values infrequently, you can leave it hidden, but know that the values are still available to your config file.

The current list state is recorded in a new file called "meta.ini" in your REACT folder. The values in this INI are eventually used to replace tokens with values when your config runs. The INI is updated any time that you update or delete an item.

====Setting Defaults====

Default tokens and their values can be set in the REACT.ini file, under the newly created '''DefaultMetaData''' section. When [[REACT]] is initially opened, or the user changes a disc, the token values are reset to these defaults. The dialogue allows you to quickly and easily amend the token values on a per disc basic, rather than having to edit the INI manually (see '[[REACT:Mods#A Basic Alternative|A Basic Alternative]]').

A simple example would be the @discnumber@ and @totaldiscs@ tokens, which are initially set to a default of '1'. If you are ripping a multi-disc album you can alter these values as required, in the knowledge that they will revert to '1' when a new disc is inserted. The article '[[REACT:Adding Support For Disc Information]]' details config changes that will use these tokens to add disc information to your files, and amend the folder structure, if @totaldiscs@ exceeds one.

====Processing Tokens====

Your additional tokens are inserted into any [[Cuesheet|cuesheets]] created using REM statements, so are available to ACDIR, and any other application that can parse [[Cuesheet|cuesheets]] with REM statements. Album-level tokens are added at the top of the [[Cuesheet|cuesheet]], with the other global values. Track-level tokens are added beneath the appropriate TRACK statement. Therefore, if you are ripping to an image, you can still use these values with any tracks you create, using ACDIR's $R{} and $r{} syntax, e.g.: $R{DISCNUMBER} and $r{COMPOSER}.

If you do not want certain tokens added to the cuesheet you can prefix the token name with an underscore, e.g.: @_disctype@. These are assumed to be temporary, or processing, tokens, used purely for conditionally executing sections of your config.

====Track-Level Tokens====

Most tokens are album-related. If you want to set track-level tokens you should use the format '''<token name>[<track number>]''', e.g.: '''composer[1]''' to set the composer token value for track one. Your config should refer to the token only by name, e.g.: @composer@. When processing track one, @composer@ will be replaced by the value of composer[1], when processing track two, @composer@ will be replaced by the value of composer[2], etc.

====Using The Tokens====

You can use both @ and $-style tokens in your config. When using $ tokens any integer value will be zero-padded ("4" -> "04") and any string values will be converted to a filename-friendly value, using the standard [[REACT]] character replacement. Therefore, if you create a token called '''discname''' you can use @discname@ when tagging, and $discname$ when creating a file or folder name.

===A Basic Alternative===
If you want to use additional tokens in your config but do not want to use this mod you ''can'' add additional variables to the existing '''UserTrackFormats''', '''UserOutputNames''', and, ''more pertinently'', '''UserSettings''' sections of REACT.ini. You will need to update these variables by hand in a text editor if the value required for the disc you are ripping differs from the current value set.

===Changelog===
2.0.ssb5, 03/05/07
* First public release.

2.0.ssb6, 04/05/07
* Additional Meta Data dialogue made child of EAC window.
* Changed function prefix from fGUI to fDiag to save confusion.

2.0.ssb8, 14/05/07
* Moved default values into REACT.ini.
* Fixed the code that writes track-level meta data to the cuesheet.
* Current token values now stored in "meta.ini", not "metadata.ini".
* Moved a little more code from the main source file into the include.

2.0.ssb9, 14/05/07
* Track cuesheets now supported.

2.0.ssb10, 30/05/07
* Added underscore prefix to identify temporary tokens.
* Fixed REACT issue with "%" in any field. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=494794 post] )
* Fixed REACT issue with "&" in the track name when using REACT-track.cfg. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495125 post] and [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=495493 post] )

2.0.ssb11, 01/07/07
* Works with new- (EAC 0.99 prebeta 1) and old-style (EAC 0.95 beta 4 and earlier) log files. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=501821 post] )
* Will only rewrite INI file on major or minor version change, not a new build.

2.0.ssb12, 02/07/07
* Log file handling now works correctly for track ripping.

2.0.ssb13, 04/07/07
* Reverted cover filename to "<album>.jpg" irrespective of EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=502330 post] )

2.0.ssb15, 17/07/07
* Reverted @albumfile@ to "<sourcedir>\<album>", irrespective of the EAC version. ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=505038 post] )
* Add <code>Test=1</code> under the Settings section of REACT.ini to use Test and Copy mode.

2.0.ssb16, 29/07/07
* Fixed issues with meta data changing mid-process. meta.ini is now only updated with the GUI values immediately before a rip begins.
* Fixed bug with @ and $ values. @totaldiscs@ will now correctly return "3", while $totaldiscs$ will return "03".

2.0.ssb16b, 15/08/07
* Fixed issue with log file name when ripping a VA album to tracks ( [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=50273&view=findpost&p=510414 post] )

===Download===
[http://www.synthetic-soul.co.uk/temp/REACT_2.0.ssb16b.zip REACT 2.0.ssb16b]

====Updated CFG files====
The zip below includes updated REACT.ini, REACT-track.cfg and REACT-image.cfg files, utilising various aspects of this mod, including (but not restricted to) support for TAK, the ampersand fix, and disc-related tags.

[http://www.synthetic-soul.co.uk/temp/REACT-cfgs_ssb16.zip REACT-cfgs_ssb16.zip]

[[Category:REACT|Mods]]

REACT:Mods

2007-08-15T14:15:36Z

Synthetic Soul: b16b