| Magic File Renamer Help

Index > Reference > Filters > Formatting Filters > Token Mover Filter

This filter allows you easily switch places for tokens (name parts) in names. For example, you can switch the Artist and Track Title parts for a music file.
First, you should decide what will be the Token Seperator String. This string is used to separate names into tokens (parts). For example, it the seperator string is -, the name `Artist-Album-Title` will be divided into three tokens: `Artist`, `Album`, `Title`.
Token number to move: Select which token out of the defined tokens you would like to move. Token number must not exceed the number of tokens in each name.
Places to move: Select the distance and direction to move the token to. Use positive values for moving right, and negative values for moving left. Distance is measured in tokens. For example: Use -1 to switch the token with it's preceding token.
If distance exceeds start / end of name, token will be moved to the first / last place respectively.
Can be applied on any text field.
Example:
Move Token #2 in 3 places forward. Token Seperator string is "`,`".
`milk,sugar,bread,potatoes,honey,salt,water >>> milk,bread,potatoes,honey,sugar,salt,water`
`milk,sugar,bread,potatoes >>> milk,bread,potatoes,sugar`