Integrating with Source Control, Configuration Management, and Other Applications

Merge for macOS integrates with most version control (VC), software configuration management (SCM) and other applications that allow a third-party file comparison (diff) or file merging tool to be specified. This topic contains instructions for integrating Merge with the following applications:

Integration with many SCM systems requires the Professional Edition of Merge to enable the comparison of two modified versions of a file with their common ancestor.

Other applications

If your chosen application isn’t listed in this topic, you may find the information for integrating Merge for Windows with other applications to be a helpful starting point. You may also be able to integrate Merge with another application yourself, using the Merge AppleScript API or command-line utility.

If you have instructions for integrating Merge with other systems, or corrections to the information presented below, please contact us to let us know so that we can update this list.

Android Studio

Android Studio can be configured to use Merge for file and folder comparisons, and also for file merging. The instructions below have been tested with version 2021.3.1 of Android Studio.

To configure Android Studio to use Merge as the file and folder comparison tool:
  1. Choose Android StudioPreferences….

  2. In the Preferences window that appears, select ToolsDiff & MergeExternal Diff Tools from the list on the left-hand side.

  3. Check the Enable external diff tool checkbox and configure the following:

    Path to executable: /Applications/Araxis Merge.app/Contents/Utilities/compare Parameters: -3 -a3 %1 %2 %3

  4. Check the Use by default checkbox.

  5. Click the Test Diff button. An Araxis Merge window should appear with a 2-way comparison. Close the comparison.

  6. Click the Test Three-Side Diff button. An Araxis Merge window should appear with a 3-way comparison. Close the comparison.

To configure the Android Studio to use Merge as the merging tool:
  1. Choose Android StudioPreferences….

  2. In the Preferences window that appears, select ToolsDiff & MergeExternal Diff Tools from the list on the left-hand side.

  3. Check the Enable external merge tool checkbox and configure the following:

    Path to executable: /Applications/Araxis Merge.app/Contents/Utilities/compare Parameters: -3 -a2 -title1:Theirs -title2:Ancestor -title3:Yours %2 %3 %1 %4

  4. Ensure that the Trust process exit code checkbox is unchecked. The exit code from compare does not indicate whether the output file has been updated.

  5. Click the Test Merge button. A Merge window should appear with a 3-way comparison. Close the comparison.

  6. In the Merge In External Tool dialog, click the Mark as Resolved button.

  7. In the Test Complete dialog, click the OK button.

If Araxis Merge is used to make changes to a file that Android Studio has stored in memory, perhaps following a merge operation, Android Studio may ask whether you wish to keep the file it has in memory or update it with the contents of the modified file on disk. It is most likely you will want to load changes from disk following a merging operation.

AccuRev

The AccuRev macOS client can be configured to use Araxis Merge for file comparison and merge operations.

These steps are believed to work with AccuRev 5.2.

To configure the AccuRev client to use Merge for file comparison:
To configure the AccuRev client to use Merge for file merging:

Cornerstone

Zennaware Cornerstone is a Subversion client that has built-in support for Merge. The following instructions have been tested with Cornerstone v2.7.9.

To configure Cornerstone to use Merge:

Dreamweaver

Adobe (Macromedia) Dreamweaver CS6 integrates with Araxis Merge and can launch a two-way file comparison. Consequently, the Standard Edition of Merge is sufficient if you will be using it only with Dreamweaver.

The following instructions have been tested with Dreamweaver CS6 v12.0.

To configure Dreamweaver CS6 to use Merge as the file comparison tool:

Eclipse

For Eclipse , see the entry for Subclipse.

Git

See Integrating with Git.

JetBrains Aqua, AppCode, CLion, DataGrip, DataSpell, GoLand, IntelliJ IDEA, MPS, PhpStorm, PyCharm, Rider, RubyMine, and WebStorm

JetBrains Aqua , AppCode , CLion , DataGrip , DataSpell , GoLand , IntelliJ IDEA , MPS , PhpStorm , PyCharm , Rider , RubyMine , and WebStorm can be configured to use Merge for file and folder comparisons, and also for file merging. The instructions below have been tested with versions 2022.2 and 2022.3 of these JetBrains IDEs.

To configure these JetBrains IDEs to use Merge as the file and folder comparison tool:
  1. From the application menu, choose Preferences… (2022.2 and earlier) or Settings… (2022.3 and later).

  2. In the Preferences or Settings window that appears, select ToolsDiff & MergeExternal Diff Tools from the list on the left-hand side.

  3. Check the Enable external tools checkbox.

  4. Under Configure external tools, click the + button.

  5. In the Add An External Tool window, configure the following:

    Tool group: Diff tool Program path: /Applications/Araxis Merge.app/Contents/Utilities/compare Tool name: Araxis Merge Argument pattern: -3 -a3 %1 %2 %3

  6. Click the Test Diff button. An Araxis Merge window should appear with a 2-way comparison. Close the comparison.

  7. Click the Test Three-Side Diff button. An Araxis Merge window should appear with a 3-way comparison. Close the comparison.

  8. In the Configure external diff/merge tools associated with a file type table, in the Default row, select Araxis Merge as the diff tool.

To configure these JetBrains IDEs to use Merge as the merging tool:
  1. From the application menu, choose Preferences… (2022.2 and earlier) or Settings… (2022.3 and later).

  2. In the Preferences or Settings window that appears, select ToolsDiff & MergeExternal Diff Tools from the list on the left-hand side.

  3. Check the Enable external tools checkbox.

  4. Under Configure external tools, click the + button.

  5. In the Add An External Tool window, configure the following:

    Tool group: Merge tool Program path: /Applications/Araxis Merge.app/Contents/Utilities/compare Tool name: Araxis Merge Argument pattern: -3 -a2 -title1:Theirs -title2:Ancestor -title3:Yours %2 %3 %1 %4

  6. Ensure that the Trust process exit code checkbox is unchecked. The exit code from compare does not indicate whether the output file has been updated.

  7. Click the Test Merge button. A Merge window should appear with a 3-way comparison. Close the comparison.

  8. In the Merge In External Tool dialog, click the Mark as Resolved button.

  9. In the Test Complete dialog, click the OK button.

  10. In the Add An External Tool window, click the OK button.

  11. In the Configure external diff/merge tools associated with a file type: table, in the Default row, select Araxis Merge as the merge tool.

If Araxis Merge is used to make changes to a file that a JetBrains IDE has stored in memory, perhaps following a merge operation, a JetBrains IDE may ask whether you wish to keep the file it has in memory or update it with the contents of the modified file on disk. It is most likely you will want to load changes from disk following a merging operation.

MacHg

MacHg is a fully featured free Mercurial client for macOS. MacHg provides built-in support for Araxis Merge.

The following instructions have been tested with MacHg v0.9.25.

To configure MacHg to use Merge:

Mercurial

Merge integrates tightly with Mercurial . Araxis provides a Mercurial File-System Plugin to enable Merge to access files in Mercurial depots directly. Merge is also able to populate the Versions button drop-down versions menu with other revisions of each file being compared. For more information, see Comparing Text Files (or Typed/Pasted Text).

Mercurial can also be configured to use Merge for file/folder comparison and file merge operations. The comparison integration uses the Extdiff extension , which is supplied with Mercurial.

The following instructions have been tested with Mercurial v1.8.4.

To configure Mercurial to use Araxis Merge for file merging:
To configure Mercurial to use Araxis Merge for file comparison:
Examples of using hg arxdiff:

Path Finder

Path Finder can be configured to use Araxis Merge for file comparison. Allowing the launching of Merge from Path Finder’s Compare… context menu when two files are selected.

The following instructions have been tested with Path Finder 7.

To configure Path Finder to use Merge for file comparison:

Perforce

Merge integrates tightly with Perforce .

To browse Perforce repositories directly from Merge (deprecated):
To configure P4V (2007.2 release or later) to use Merge for file comparison and merging:
To configure the Perforce command-line tool (p4) to use Merge:

SmartGit/Hg

SmartGit/Hg can be configured to use Araxis Merge for file comparison and merge operations.

To configure SmartGit/Hg to use Araxis Merge for file comparison:
To configure SmartGit/Hg to use Araxis Merge for file merging:

SmartSVN/SmartCVS

SmartSVN and SmartCVS clients can be configured to use Araxis Merge for file comparison and merge operations.

Note that the ability to use an external tool for solving conflicts is not available in the Foundation version of SmartCVS.

The following instructions have been tested with SmartSVN v7.5.4.

To configure SmartSVN/SmartCVS to use Araxis Merge for file comparison:
To configure SmartSVN/SmartCVS to use Araxis Merge for file merging:

SourceTree

Atlassian SourceTree is a client for Git and Mercurial. The following instructions have been tested with SourceTree v1.6.0.

To configure SourceTree to use Merge for comparing files:
To configure SourceTree to use Merge for merging files:

Subclipse

Subclipse is an Eclipse plugin providing support for Subversion within the Eclipse IDE. It can be configured to use Merge as its merging tool. Merge will then be used whenever you choose Edit Conflicts from a Team menu in Eclipse.

Merge can also integrate directly with Subversion. Please see Subversion section for more information.

The following steps have been tested with Subclipse v1.8.18, Eclipse v4.2.1 and Subversion v1.6.18

To configure Merge as the Subclipse file merging tool:

Subversion

Merge integrates well with Subversion . Araxis provides a Subversion File-System Plugin to enable Merge to browse Subversion repositories directly. This means that, for example, you can compare branches of source code directly within a repository without syncing them to the client workspace. Merge is also able to populate the Versions button drop-down versions menu with other revisions of each file being compared. For more information, see Comparing Text Files (or Typed/Pasted Text).

See also the entries for Subversive, svnX and Subclipse.

To browse Subversion repositories directly from Merge:
To configure the Subversion command-line tool (svn) to use Merge:

The following instructions have been tested with Subversion v1.6.18 and v1.7.8.

Subversive

Subversive , the official Eclipse plugin can be configured to use Merge as its merging tool. It provides support for Subversion within the Eclipse IDE. Merge will then be used for file comparisons, and for merging whenever you choose Edit Conflicts from a Team menu in Eclipse.

Merge can also integrate directly with Subversion. Please see Subversion section for more information.

The following steps have been tested with Subversive v1.0.0, Eclipse v4.2.1 and Subversion v1.6.18

To configure Merge as the Subversive file comparison and merging tool:

Surround SCM

Surround SCM has built-in support for Araxis Merge. To set Araxis Merge as the default application for file comparison and merging:

Please see the Surround SCM website for more details.

svnX

svnX is an open source GUI for most features of the Subversion client. It has built-in support for Merge.

To configure svnX to use Merge:

TortoiseHg

TortoiseHg can be configured to use Araxis Merge for file comparison and merge operations.

To configure TortoiseHg to use Araxis Merge for file comparison:
To configure TortoiseHg to use Araxis Merge for file merging:

Tower

Tower is a client for Git that can be easily configured to use Araxis Merge as its preferred comparison and merging tool. The following instructions have been tested with Tower v1.5.0.

To configure Tower to use Merge:

Veracity

Veracity is an Open Source, distributed version control and bug tracking system for Windows, macOS, and Linux. SourceGear, the company behind Veracity, has helpfully provided the information here.

Veracity supports Araxis Merge out of the box for both diff and merge operations. Simply use --tool araxis with any command that supports external comparison or merging tools. Alternatively, you can configure Merge as your default tool for various operations as described below.

For support using Veracity with Araxis Merge, please see http://veracity-scm.com/qa .

To make Araxis Merge the default interactive comparison tool for text files:
vv config set filetoolbindings/diff/:text/gui araxis
To make Araxis Merge the default interactive comparison tool for binary files:
vv config set filetoolbindings/diff/:binary/gui araxis
To make Araxis Merge the default interactive merging tool for text files:
vv config set filetoolbindings/merge/:text/resolve araxis
To make Araxis Merge the default interactive merging tool for binary files:
vv config set filetoolbindings/merge/:binary/resolve araxis

Versions

The Versions client for Subversion can be easily configured to use Araxis Merge. The following instructions have been tested with Versions v1.2.2.

To configure Merge as the Versions comparison tool: