| Magic File Renamer Help

Index > Reference > Filters > Replacing Filters > Replacer Filter

This filter perform search & replace opeartion on names.

- Replace Text box
  - Here you should input the string you want to search for.
  - Should contain a regular expression if Use regular expressions is checked.
- With Text box
  - Here you should input the string you want use as a replacement for occurrences of the searched string.
  - You can leave the With text box empty, to strip (remove) occurrences of the searched string.
  - The With text box may contain a format string with formatting parameters.
- Match Case
  - When checked, only occurrences that matches the exact letters casing of the search string will be replaced.
- Replace only first occurrence
  - When checked, only the first occurrence of the search string in each name will be replaced.
- Replace only whole words
  - When checked, only occurrences of the search string which forms a whole word, will be replaced.
  - For an occurrence to form a whole word, the couple of characters before and after it should not be letters or digits.
  - This option cannot be combined with the Use regular expressions option.
- Use regular expressions
  - This option allows you to search for a pattern instead of a literal string and perform an advanced search and replace.
  - When checked, search string will be treated as a Regular Expression.
  - You will be able to use the menu buttons in the right side of the Search and With text boxes to input common regular expression tokens.
  - The With text box may contain "$n" tokens, if the search regular expression performs capturing.
  - If seacrch regular expression is not valid, the Replacer Filter will be disabled.
  - See Regular Expressions Reference for more details.
- Can be applied on any text field.

Examples:
Replace `"dog"` with `"cat"`, replace only whole words:
`The dogs ran away from the big dog >>> The dogs ran away from the big cat`
Replace `"\((.+)\)"` with `"$1"`, use regular expressions:
`aaa (bbb) ccc >>> aaa bbb ccc`