Please enable JavaScript to view this site.

Beyond Compare

Navigation: » No topics above this level «

Command Line Reference

Scroll Prev Top Next More Links

Command-line executable files





This is the main application.  Only one copy will run at a time, regardless of how many windows you have open.  If you open a second copy, it will tell the existing copy to start a comparison and exit immediately.


This is a Win32 GUI program.  If opened from a version control system, it should work just fine.  If opened from a console window, the console (or batch file) will not wait for it.

This is a Win32 console program.  It has to have a console.  If you open it from one (or a batch file) that console will wait for the comparison to complete before returning.  If you open it from a version control system interactively, it will show a console window while it's waiting.


Open this program from a version control system because it will wait for the comparison to complete before returning.

Command-line parameters

Notice that each parameter should be enclosed in quotation marks if it might contain a space.

Note macOS and Linux users should use "bcompare" instead of "BCompare.exe".



Named Session

Opens the specified session in the appropriate view.  For example:

 BCompare.exe "My Session"

Named Workspace

Opens the specified saved workspace.  (see also Managing Workspaces)  For example:

 BCompare.exe "My Special Workspace"

Pair of folders

Opens a new Folder Compare view with the specified base folders.  For example:

 BCompare.exe "C:\Left Folder" "C:\Right Folder"

Pair of files

Opens the specified files in the associated file view.  For example:

 BCompare.exe "C:\Left File.ext" "C:\Right File.ext"

3 files

Opens a Text Merge view with the specified files in the left, right, and center panes.  For example:

 BCompare.exe C:\Left.ext C:\Right.ext C:\Center.ext

4 files

Opens a Text Merge view with the specified files in the left, right, center, and output panes.  For example:

 BCompare.exe C:\Left.ext C:\Right.ext C:\Center.ext C:\Output.ext

Script file

Automatically executes a list of commands without using a view.  For example:

 BCompare.exe "@C:\My Script.txt"

Settings package (.bcpkg)

Imports settings from package.

Patch file (.diff or .patch)

Opens the specified file in the Text Patch view.


Opens stdin in the appropriate view.  For example:

 dir | BCompare.exe -

Command-line switches

Note macOS and Linux users should prefix the switches with "-" instead of "/".



/?, /h, /help

Opens the help file to the "Command Line Reference" page.

Writes usage information to the console.


Automatically merges files without user interaction unless conflicts are found.


Explicitly specifies the merge center file.


Closes the script window on completion.  Overrides the Close when finished setting in Tools | Options (Beyond Compare | Settings on macOS) | Tweaks | Scripts.


Opens a Text Edit view.


Expands all subfolders during the initial folder comparison.



Draws nonconflicting changes in the output from the "favored" side without coloring or section lines.  


For ignored unimportant conflicts, changes are automatically taken from the "favored" side instead of the center.

/filters=<file masks>

Uses the specified name filter for the initial folder comparison.  Separate multiple file masks with semicolons.  Surround the name filter with quotes if it contains spaces.


Writes conflicts to the output with CSV-style markers if /automerge is present.

/fv=<type>, /fileviewer=<type>

Opens a new view of the specified type which can be any of:

   "Text Compare"

   "Text Merge"

   "Table Compare"

   "Hex Compare"

   "MP3 Compare"

   "Picture Compare"

   "Registry Compare"

   "Version Compare"

   "Folder Compare"

   "Folder Merge"

   "Folder Sync"

   "Text Edit"

   "Text Patch"

/iu, /ignoreunimportant

Turns on Ignore Unimportant Differences if /automerge is present.


Explicitly specifies the merge output file.


Prevents the creation of backup files.

/qc=<type>, /quickcompare=<type>

Performs a quick comparison of two files and sets the DOS error level on exit.  The specified type can be size, crc, or binary.  If a type is not specified, a rules-based comparison will be performed.  Error levels are documented below.


Opens a Text Merge view if /automerge is present and conflicts are found.

/ro, /readonly

Prevents editing on all sides.

/ro1, /lro, /leftreadonly

/ro2, /rro, /rightreadonly

Prevents editing on the respective side.


Overwrites the specified file instead of original file when the file view's Save command is used.


Causes all interaction to be suppressed.  No Task Bar entry or window will be shown.  For settings packages, all settings will be imported.  For scripts, any unresolved issue that would normally show a dialog will log an error instead.


Forces a new instance of the program.


Opens a Folder Sync view.

/title1=<title>, /lefttitle=<title>

/title2=<title>, /righttitle=<title>

/title3=<title>, /centertitle=<title>

/title4=<title>, /outputtitle=<title>

Shows the specified description in the respective path edit.

/vcs1=<path>, /vcsleft=<path>

/vcs2=<path>, /vcsright=<path>

/vcs3=<path>, /vcscenter=<path>

/vcs4=<path>, /vcsoutput=<path>

Shows the specified version control system path in the respective path edit unless a title has been provided.  For a file view, the specified path is also used to choose the appropriate file format.

Return codes






Binary same


Rules-based same


Binary differences




Rules-based differences


Conflicts detected


Unknown error


Conflicts detected, merge output not written


BComp.exe unable to wait until BCompare.exe finishes


BComp.exe cannot find BCompare.exe


Trial period expired


Error loading script file


Script syntax error


Script failed to load folders or files