SiftVid
Installer reference

Installer exit codes

The SiftVid Windows installer returns a numeric exit code when it finishes. This page lists every code it can return, what each one means, and what to do about it. It also states the silent-install switch and the architecture the installer supports.

Applies to: SiftVid Windows installer (.exe)Architecture: x64 onlyPublisher: SiftVidContact: reply@siftvid.com

01Scope

This page documents the downloadable SiftVid Windows installer, the file named SiftVid-<version>-setup.exe. It is the reference URL declared for the “Miscellaneous install failure” row of the Microsoft Partner Center EXE return-code form, and it is also the page to read if you ran the installer and were shown a number.

Codes 0, 1, and 2 are the NSIS installer framework's own and are unchanged. Codes 10 through 13 are specific to SiftVid and are raised by named checks in the installer script.

If you installed SiftVid from the Microsoft Store rather than by downloading this installer, none of these codes apply. The Store installs the package itself and reports its own errors.

02Exit codes

CodeMeaningWhat to doRaised by
0Installation completed successfully.Nothing to do. SiftVid is installed.NSIS default
1Installation was cancelled by the user.Nothing was installed and nothing was left behind. Run the installer again when you are ready.NSIS default
2Miscellaneous install failure. The installer stopped for a reason it could not classify.Confirm the download is complete and not blocked by Windows, close anything that might be scanning the file, and run the installer again. If it repeats, send us the code and the Windows version.NSIS default
10This exact version of SiftVid is already installed on this machine.No action is needed. A silent install stops here rather than reinstalling. When the installer is run with its normal window, it asks first, and only returns 10 if you choose Cancel.siftvidCheckSameVersion
11Another copy of the SiftVid installer is already running.Finish or close the installer that is already open, then start this one again.siftvidCheckInstallerMutex
12The destination drive does not have enough free space.SiftVid needs the unpacked application size plus 15 percent, which covers the temporary extraction buffer and the uninstaller. Free up space on the destination drive, or install to another drive, and run the installer again.siftvidCheckDiskSpace
13SiftVid was installed successfully, and Windows needs to restart to finish replacing a file another program was holding open.Restart Windows. This is not a failure: the install completed, and the restart only finishes a file replacement that could not happen while the file was in use.customInstall

Code 13 is not an error. It means the installation finished and Windows needs to restart before a file that another process was holding can be replaced. SiftVid is installed either way; restart when convenient.

One known limit on code 12. The free-space check runs against the install directory as it stands when the installer starts, which is the directory a silent install always uses. If you afterwards change the destination in the installer window and pick a drive that is full, the failure surfaces as code 2 rather than 12. The remedy is the same: free up space or choose another drive.

03Silent install and architecture

  • Silent switch: /S, with a capital S. Running SiftVid-<version>-setup.exe /S installs with no window and no prompt.
  • Every check runs in silent mode too. Each of the checks behind codes 10 to 13 suppresses its message box when the installer is silent, so a silent install never stops waiting for someone to click something. It reports the code and exits.
  • Architecture: x64 only. There is no 32-bit build and no ARM build. SiftVid depends on native components that are published for x64 Windows only, so no other architecture is offered.
  • Installs for the current user. The installer does not require administrator rights and does not install for all users.

A silent reinstall of the same version returns 10

That is deliberate rather than a bug. A silent install of a version that is already present stops and reports 10 instead of overwriting a working installation. Run the installer normally, without /S, if you want to repair or reinstall the version you already have; it asks first.

04Certification form values

These are the values entered on the Microsoft Partner Center EXE return-code form for the downloadable installer, reproduced here so a reviewer can check them against the behaviour described above.

ScenarioValueNotes
Installation successful0NSIS default.
Installation cancelled by user1NSIS default.
Application already exists10Same-version detection.
Installation already in progress11Named installer mutex.
Disk space is full12Free-space check against the install directory.
Reboot required13In-use file detection. The install itself succeeded.
Network failureLeft blankNot applicable. The installer is fully offline: it downloads nothing while it runs, so it has no network failure to report.
Package rejected during installationLeft blankNot detectable by the installer, so no dedicated code exists. This condition surfaces as 2, the miscellaneous failure code, with the documentation URL above.
Miscellaneous install failure2NSIS default, documented at https://siftvid.com/install-codes.

Two rows are blank on purpose. The installer contains the whole application, so it makes no network request while it runs and cannot fail for a network reason. “Package rejected during installation” is not a condition the installer can detect, so inventing a code for it would misreport what happened; it falls through to 2, which is why that row carries this page's address.

05Getting help

If the installer returned a code that is not listed above, or the remedy did not work, email reply@siftvid.com with the code, your Windows version, and whether you ran the installer silently. A fresh copy of the installer is always available on the download page.

This page is kept in step with the installer script itself. If it ever disagrees with what the installer does, the installer is right and this page is the defect — please tell us.