Installation

Installer (MSI)

Run the Diffoniq MSI installer and follow the wizard. It installs a single self-contained Diffoniq.exe (no additional runtime DLLs) plus this help, by default into C:\Program Files\Diffoniq, and creates a Start menu and a desktop shortcut. The last page of the wizard starts Diffoniq unless you untick Launch Diffoniq; it runs as you, without administrator rights. After installation, Diffoniq can also be started by typing Diffoniq into the Run dialog (Win+R).

Installing a newer version on top simply replaces the old one — your settings, and a custom install folder you may have chosen, are kept. The first page of Setup says so when it finds an earlier version. Uninstalling (via Windows “Apps”) removes the program but leaves your personal settings behind.

Portable use

Diffoniq also runs without any installation: download the portable ZIP and extract it to any convenient directory — a USB stick works fine. It is portable as it comes: the file diffoniq.portable next to Diffoniq.exe keeps settings (diffoniq.ini, created on the first start), the content-hash cache and your license file (diffoniq.lic) in that folder, and nothing is written elsewhere. Its content does not matter, only that it is there. Delete diffoniq.portable and diffoniq.ini if you prefer your settings per user in %APPDATA%\Diffoniq, like the installed version.

Updating a portable folder: the ZIP contains no diffoniq.ini, so extracting a newer version over your folder keeps your settings.

A copy of Diffoniq.exe made some other way (for example together with its help folder out of an installation) becomes portable the same way: create an empty file named diffoniq.ini next to it.

Where settings are stored

Configuration is a plain INI file, looked up in this order:

  1. diffoniq.ini next to Diffoniq.exe (portable mode), if it exists;
  2. otherwise, if diffoniq.portable lies next to Diffoniq.exe, diffoniq.ini in that folder — created on the first start;
  3. otherwise diffoniq.ini in the working directory, if it exists;
  4. otherwise %APPDATA%\Diffoniq\diffoniq.ini — created automatically on first start.

Upgrading from WDiff32 (the product’s former name): on first start, existing settings and the content-hash cache are copied automatically from %APPDATA%\WDiff, and a portable wdiff.ini next to Diffoniq.exe or in the working directory keeps working — also when the portable ZIP is extracted into that old folder. An empty diffoniq.ini created beside an old wdiff.ini takes over its settings once on the next start, and wdiff.ini stays as it was. An installed license is picked up from its old location as well.

The last 20 versions of the settings are kept in the folder settings-history beside the ini; an empty or missing ini can be restored from there at start — see Settings History.

Command line arguments take precedence over the configuration file settings — see Command Line Arguments.

Unattended / company installation

The same MSI installs silently for software distribution (GPO, Intune, etc.):

msiexec /i Diffoniq-<version>-x64.msi /qn

A silent installation does not start Diffoniq afterwards.

INSTALLDESKTOPSHORTCUT=0 suppresses the desktop shortcut
LICENSE="\\server\share\diffoniq.lic" deploys a license file to %PROGRAMDATA%\Diffoniq\diffoniq.lic for all users of the machine; the deployed license survives upgrades and uninstalls

Long paths

Windows limits a path to 260 characters unless the setting Enable Win32 long paths is on (group policy Computer Configuration › Administrative Templates › System › Filesystem, or the registry value LongPathsEnabled=1 under HKLM\SYSTEM\CurrentControlSet\Control\FileSystem). Diffoniq compares folders nested deeper than that, as in a node_modules tree, with or without the setting: it reads, shows and saves such paths in their long form itself. A converter that runs a program of yours at such a path needs the setting on, since that program reads the path itself.