REACT:Amending Cuesheet File References - Revision history

Jan at 19:37, 29 July 2010

2010-07-29T19:37:26Z

← Older revision		Revision as of 19:37, 29 July 2010
Line 222:		Line 222:


	[[Category:REACT\|Amending Cuesheet File References]]		[[Category:REACT Guides\|Amending Cuesheet File References]]
	~~[[Category:REACT Guides~~]]

Jan at 19:10, 29 July 2010

2010-07-29T19:10:05Z

← Older revision		Revision as of 19:10, 29 July 2010
Line 223:		Line 223:

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

Akkurat: Corrected settings/texts for users with Akkurat's Mod 2.0.akku.b03 or higher version.

2008-08-11T00:26:46Z

Corrected settings/texts for users with Akkurat's Mod 2.0.akku.b03 or higher version.

← Older revision		Revision as of 00:26, 11 August 2008
Line 1:		Line 1:
	When using [[REACT]] to rip to individual tracks you can request all cuesheets to be created, by specifying the following in REACT.ini:		When using [[REACT]] to rip to individual tracks you can request all cuesheets to be created (or just one with Akkurat's Mod 2.0.akku.b03), by specifying the following in REACT.ini:

			'''When using Akkurat's Mod 2.0.akku.b03 or higher version'''
			<pre>CreateCuesheet=mg</pre>

			This will create the following file in the working directory:

			* '''"@albumfile@.[mg].cue"''' (Multiple WAVE files with gaps (non-compliant))


			'''otherwise use this setting'''
	<pre>CreateAllCuesheets=1</pre>		<pre>CreateAllCuesheets=1</pre>

Line 65:		Line 74:
	<pre>ECHO @tools@\GSAR.EXE "-s@basename@.wav""" WAVE" "-r%TrackName%.mp3""" MP3" -o %trackCueFile%>>update-cuesheet.bat</pre>		<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.		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. '''NOTE!''' When using Akkurat's Mod 2.0.akku.b03 or higher version, if you change the '''[mg]''' used in the example to another cuesheet, you must change the '''CreateCuesheet=''' option to match your replacement.


Line 202:		Line 211:
	</pre>		</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.		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. '''NOTE!''' When using Akkurat's Mod 2.0.akku.b03 or higher version, if you change the '''[mg]''' used in the example to another cuesheet, you must change the '''CreateCuesheet=''' option to match your replacement.

	'''Requirements'''		'''Requirements'''

Akkurat: small corrections

2008-01-18T14:44:43Z

small corrections

← Older revision		Revision as of 14:44, 18 January 2008
Line 20:		Line 20:
	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:		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".		# When the first track is processed the cuesheet will be copied to a new cuesheet file named "$cdartist$ - $album$.cue". A batch command, setting 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.		# 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.		# When the last track is processed, a GSAR command is executed to escape percent signs (%) in the temporary batch file.
Line 115:		Line 115:
	... any of the lines below may be used in its place:		... any of the lines below may be used in its place:

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

Synthetic Soul at 11:06, 18 January 2008

2008-01-18T11:06:46Z

← Older revision		Revision as of 11:06, 18 January 2008
Line 92:		Line 92:
	</pre>		</pre>

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


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


	====Using GSAR to Escape Percent Signs Written to Batch Files====		====Using GSAR to Escape Percent Signs Written to Batch Files====
Line 141:		Line 140:
	GSAR.EXE -s%% -r%%%% -o update-cuesheet.bat		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.		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.

Synthetic Soul: Grammar, missing text

2008-01-18T10:03:52Z

Grammar, missing text

← Older revision		Revision as of 10:03, 18 January 2008
Line 104:		Line 104:
	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 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 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~~ one instance with three (" -> """) or by replacing it with the correct character code (" -> :034 (decimal) or " -> :x22 (hex)).		'''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. (: -> ::)

Synthetic Soul: Clarified filenames and GSAR

2008-01-18T09:53:43Z

Clarified filenames and GSAR

← Older revision		Revision as of 09:53, 18 January 2008
Line 102:		Line 102:
	===Using GSAR For Other Requirements===		===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.		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.

	'''~~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)).		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)).


Line 128:		Line 130:


	~~'''~~Using GSAR to Escape Percent Signs Written to Batch Files~~'''~~		====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%).		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%).

Synthetic Soul: Updated text in Using GSAR For Other Requirements

2008-01-18T09:42:04Z

Updated text in Using GSAR For Other Requirements

← Older revision		Revision as of 09:42, 18 January 2008
Line 20:		Line 20:
	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:		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". ~~Also a~~ batch command ~~to set~~ the ~~right code page~~ is written to a temporary batch file called "update-cuesheet.bat".		# 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.		# 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 (%) ~~characters~~ in the temporary batch file.		# When the last track is processed, a GSAR command is executed to escape percent signs (%) in the temporary batch file.
	# ~~After that, the~~ temporary batch file is executed, executing a GSAR command for each track.		# The temporary batch file is executed, executing a GSAR command for each track.
	# The file "update-cuesheet.bat" is deleted.		# The file "update-cuesheet.bat" is deleted.

Line 100:		Line 100:


	~~'''~~Using GSAR ~~to other needs'''~~		===Using GSAR For Other Requirements===

	If you~~'re planning to use the~~ GSAR to other string replacement ~~needs~~, you ~~must make sure~~ to ~~escape~~ certain characters before ~~running~~ GSAR commands in batch files. The "Amending Cuesheet File References" example only needs the percent (%) and the quote (") character escapes. In addition there is one other character to escape, the colon (:).		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.

	* The percent is escaped by replacing it with two percents (~~% -> %%~~).		'''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)).
	* The colon is escaped by replacing it with two colons (~~: -> :~~:).
	* The quote is escaped by replacing it with three ~~quotes~~ (" -> """) or ~~ASCII decimal or hex value~~ (" -> :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:

	~~Examples for all three escapes below.~~
	<pre>		<pre>
	~~string~~= ~~Test~~: ~~a "perfect"~~ %~~100 test~~		SET myVar=%myVar::=::%
	~~escaped string~~= ~~Test~~:: a """~~perfect:x22~~ %%~~100 test~~		SET myVar=%myVar:"=:x22%

			@tools@\GSAR.EXE "-sSome Existing Text" "-r%myVar%" -o myfile.txt
	</pre>		</pre>
	~~And here's a couple of examples how to escape these characters in batch variables.~~
	~~<pre>~~
	~~(variable %text%)~~

	~~SET text=%text::=::%~~
	~~SET text=%text:"=:x22%~~
	~~</pre>~~
	Escaping the percent character is more complicated. You can't use previous example to escape it in batch variables. Study how this "Amending Cuesheet File References" guide escapes percent characters. Pay close attention to the following command which is meant to be used in a batch file:
	~~<pre>~~
	~~GSAR.EXE -s%% -r%%%% -o update-cuesheet.bat~~
	~~</pre>~~
	~~This command replaces all percent characters with two percent characters in the update-cuesheet.bat file. The -o switch tells GSAR to overwrite the update-cuesheet.bat file.~~

			'''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.

Akkurat: Added "Using GSAR to other needs" instructions

2008-01-18T03:23:13Z

Added "Using GSAR to other needs" instructions

@@ Line 93: / Line 93: @@
 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.

Akkurat: Added fixes to GSAR examples

2008-01-18T02:10:33Z

Added fixes to GSAR examples

← Older revision		Revision as of 02:10, 18 January 2008
Line 20:		Line 20:
	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:		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".		# When the first track is processed the cuesheet will be copied to a new cuesheet file named "$cdartist$ - $album$.cue". Also a batch command to set the right code page 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 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 ~~this~~ batch file is executed, executing a GSAR command for each track.		# When the last track is processed, a GSAR command is executed to escape percent (%) characters in the temporary batch file.
			# After that, the temporary batch file is executed, executing a GSAR command for each track.
	# The file "update-cuesheet.bat" is deleted.		# The file "update-cuesheet.bat" is deleted.

Line 30:		Line 31:
	The following lines need to be added to the code which is run for the format you are using 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"		<pre>
	IF NOT EXIST %trackCueFile% COPY "@albumfile@.[mg].cue" %trackCueFile%		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>		ECHO @tools@\GSAR.EXE "-s@basename@.wav" "-r%TrackName%.wv" -o %trackCueFile%>>update-cuesheet.bat</pre>

Line 45:		Line 50:
	@ECHO OFF		@ECHO OFF
	SET trackCueFile="$cdartist$ - $album$.cue"		SET trackCueFile="$cdartist$ - $album$.cue"
	IF NOT EXIST %trackCueFile% COPY "@albumfile@.[mg].cue" %trackCueFile%		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		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		IF %have_cover%==1 IF NOT EXIST folder.jpg COPY "@cover@" folder.jpg
Line 65:		Line 73:

	<pre>		<pre>
			@tools@\GSAR.EXE -s%% -r%%%% -o update-cuesheet.bat
	CALL update-cuesheet.bat		CALL update-cuesheet.bat
	DEL update-cuesheet.bat		DEL update-cuesheet.bat
Line 76:		Line 85:
	IF %add_rg%==1 @tools@\wvgain.exe -a *.wv		IF %add_rg%==1 @tools@\wvgain.exe -a *.wv
	REM COPY /Y "@eaclog@" "EAClog.txt"		REM COPY /Y "@eaclog@" "EAClog.txt"
			@tools@\GSAR.EXE -s%% -r%%%% -o update-cuesheet.bat
	CALL update-cuesheet.bat		CALL update-cuesheet.bat
	DEL update-cuesheet.bat		DEL update-cuesheet.bat