True Human Design
 
Diffinity Documentation
◀ Back to Diffinity



Command line arguments

diffinity ["<leftPath\>"] ["<rightPath>"] [-forceNewInstance] [-bringToFront] [-folderDiff] [-suppressFileLoadErrorMsg] [-l <window left position>] [-t <window top position>] [-w <window width>] [-h <window height>]

Parameter Description
<leftPath> Full path to the left side file or folder. Must always be the first argument. Use quotation mark if path contains spaces. Use empty string ("") for no path if other arguments should be passed.
<rightPath> Full path to the right side file or folder. Must always be the second argument. Use quotation mark if path contains spaces. Use empty string ("") for no path if other arguments should be passed.
-forceNewInstance Will open a new instance of Diffinity without tabs even when Diffinity is set to use tabs.
-bringToFront Will try to bring the Diffinity window to the front when opened.
-folderDiff Will open the folder diff view. This is not needed if the two paths provided are for folders.
-suppressFileLoadErrorMsg Will not show the "Failed to open file" popup if the provided file paths does not exist.
-l <window left position> X position in pixels of the Diffinity window
-t <window top position> Y position in pixels of the Diffinity window
-w <window width> Diffinity window width in pixels
-h <window height> Diffinity window height in pixels


Examples:

diffinity "c:\leftFile.text" "c:\rightFile.text" -suppressFileLoadErrorMsg
Will open diffinity and load the provided files, no popup will be shown if the files are not present on disk .

diffinity "" "" -folderDiff
Will open diffinity with an empty folder diff view.




Keyboard/mouse commands

Following is a list of useful mouse and keyboard commands not apperent in the menus.

Mouse commands Description
Ctrl + Mouse wheel Scroll the text horizontally
Alt + Left mouse button Block selection
Triple click Select the line
Double click Highlights selected word.
Folder diff: open the double clicked file(s) in new diff tab.
Middle mouse button (on tab header) Close tab

Keyboard commands Description
Ctrl + F4 Close active tab
Left/right Folder diff: close/open selected folder
F4 Switch input focus between left and right text




Using Diffinity with version control applications

To configure Diffinity to be the diffing tool used in your version control system make sure to point it to the Diffinity exe (typically "C:/Program Files (x86)/Diffinity/Diffinity.exe") and send the full path to the first file as the first argument and the full path to the second file as the second argument.

Example: git
Edit your C:\Users\<name>\.gitconfig and add:

[diff]
    tool = diffinity
[difftool "diffinity"]
    cmd = \"C:/Program Files (x86)/Diffinity/Diffinity.exe\" \"$REMOTE\" \"$LOCAL\"
[difftool]
    prompt = false


Example: Perforce Helix P4V
P4V -> Edit -> Preferences -> Diff:
- Choose "Other application"
- Browse for the Diffinity executable (default: "C:/Program Files (x86)/Diffinity/Diffinity.exe")
- Make sure arguments is set to %1 %2