---

2.5.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:

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