I would like to configure Visual Studio to open Beyond Compare by default as the diff tool. How can I do this?
11 Answers
In Visual Studio, go to the Tools menu, select Options, expand Source Control, (In a TFS environment, click Visual Studio Team Foundation Server), and click on the Configure User Tools button.

Click the Add button.
Enter/select the following options for Compare:
- Extension:
.* - Operation:
Compare - Command:
C:\Program Files\Beyond Compare 3\BComp.exe(replace with the proper path for your machine, including version number) - Arguments:
%1 %2 /title1=%6 /title2=%7
If using Beyond Compare Professional (3-way Merge):
- Extension:
.* - Operation:
Merge - Command:
C:\Program Files\Beyond Compare 3\BComp.exe(replace with the proper path for your machine, including version number) - Arguments:
%1 %2 %3 %4 /title1=%6 /title2=%7 /title3=%8 /title4=%9
If using Beyond Compare v3/v4 Standard or Beyond Compare v2 (2-way Merge):
- Extension:
.* - Operation:
Merge - Command:
C:\Program Files\Beyond Compare 3\BComp.exe(replace with the proper path for your machine, including version number) - Arguments:
%1 %2 /savetarget=%4 /title1=%6 /title2=%7
If you use tabs in Beyond Compare
If you run Beyond Compare in tabbed mode, it can get confused when you diff or merge more than one set of files at a time from Visual Studio. To fix this, you can add the argument /solo to the end of the arguments; this ensures each comparison opens in a new window, working around the issue with tabs.
-
20Note that for Beyond Compare 3, you should actually be using BComp.exe -- see scootersoftware.com/vbulletin/showthread.php?t=3461– JoeJul 13, 2011 at 15:28
-
7I updated this answer to support both Beyond Compare v3 Pro/Std and Beyond Compare v2 (v3 offers 3-way merge) and updated arguments from official BC website: scootersoftware.com/support.php?zz=kb_vcs Dec 8, 2011 at 20:36
-
35If you run Beyond Compare in tabbed mode, it can get confused when you diff or merge more than one set of files at a time from Visual Studio. To fix this, you can add the argument "/solo" to the end of the arguments; this ensures each comparison opens in a new window, working around the issue with tabs. Aug 23, 2012 at 22:49
-
19When using the Git add-in for Visual Studio, there is no Configure User Tools button. Anyone know a way to hook Git add-in to use beyond compare? Jun 2, 2013 at 4:20
-
9Beyond Compare 4 setup is the same, as is Visual Studio 2013. To support version 4, simply change the "3" in the COMMAND path to a "4". It's pretty obvious, but should be noted. For example, on my workstation, the path is: C:\Program Files (x86)\Beyond Compare 4\BCompare.exe Sep 11, 2014 at 16:21
Visual Studio with Git for Windows
If you're using GIT as your source code management system instead of the (fairly dated) TFVC then Visual Studio doesn't have options to configure anything like this.
Instead it (rightly in my opinion) uses the GIT config file's setting. So if you already have GIT setup to use Beyond Compare or any other third party comparison software it will just pick this up and start using it.
If not then just set that up (see here for further and likely more up to date help). The relevant info for setting up Visual Studio with Beyond Compare 4 is:
- Open Visual Studio.
- Select Options from the Tools menu.
- Select Plug-In Settings under the Source Control branch of the left-side tree control.
- Select Microsoft Git Provider under Plug-In Settings on the right-hand pane.
- Edit the global git config file (location is OS specific for windows it's
%HOMEDRIVE%%HOMEPATH%/.gitconfig. See here for info) OR if you want it to be repo specifict then after starting a project in a Git repository, edit the config file in the .git folder in the project folder. Change the config file to reflect the following changes:
[diff] tool = bc4 [difftool "bc4"] cmd = \"C:\\Program Files (x86)\\Beyond Compare 4\\BComp.exe\" \"$LOCAL\" \"$REMOTE\" [merge] tool = bc4 [mergetool "bc4"] cmd = \"C:\\Program Files (x86)\\Beyond Compare 4\\BComp.exe\" \"$REMOTE\" \"$LOCAL\" \"$BASE\" \"$MERGED\"
If 64bit installer is used, verify the name of the executable. Mine was BCompare.exe
[diff]
tool = bc4
[difftool "bc4"]
cmd = \"C:\\Program Files\\Beyond Compare 4\\BCompare.exe\" \"$LOCAL\" \"$REMOTE\"
[merge]
tool = bc4
[mergetool "bc4"]
cmd = \"C:\\Program Files\\Beyond Compare 4\\BCompare.exe\" \"$REMOTE\" \"$LOCAL\" \"$BASE\" \"$MERGED\"
Issues: If you create a new project and get VS to create the git repo at
the same time it WILL add a load of overrides to the .git/config file
forcing it to use Visual Studio again (Thanks for that MS!).
SO either create the git repo via another means after the project has been setup
(like via SourceTree or the command line etc...) OR edit the .git/config file
(in the solution folder) and remove any overrides for the above settings.
Thanks to minnow in the comments for bringing my attention to it again.
Note: I keep coming across this but I am using VS with GIT and the answers aren't correct and although some of the comments mention a URL with the correct answer it's not clear and if I kept missing it I'm sure others will so hopefully this will solve that issue.
-
1
-
2Careful though - VS 2015, for me, set itself up as the diff/merge tool in the local git config file in the local repo....thus overriding the global. Just remove the entries in the local repo config and you should be good.– JesterJan 23, 2016 at 15:25
-
7Haha just tried to vote up this AMAZING answer... then it said "You can't vote on your own answer"... OH LOL God bless not having a memory! ;)– GazBNov 28, 2016 at 13:04
-
6BC4 installed in a slightly different path, the 64b dir, on my machine:
\"C:\\Program Files\\Beyond Compare 4\\BComp.exe\"– GraehamFFeb 8, 2017 at 18:17 -
1I found that setting the global git config didn't work at all. I had to modify the repo's config. VS2017. Anyone else experiencing the same? And @GazB, I suspect GraehamF, like me, just has the 64-bit version of BC installed on 64-bit windows, so the installed path is the correct, expected Program Files and not PF(x86).– minnowDec 4, 2017 at 5:23
If you are using the TFS, you can find the more information in diff/merge configuration in Team Foundation - common Command and Argument values
It shows how to configure the following tools:
- WinDiff
- DiffDoc (for Word files)
- WinMerge
- Beyond Compare
- KDiff3
- Araxis
- Compare It!
- SourceGear DiffMerge
- Beyond Compare 3
- TortoiseMerge
- Visual SlickEdit
-
1No you can't because MicroShit doesn't know how to do redirects still in the 21st century. Dec 25, 2020 at 13:22
I got bored of doing this every 6 months when a new version of Visual Studio comes out, or I move PCs, or a new member joins the team. So, PowerShell:
# .Synopsys
# Sets up Beyond Compare professional as Diff tool for all instances of Visual Studio on this PC
# If you don't use TFS, change the sccProvider as appropriate
[CmdLetBinding()]
param(
$bcPath = 'C:\Program Files (x86)\Beyond Compare 3\BComp.exe',
$sccProvider = 'TeamFoundation'
)
$ErrorActionPreference = 'stop';
$baseKey = 'REGISTRY::\HKCU\Software\Microsoft\VisualStudio\*'
function SetRegKeyProperties($keyPath, [hashtable]$keyProps){
if(!(Test-Path $keyPath)){
Write-Verbose "Creating $keyPath"
# Force required here to recursively create registry path
[void] (new-item $keyPath -Type:Directory -Force);
}
foreach($prop in $keyProps.GetEnumerator()){
Set-ItemProperty -Path:$keyPath -Name:$prop.Key -Value:$prop.Value;
}
}
$configBases = dir $baseKey | ? { $_.PSChildName -match '^\d+\.\d$' }
foreach($item in $configBases){
Write-Host "Configuring $item"
$diffToolsKey = Join-Path $item.PSPath "$sccProvider\SourceControl\DiffTools"
SetRegKeyProperties (Join-path $diffToolsKey '.*\Compare') @{Command=$bcPath;Arguments='%1 %2 /title1=%6 /title2=%7'}
SetRegKeyProperties (Join-path $diffToolsKey '.*\Merge') @{Command=$bcPath;Arguments='%1 %2 %3 %4 /title1=%6 /title2=%7 /title3=%8 /title4=%9'}
}
Works on my machine. YMMV. No warranties, no refunds. VS doesn't appear to cache the key, so takes effect immediately.
-
1These days its $bcPath = 'C:\Program Files (x86)\Beyond Compare 4\BCompare.exe' for the latest version. So if only that was combined with the chocolatey install... (thanks by the way) Nov 7, 2014 at 9:23
-
This is great. Thanks so much for posting this information, will make life easier!– d3r3kkNov 19, 2015 at 16:48
-
1Probably should just update to read the Registry entry:
computer\hkey_local_machine\scooter software\beyond compare\exepath. Jun 9, 2016 at 16:14 -
Thanks, that is really useful! How would you do that with Visual Studio 2017 and newer? Because here a private registry is used (visualstudioextensibility.com/2017/07/15/…).– MaDevNov 10, 2021 at 15:20
In Visual Studio 2008 + , go to the
Tools menu --> select Options

In Options Window --> expand Source Control --> Select Subversion User Tools --> Select Beyond Compare
and click OK button..
-
2Note that the 'subversion' bits of this answer are specific to if you are using SVN as your source control provider.– piers7Jul 3, 2014 at 3:36
-
1
-
Probably helpful to the SVN folk though, eh? This can languish down here with a few votes, seems fine. Jul 8, 2022 at 20:15
The answer posted by @schellack is perfect for most scenarios, but I wanted Beyond Compare to simulate the '2 Way merge with a result panel' view that Visual Studio uses in its own merge window.
This config hides the middle panel (which is unused in most cases AFAIK).
%1 %2 "" %4 /title1=%6 /title2=%7 /title3="" /title4=%9
With thanks to Morgen
I'm using VS 2017 with projects hosted with Git on visualstudio.com hosting (msdn)
The link above worked for me with the "GITHUB FOR WINDOWS" instructions.
http://www.scootersoftware.com/support.php?zz=kb_vcs#githubwindows
The config file was located where it indicated at "c:\users\username\.gitconfig" and I just changed the BC4's to BC3's for my situation and used the appropriate path:
C:/Program Files (x86)/Beyond Compare 3/bcomp.exe
VS2013 on 64-bit Windows 7 requires these settings: Tools | Options | Source Control | Jazz Source Control
CHECK THE CHECKBOX Use an external compare tool ... (easy to miss this)
2-Way Compare Location of Executable: C:\Program Files (x86)\Beyond Compare 3\BCompare.exe
3-Way Conflict Compare Location of Executable: C:\Program Files (x86)\Beyond Compare 3\BCompare.exe
BComp.exe works in multiple-tabbed scenario as well, so there is no need to add /solo unless you really want separate windows for each file comparison. Tested/verified on Beyond Compare 3 and 4. Moral: use BComp.exe, not BCompare.exe, for VS external compare tool configuration.
I use BC3 for my git diff, but I'd also add vscode to the list of useful git diff tools. Some users prefer vscode over vs ide experience.
Using VS Code for Git Diff
git config --global diff.tool vscode
git config --global difftool.vscode.cmd "code --wait --diff $LOCAL $REMOTE"
Can't comment because my reputation score is low.
Here's a waybackmachine link to Fresky's link