TransTools Migration Utility

If you are a user of TransTools or TransTools+, you may need to copy TransTools/TransTools+ settings and configuration files to another computer, create their backup, restore them on the same computer, etc. TransTools Migration Utility makes it easy to do this. It can create a migration pack containing the settings and configuration files for TransTools/TransTools+ tools installed on your computer, and then restore these settings / files on the same or different computer at any time from a migration pack file.

Here are some examples of what you can do with TransTools Migration Utility:

  1. Transfer TransTools/TransTools+ settings/configuration files to your colleague.
  2. Back up your TransTools/TransTools+ settings/configuration files to avoid losing them in the event of a system failure.
  3. Restore TransTools/TransTools+ settings/configuration files after a system failure.
  4. Prepare for a planned upgrade of your computer and restore TransTools/TransTools+ settings/configuration files after the upgrade is completed.

Download and Installation

There are 2 ways to get TransTools Migration Utility up and running:

  1. Download the latest installation file for TransTools or TransTools+ and install it. TransTools Migration Utility is included in TransTools v.3.32 and TransTools+ 2.2 (if you are using version 2) or 1.11 (if you are still using version 1), or in any newer versions of these packages. Once you have installed TransTools or TransTools+, the easiest way to find TransTools Migration Utility is to use Windows Search bar or the search field in Windows Start menu, typing "TransTools Migration Utility". You can also find MigrationUtility.exe executable file under C:\Users\<username>\AppData\Local\TransTools+\Migration Utility\ folder for TransTools+ or under C:\Users\<username>\Documents\TransTools\Migration Utility\ folder for TransTools.
  2. Download a separate ZIP package containing TransTools Migration Utility and unzip it to a folder of your choice. You will then be able to run TransTools Migration Utility by double-clicking MigrationUtility.exe executable file.

TransTools Migration Utility requires .NET Desktop Runtime v.6 from Microsoft. If this runtime is not yet installed on your computer and you run TransTools Migration Utility, you will be prompted to download it. However, this does not always happen, especially on older versions of Windows such as Windows 7 or Windows 8. In this case, go to https://dotnet.microsoft.com/en-us/download/dotnet/6.0, find the section called ".NET Desktop Runtime 6.#", and then click x64 link if you have a 64-bit version of Windows or x86 link if you have a 32-bit version of Windows (Arm64 version is also available). You can also download .NET Desktop Runtime v.6 from this link for a 64-bit version or this link for a 32-bit version. Once the download is completed, run the downloaded installer and follow the prompts to complete the installation.

Also make sure that you have one of the following Windows versions: Windows 11 or newer version, Windows 10, Windows 8.1, Windows 7 SP1 with Extended Security Updates installed.

Using TransTools Migration Utility

If you have installed TransTools or TransTools+ from an installation program, the easiest way to run TransTools Migration Utility is to use Windows Search bar or the search field in Windows Start menu, typing "TransTools Migration Utility". You can also run MigrationUtility.exe executable file located under C:\Users\<username>\AppData\Local\TransTools+\Migration Utility\ folder for TransTools+ or under C:\Users\<username>\Documents\TransTools\Migration Utility\ folder for TransTools.

When you run TransTools Migration Utility, you will see the following screen:

Selecting the required operation

On the first screen, select the required operation: (1) Create a migration pack containing TransTools/TransTools+ settings and configuration files, or (2) Restore TransTools/TransTools+ settings and configuration files within the current Windows user profile from an existing migration pack.

Creating a new migration pack

To create a new migration pack, select the first choice (Create a migration pack containing TransTools/TransTools+ settings and configuration files) and click the Next button. You will be presented with a list of all TransTools+ and TransTools tools whose settings are found within the current Windows user profile (i.e. under the current Windows logon name):

Selecting tools to include in the migration pack

Note: You will not be able to proceed to this step unless TransTools or TransTools+ is installed.

You can check or uncheck the boxes in this list if you would like the migration pack to include specific tools' settings only. Click the Next button to proceed to the next step where you will need to select the location of the new migration pack. This can be a new file or an existing file.

New migration pack location

Select the location of the migration pack and click the Next button to finish. You should see a report about successful creation of the migration pack.

Restoring from an existing migration pack

To restore settings from an existing migration pack, select the second choice (Restore TransTools/TransTools+ settings and configuration files from an existing migration pack) and click the Next button. You will be prompted to select the location of the migration pack file containing TransTools/TransTools+ settings and configuration files created with TransTools Migration Utility:

Selecting a migration pack to restore settings from

Note: You will not be able to proceed to this step unless TransTools or TransTools+ is installed. So, you must install TransTools and/or TransTools+ before you can apply a migration pack.

When you select an existing migration pack and click the Next button, you will see a list of all TransTools and TransTools+ tools included in the migration pack:

Selecting tools to apply settings/configuration files on the current system

If you want to apply the configuration of specific tools only, you can check or uncheck the relevant checkboxes at this step. Then, click the Next button.

At the next optional step, you may see a list of TransTools / TransTools+ configuration files that are present in the current user profile but missing in the migration pack. The Migration Utility will ask you whether to keep those files or delete them. For example, you may have created a new list of search expressions for TransTools+ Multiple Find & Replace tool recently (which is missing in the migration pack being restored) and you might want to keep this list for future use while applying configuration settings from the migration pack. By default, such files will be preserved, but you can check the boxes on this screen to delete such files.

Deciding which files to delete
List of configuration files present on the current system but missing in the migration pack

At the next step, you will be given a choice to back up the current configuration settings and files of TransTools and TransTools+. If you want to do this, leave the checkbox checked and select the location of a migration pack which will contain the current configuration of TransTools and TransTools+. Otherwise uncheck the checkbox.

Backing up the existing configuration of TransTools/TransTools+

When you click the Next button, TransTools Migration Utility will apply the configuration settings from the migration pack, including configuration files. When the operation is completed, you will see a success report.

Troubleshooting

If you see an error message during installation or usage of the application, please submit the application log file located at C:\Users\<username>\AppData\Roaming\TransTools Migration Utility\Log along with screenshots. Also, please include a short summary to help understood when the error message took place.

Here are some possible issues:

  • TransTools Migration Utility fails to open: 1) Check the requirements in the Download and Installation section above. 2) Make sure that your antivirus program is not blocking TransTools Migration Utility – some antivirus programs may block rare applications from running even though they have been thoroughly checked for viruses and malicious code.
  • There are errors when restoring configuration from a migration pack: make sure that the migration pack being restored was created with TransTools Migration Utility. Even though migration packs have ZIP file extension, TransTools Migration Utility will reject ZIP files which were not created with TransTools Migration Utility.