Plugins are extra-features for WinMerge. They are not included in the basic version because they interest few users, or because they do not fit in WinMerge architecture.
Each plugin :
is a single file, either a dll or a scriptlet (extension .sct)
is installed in the subdirectory "MergePlugins".
is easy to install : copy the plugin file in "MergePlugins", close WinMerge if it is running, and launch it again
"Plugins" is a generic name for extra-feature dll or scriptlets. Plugins features are spread over three categories : file editor complement, unpacker, prediffer.
Operate custom operations on the currently selected text from the active pane.
Example plugin : turn the selection to uppercase or lowercase.
The original file is not changed. A temporary transformed file is created and loaded in WinMerge.
Sometimes the transformed file can be packed back. Then you may merge and save the transformed file. Packing is done automatically in this case. See the plugin details to know if it supports packing back.
Example plugin : decompress Delphi4 binary files (extension .dfm).
![]() |
When you compare directories, WinMerge doesn't need to display the files, but the diffing process can give a different result when you compare compressed and not compressed files (for example, uncompressed files may be identical, but the compressed files may differ if they include the date of creation). WinMerge applies the unpacker in all situations, and you are sure to have the same result when you compare directories, or when you merge two versions of a file. |
The files are loaded normally. No change is applied to the displayed file. Copies are made and processed by the plugin, and the diffing algorithm operates on these copies.
Example plugin : ignore the differences inside given columns, while displaying the characters in these columns.
Each plugin specifies a list of file extensions (see plugins details for more info). When the file extension, either from the left or from the right file, matches the plugin list, the plugin is called "a suggested plugin".
When "Automatic mode" is on, WinMerge searches for a suggested plugin and applies it if it is avaialble. When two suggested plugins are available for a file, WinMerge applies the first one only (alphabetical order).
![]() |
" " and " " are two separate options. There is no option for editor complements. |
Not available
Access list with main menu,
-> ->Check
-> in the main menu. Update the results (F5). Each file is loaded again with its suggested unpacker and compared.Three possibilities
Open dialog : select the two files first. Then press the button "Unpacker". WinMerge displays the standard dialog for unpacker selection. Use the top combobox to select the plugin. Two generic choices are available also : "None" and "Automatic".
" right from the filed "From the directory view when
-> is checked : just double click to open the file. The suggested plugin used during the directory comparison is used to load the file in the editor.From the directory view, always : select one file, then main menu
-> . WinMerge displays the dialog for unpacker selection. Select an unpacker and press " ", WinMerge opens the editor view and applies this unpacker to load the file. This plugin is forgotten when you close the editor view.When the files are selected, right-click to open the context menu. Follow
-> and select " " or " ". Refresh the view (F5) to update the results.![]() |
" " is a per-file option. Some files in the same directory can be in mode " " and some in mode " ". When you change directory during a non-recursive compare, the mode is always reset to " ". |
Two possibilities
From the directory view when "
" is checked for a file : just double click to open the file. The plugin used during the directory comparison is used in the editor before the diff algorithm.During an editor session, access prediffer lists with menu
-> -> The active prediffer is checked. Suggested plugins are indicated first above the not-suggested ones. The files are compared again after the selection, you don't need to rescan.A file Plugins.txt is created during the setup process. It documents each installed plugin with the name and a quick description. If you don't use installer Plugins.txt is found from MergePlugins subfolder.
Developers may find information and code of examples in the source package, under the directory "Plugins".
Some editor complements need this optional component from Microsoft.
If the list of editor complements does not present all editor plugins, this component is probably missing.
You can check easily. WinMerge informs you with a comment at the bottom of the list.
You may install WSH on any version of Windows (need IE 4.0). Download it from MSDN Library.