Using FileMerge as a diff command for Subversion
Shell Makefile
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Using FileMerge as a diff command for Subversion

These scripts were created by Bruno De Fraine. The official website (and official version) can be found at:


Subversion principally uses the copy-modify-merge versioning model to allow concurrent collaboration on the same set of files. For this to work well, it is crucial to have good tools to view and merge the differences between files.

The built-in diff and diff3 tools (from diffutils) go a long way to provide this functionality for text files on the command line. They do have some limitations though, including:

  • Worthless to find interline changes in long lines
  • Output of diff can be hard to read
  • No interactive merge support

Apple's Developer Tools for Mac OS X include FileMerge, a graphical tool to compare and merge files. FileMerge can be much handier to use; unfortunately, it doesn't integrate with Subversion straightforwardly. It can be opened from the command line with the opendiff command, but its interface differs from that of diff and diff3. It returns immediately (i.e. it forks and does not block) and it expects different arguments. Some wrapper scripts are thus required to call FileMerge from Subversion.

FileMerge in action

Wrapper Scripts for FileMerge

Bash scripts for this task can be checked-out from this repository or downloaded as an archive.

Four scripts are provided: fmdiff, fmdiff3, fmresolve and fmmerge. They are described below. The location of FileMerge is determined through a symbolic link in the PATH environment. The included Makefile can create this link by checking a number of standard locations:

$ make
Afterwards, you can do the following to install all of the scripts in /usr/local/bin:

$ sudo make install


fmdiff has an interface similar to diff and can be used with Subversion's --diff-cmd option. The canonical case is:

$ svn diff --diff-cmd fmdiff <other diff options, files or URLs>

Subversion will start FileMerge for each file with differences. It will wait for you to quit FileMerge (⌘-Q) to clean up and show the next file (if any). The script cannot show the labels from Subversion in FileMerge. As a resort, it will print these on the command line:

Starting FileMerge...
Left: lock.c (revision 14670)
Right: lock.c (revision 14675)

Additionally, if fmdiff finds that you have growlnotify installed, it will use this to show a similar message as a Growl notification.

Advanced tip: The merge pane at the bottom of the FileMerge window is normally not used for fmdiff. However, when fmdiff detects that the right-hand file is part of a working copy, it will instruct FileMerge to use this right-hand file as the merge file as well. This means that you can compose a new version of this file in the merge pane by accepting or rejecting the changes that have occurred. When you instruct FileMerge to save (⌘-S), the right-hand file will be replaced with the new version from the merge pane.


Unsurprisingly, fmdiff3 is the diff3-equivalent of fmdiff. It can be used with Subversion's --diff3-cmd option.

diff3 will merge the changes from two different versions that have a common ancestor. It is used by Subversion on an update (to merge changes from the repository with local changes) or a merge operation. Suppose that you have made local changes in a working copy and that meanwhile the repository was updated. To merge your local changes with those of the repository in FileMerge, do:

$ svn update --diff3-cmd fmdiff3

Note: By using the ancestor information, diff3 can merge the changes automatically, provided that there are no conflicting changes. The standard diff3 merge is therefore non-interactive. If conflicts do occur, they are marked in brackets, and Subversion expects you to resolve the conflicts later on, after the (partial) merge. fmdiff3, in contrast, does the merge interactively and completely. First, It will fire up FileMerge with the relevant ancestor information, and FileMerge will merge the non-conflicting changes by itself on startup. fmdiff3 then expects that you complete the merge by resolving the conflicts through FileMerge's facilities. When you save the merged version (⌘-S) and quit FileMerge (⌘-Q), the result is given back to Subversion as a completely merged version. So the conflict state is not needed anymore.

FileMerge interactive merge with conflict


Whereas fmdiff3 can be useful when you anticipate conflicts during an update or a merge, it's sometimes unpractical that you have to decide to use FileMerge a priori. When you did a standard update or merge using the built-in diff3, and you are faced with one or more files in conflicting state, fmresolve allows to use FileMerge a posteriori to resolve the conflicts.

$ fmresolve <conflictfile>

This will start FileMerge with the appropriate versions and ancestor to reinitiate the merge. Non-conflicting changes are resolved automatically at startup; you can then resolve the remaining changes. After you save (⌘-S) and quit FileMerge (⌘-Q), you can signal to Subversion that the conflicts were resolved:

$ svn resolved <conflictfile>

fmmerge (Subversion 1.5)

Starting from version 1.5, Subversion supports interactive conflict resolution. That means that the above description of an update scenario is no longer entirely accurate: when Subversion detects conflicting changes during an update, it will provide an interactive menu with several options. If you select the postpone option (p), the old behavior is applied, and you may still use fmresolve to resolve the conflict later on.

However, you can also choose to resolve the conflict immediately, either by accepting one version entirely (and discarding the changes in the other version), or by launching an external tool with the launch option (l). fmmerge is a wrapper to use FileMerge as such an external merge tool. It can only be activated through the Subversion configuration file (see below), where it must be configured as the variable merge-tool-cmd.

Using FileMerge Permanently

You can configure the fmdiff scripts to be used permanently, by setting the options diff-cmd and diff3-cmd in the "editors" section of the runtime config file (i.e. ~/.subversion/config). After this change, you no longer have to include the --diff-cmd and --diff3-cmd options when invoking Subversion.

More info: Subversion Book - Runtime Config Area.


These scripts are released in the public domain. Feel free to use them for any purpose. All material is provided without warranty of any kind.


Send comments and bugs to Bruno De Fraine.

Last Modified: <script type="text/javascript">document.write(new Date(document.lastModified));</script>