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.
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.
Configuration is a plain INI file, looked up in this order:
diffoniq.ini next to Diffoniq.exe (portable
mode), if it exists;diffoniq.portable lies next to
Diffoniq.exe, diffoniq.ini in that folder
— created on the first start;diffoniq.ini in the working directory, if it
exists;%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.
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 |
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.