How to Remap Characters for Auto-Organize

MediaMonkey can write almost any character when writing a filename, except for those characters that are considered illegal by an operating system. In such cases, MediaMonkey substitutes unsupported characters with ‘similar’ ones that are supported. For instance ‘?’ or ‘*’ are illegal characters in a filename, and can be substituted with ‘-‘. These substitutions occur based on a substitution table defined within the MediaMonkey.ini file. The table is in the [FilenameMappings] section of the MediaMonkey.ini file, and hexadecimal values are used to define the source character and characters to which they are mapped. Note that character definitions must be in the form of UTF-8 encoded strings in hexadecimal form (those that aren’t will be automatically removed on restart of MediaMonkey). For example:


In this example, 3A=2D means that “:” is mapped to “-“. If you wish to look up the hexadecimal values of characters, you can do so via the “Character map” application included with Windows. To change the substitution table to better suit your needs:

  1. Close MediaMonkey (so that it doesn’t overwrite any of the changes)
  2. Back up the MediaMonkey.ini file.
  3. Open the MediaMonkey.ini file inside a text editor such as Notepad, edit the [FilenameMappings] section as required, and save it.
  4. Start MediaMonkey


  • To ensure that metadata containing a ‘\’ doesn’t create a new directory when using auto-organize, add the following mapping: 5C=2D

Applies to: ,

Was this article helpful?