EAC placeholders: Difference between revisions

From Hydrogenaudio Knowledgebase
(Created page with "'''Exact Audio Copy''' provides numerous '''placeholders''' to be used when invoking a command-line encoder. Beginning with EAC version 1.0 beta 2, the naming scheme for plac…")
 
No edit summary
Line 1: Line 1:
'''[[Exact Audio Copy]]''' provides numerous '''placeholders''' to be used when invoking a command-line encoder. Beginning with EAC version 1.0 beta 2, the naming scheme for placeholders was revamped, necessitating that users moving to this new version revise their command lines. Both old and new lists of placeholders and their meanings are available in the official [http://www.exactaudiocopy.de/en/index.php/support/faq/ EAC FAQ] and in several of the Hydrogenaudio Knowledgebase’s own [http://wiki.hydrogenaudio.org/index.php?title=Category:Guides Guides]. This page intends to simplify the process of migrating to a new version of EAC by collating the two sets of placeholders into a single table for ease of comparison/substitution.
'''[[Exact Audio Copy]]''' provides numerous '''placeholders''' to be used when [[EAC Compression Options#External_compression|invoking a command-line encoder]] and when [[EAC Options#Filename|naming output files]].
 
Beginning with EAC version 1.0 beta 2, the naming scheme for placeholders was revamped, necessitating that users moving to this new version revise their command lines. Both old and new lists of placeholders and their meanings have long been available in the official [http://www.exactaudiocopy.de/en/index.php/support/faq/ EAC FAQ] and in several of the Hydrogenaudio Knowledgebase’s own [http://wiki.hydrogenaudio.org/index.php?title=Category:Guides Guides]; however, there was no easy way to look up values and to compare them between different versions.
 
Moreover, confusion can arise from the fact that versions of EAC prior to 1.0b2 used different placeholders for naming the output file compared to those for passing to the external encoder. These two sets of placeholders do not correspond, but they are similar enough to get mixed up.
 
For these reasons, as well as for general convenience and ease of use, this page intends to simplify the process of using (or comparing/substituting) placeholders, by collating all of those listed by the [http://www.exactaudiocopy.de/en/index.php/support/faq/ EAC FAQ] into a single table.


{| class="wikitable" style="margin: 1em auto 1em auto;"
{| class="wikitable" style="margin: 1em auto 1em auto;"
|+ Comparison of placeholders from versions of EAC before and after 1.0 beta 2
|+ Placeholders used in EAC
|-
|''Property''||''External Compression placeholders pre-1.0b2''||''External Compression placeholders in 1.0b2 and later''||''Filename placeholders pre-1.0b2''||''Filename placeholders in 1.0b2 and later''
|-
|'''Files'''||||||||
|-
|Source filename||%s||%source%||||
|-
|-
|''For versions before 1.0 beta 2''||''For versions from 1.0 beta 2 on''
|Destination filename||%d||%dest%||||
|-
|-
|'''Files'''||
|Original filename (without temporary renaming)||%o||%original%||||
|-
|-
|%s – Source filename||%source% – Source filename
|'''Quality settings'''||||||||
|-
|-
|%d – Destination filename||%dest% – Destination filename
|Text “…” only when “High quality” selected||%h…%h||%ishigh%…%ishigh%||||
|-
|-
|%o – Original filename (without temporary renaming)||%original% – Original filename (without temporary renaming)
|-Text “…” only when “Low quality” selected||%l…%l||%islow%…%islow%||||
|-
|-
|'''Quality settings'''||
|'''Common metadata'''||||||||
|-
|-
|%h…%h – Text “…” only when “High quality” selected||%ishigh%…%ishigh% – Text “…” only when “High quality” selected
|Track artist||%a||%artist%||%A||%artist%
|-
|-
|%l…%l -Text “…” only when “Low quality” selected||%islow%…%islow% -Text “…” only when “Low quality” selected
|Track title||%t||%title%||%T||%title%
|-
|-
|'''Common metadata'''||
|CD artist||%v||%albumartist%||%D||%albumartist%
|-
|-
|%a – Track artist||%artist% – Track artist
|CD title||%g||%albumtitle%||%C||%albumtitle%
|-
|-
|%t – Track title||%title% – Track title
|Track composer/performer||||%composer%||||%composer%||
|-
|-
|%v – CD artist||%albumartist% – CD artist
|CD composer||||%albumcomposer%||||%albumcomposer%
|-
|-
|%g – CD title||%albumtitle% – CD title
|CD performer||||%albuminterpret%||||%albuminterpret%
|-
|-
|||%composer% – Track performer
|Year||%y||%year%||%Y||%year%
|-
|-
|||%albumcomposer% – CD composer
|Track number||%n||%tracknr% (same as %tracknr2%)||%N||
|-
|-
|||%albuminterpret% – CD performer
|Track number (at least 1 digit)||||%tracknr1%||||%tracknr1%
|-
|-
|%y – Year||%year% – Year
|Track number (at least 2 digits)||||%tracknr2%||||%tracknr2%
|-
|-
|%n – Track number||%tracknr% – Track number (same as %tracknr2%)
|Track number (at least 3 digits)||||%tracknr3%||||%tracknr3%
|-
|-
|||%tracknr1% – Track number (at least 1 digit)
|Total number of CDs in the given CD set||||%totalcds%||||%totalcds%
|-
|-
|||%tracknr2% – Track number (at least 2 digits)
|Number of the CD||||%cdnumber%||||%cdnumber%
|-
|-
|||%tracknr3% – Track number (at least 3 digits)
|Number of tracks on album||%x||%numtracks%||||%numtracks%
|-
|-
|||%totalcds% – Total number of CDs in the given CD set
|MP3 music genre||%m||%genre%||%I||%genre%
|-
|-
|||%cdnumber% – Number of the CD
|freedb music type||||||%B||%cddbtype%
|-
|-
|%x – Number of tracks on album||%numtracks% – Number of tracks on album
|Comment (as selected in EAC)|||%e||%comment%||||%comment%
|-
|-
|%m – MP3 music genre||%genre% – MP3 music genre
|'''Album artwork'''||||||||
|-
|-
|%e – Comment (as selected in EAC)||%comment% – Comment (as selected in EAC)
|Text “…” only when storing CD cover is enabled||%j…%j||%hascover%…%hascover% (only when storing CD cover is enabled and cover exists)||||
|-
|-
|'''Album artwork'''||
|Filename of CD cover image||%i||%coverfile%||||
|-
|-
|%j…%j – Text “…” only when storing cd cover is enabled||%hascover%…%hascover% – Text “…” only when storing cd cover is enabled and cover exists
|'''Lyrics'''||||||||
|-
|-
|%i – Filename of CD cover image||%coverfile% – Filename of CD cover image
|Text “…” only when lyrics exist||||%haslyrics%…%haslyrics%||||
|-
|-
|'''Lyrics'''||
|Lyrics||||%lyrics%||||
|-
|-
|||%haslyrics%…%haslyrics% – Text “…” only when lyrics exist
|Filename of lyrics text file (ANSI)||||%lyricsfile%||||
|-
|-
|||%lyrics% – Lyrics
|'''Other information'''||||||||
|-
|-
|||%lyricsfile% – Filename of lyrics text file (ANSI)
|Text “…” only when “CRC checksum” selected||%c…%c||%crcenabled%…%crcenabled%||||
|-
|-
|'''Other information'''||
|CRC of extracted track||%b||%trackcrc%||||
|-
|-
|%c…%c – Text “…” only when “CRC checksum” selected||%crcenabled%…%crcenabled% – Text “…” only when “CRC checksum” selected
|Track duration (minutes part)||||||||%lengthmin%
|-
|-
|%b – CRC of extracted track||%trackcrc% – CRC of extracted track
|Track duration (seconds part)||||||||%lengthsec%
|-
|-
|%f – freedb ID||%cddbid% – freedb ID
|Bitrate (“32″..”320″) [set in Compression Options]||%r||%bitrate%||||
|-
|-
|%r – Bitrate (“32″..”320″)||%bitrate% – Bitrate (“32″..”320″)
|freedb ID||%f||%cddbid%||%F||%cddbid%
|-
|-
|||%% – The ‘%’ character
|The ‘%’ character||||%%||||%%
|}
|}

Revision as of 11:30, 23 November 2011

Exact Audio Copy provides numerous placeholders to be used when invoking a command-line encoder and when naming output files.

Beginning with EAC version 1.0 beta 2, the naming scheme for placeholders was revamped, necessitating that users moving to this new version revise their command lines. Both old and new lists of placeholders and their meanings have long been available in the official EAC FAQ and in several of the Hydrogenaudio Knowledgebase’s own Guides; however, there was no easy way to look up values and to compare them between different versions.

Moreover, confusion can arise from the fact that versions of EAC prior to 1.0b2 used different placeholders for naming the output file compared to those for passing to the external encoder. These two sets of placeholders do not correspond, but they are similar enough to get mixed up.

For these reasons, as well as for general convenience and ease of use, this page intends to simplify the process of using (or comparing/substituting) placeholders, by collating all of those listed by the EAC FAQ into a single table.

Placeholders used in EAC
Property External Compression placeholders pre-1.0b2 External Compression placeholders in 1.0b2 and later Filename placeholders pre-1.0b2 Filename placeholders in 1.0b2 and later
Files
Source filename %s %source%
Destination filename %d %dest%
Original filename (without temporary renaming) %o %original%
Quality settings
Text “…” only when “High quality” selected %h…%h %ishigh%…%ishigh%
Common metadata
Track artist %a %artist% %A %artist%
Track title %t %title% %T %title%
CD artist %v %albumartist% %D %albumartist%
CD title %g %albumtitle% %C %albumtitle%
Track composer/performer %composer% %composer%
CD composer %albumcomposer% %albumcomposer%
CD performer %albuminterpret% %albuminterpret%
Year %y %year% %Y %year%
Track number %n %tracknr% (same as %tracknr2%) %N
Track number (at least 1 digit) %tracknr1% %tracknr1%
Track number (at least 2 digits) %tracknr2% %tracknr2%
Track number (at least 3 digits) %tracknr3% %tracknr3%
Total number of CDs in the given CD set %totalcds% %totalcds%
Number of the CD %cdnumber% %cdnumber%
Number of tracks on album %x %numtracks% %numtracks%
MP3 music genre %m %genre% %I %genre%
freedb music type %B %cddbtype%
Comment (as selected in EAC) %e %comment% %comment%
Album artwork
Text “…” only when storing CD cover is enabled %j…%j %hascover%…%hascover% (only when storing CD cover is enabled and cover exists)
Filename of CD cover image %i %coverfile%
Lyrics
Text “…” only when lyrics exist %haslyrics%…%haslyrics%
Lyrics %lyrics%
Filename of lyrics text file (ANSI) %lyricsfile%
Other information
Text “…” only when “CRC checksum” selected %c…%c %crcenabled%…%crcenabled%
CRC of extracted track %b %trackcrc%
Track duration (minutes part) %lengthmin%
Track duration (seconds part) %lengthsec%
Bitrate (“32″..”320″) [set in Compression Options] %r %bitrate%
freedb ID %f %cddbid% %F %cddbid%
The ‘%’ character %% %%