Search code examples
gitsettingswinmergegit-extensions

How to use Winmerge with Git Extensions?


I'm using Git Extensions and it pre-installs and sets up KDiff as the diff tool to solve merge conflicts. I'm very fond of Winmerge though and would like to replace KDiff with Winmerge.

In the Git Extensions settings, there are settings to change the Mergetool, but I can't seem to figure out what syntax I should use and why. There seem to be 4 variables: $BASE, $LOCAL, $REMOTE, $MERGED. It seems that I should pass these to WinMergeU.exe, but with which command line parameters?

I've tried to search for this a few times, but there is no answer that actually seems to work.


Solution

  • Overview
    The following is instructions on how to setup GIT Version Control so that you can use a better set of tools than the default installation. The setup requires that GIT Extensions is already installed and involves configuring Winmerge in GIT extensions.

    Installation
    Walk through all the prompts and install in the default directory for Winmerge.

    Configure Winmerge in GIT Version Control
    Open a new doc in a text editor. Copy/paste the following and save the document as "wMerge.sh" to your "C:\Program Files (x86)\Git\bin\" directory.

    echo Launching WinMerge: $1 $2 "C:/Program Files (x86)/WinMerge/WinMergeU.exe" -e -u -dl "Original" -dr "Modified" "$1" "$2"
    

    Goto your "Users->username" directory and locate the .gitconfig file. Open it in your favorite editor copy/paste the following code and Save:

    [user]
        name = enter your name
        email = youremail@yourdomain.com
    [core]
        autocrlf = false
    [merge]
        tool = winmerge
    [mergetool "winmerge"]
        cmd = wMerge.sh \"$MERGED\" \"$REMOTE\"
        path = c:/Program Files (x86)/winmerge/winmergeu.exe
    [mergetool]
        keepBackup = false
        trustExitCode = false
    [diff]
        guitool = winmerge
    [difftool "winmerge"]
        path = c:/Program Files (x86)/winmerge/winmergeu.exe
        cmd = \"c:/Program Files (x86)/winmerge/winmergeu.exe\" \"$LOCAL\" \"$REMOTE\"
    

    Run "GitExtensions", goto "tools->Settings->Git Extensions->Git Config". If you've done your installation properly and referenced the tools to their directory, your global settings page should look like below (NOTE: Please fill in your name on name and email):

    mergetool: winmerge
    path to mergetool: c:/Program Files (x86)/winmerge/winmergeu.exe
    mergetool command: wMerge.sh "$MERGED" "$REMOTE"
    difftool: winmerge
    path to difftool: c:/Program Files (x86)/winmerge/winmergeu.exe
    difftool command: "c:/Program Files (x86)/winmerge/winmergeu.exe" "$LOCAL" "$REMOTE"

    line endings: checkout as-is, commit as-is

    Navigate to the checklist tab to verify that GIT is all "green" and satisfied with your setup.