2.7.2 Tag-Based Replacements

Tag-based replacement parameters:

ContentShort-FormLong-Form
albumLalbim
artistAartist
content typeGcontent-type,genre
encoded byeencoded-by
titleTtitle
yearYyear

Tag-based replacement parameters take the following options:

  1. Source of the replacement text:
    1. prefer-v2
    2. prefer-v1
    3. v2-only
    4. v1-only
  2. character encoding when the ID3v1 tag is used: v1-encoding=...
    1. auto
    2. iso-8859-1
    3. ascii
    4. cp1252
    5. utf-8
    6. utf-16-be
    7. utf-16-le
    8. utf-32
  3. Handling “The...”: the=...
    1. suffix (i.e. “The Pogues” will be changed to “Pogues, The”)
    2. prefix
  4. capitalization: cap=...
    1. all-upper
    2. all-lower
  5. handling whitespace: either compress can be given (to merge space between words to a single space) or ws=TEXT can be given to replace whitespace (e.g. if ws=_ were given, “a b” would become “a_b”.

Lastly, the year can be formatted as two digits or four by giving “yy” or “yyyy” in the options for %(year).

E.g. %(artist:prefer-v2&v1-encoding=cp1252&the=suffix&compress) applied to a file whose ID3v2 tag had an artist frame of "The Pogues" would produce "Pogues, The".