---

2.7.2 Tag-Based Replacements ¶

Tag-based replacement parameters:

Content	Short-Form	Long-Form
album	L	albim
artist	A	artist
content type	G	content-type,genre
encoded by	e	encoded-by
title	T	title
year	Y	year

Tag-based replacement parameters take the following options:

• Source of the replacement text:
  • prefer-v2
  • prefer-v1
  • v2-only
  • v1-only
• character encoding when the ID3v1 tag is used: v1-encoding=...
  • auto
  • iso-8859-1
  • ascii
  • cp1252
  • utf-8
  • utf-16-be
  • utf-16-le
  • utf-32
• Handling “The...”: the=...
  • suffix (i.e. “The Pogues” will be changed to “Pogues, The”)
  • prefix
• capitalization: cap=...
  • all-upper
  • all-lower
• 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".