| Magic File Renamer Help

Index > Reference > Filters > Replacing Filters > Replace List Filter

This filter let you perform multiple search & replace operations from a replace list file.
The effect is like adding multiple instances of the Replacer Filter to the Applied Filters List.

- You must select a replace list file that contains search & replace pairs.
  Press the "..." button to browse for a replace list file, or press the New button to create a new replace list file. A newly created replace list file contains some example search & replace pairs.
- Replace List file format should be:
  `\\ comments [optional comments line(s) can be anywhere inside file]
  Search String
  Replace String
  <empty line(s)>
  Search String
  Replace String
  <empty line(s)>
  ...`
- Number of search & replace pairs is not limited.
- You can input empty line instead of a replace string to "strip" the search string.
- Search strings may contain regular expressions if Use regular expressions is checked.
- Replace strings may be format strings with formatting parameters.
- If replace list file is changed, you must click the Reload Button to reflect the changes.
- See Replacer Filter for Options information.
- Can be applied on any text field.

Example:
Replace list file contents:
`\\ START OF REPLACE LIST
a
b
.
_
[0-9]+
<counter:10,1,0,2,0>
\\ END OF REPLACE LIST`
'Use regular expressions' is checked.
`01.-.Blue.Train >>> 10_-_Blue_Trbin
02.-.A.Moment's.Notice >>> 11_-_b_Moment's_Notice`