# CPackNSIS

CPack NSIS generator specific options

## Variables specific to CPack NSIS generator

The following variables are specific to the graphical installers built on Windows using the Nullsoft Installation System.

`CPACK_NSIS_INSTALL_ROOT`

  The default installation directory presented to the end user by the NSIS installer is under this root dir. The full directory presented to the end user is: ${CPACK_NSIS_INSTALL_ROOT}/${CPACK_PACKAGE_INSTALL_DIRECTORY}

`CPACK_NSIS_MUI_ICON`

  An icon filename. The name of a `*.ico` file used as the main icon for the generated install program.

`CPACK_NSIS_MUI_UNIICON`

  An icon filename. The name of a `*.ico` file used as the main icon for the generated uninstall program.

`CPACK_NSIS_INSTALLER_MUI_ICON_CODE`

  undocumented.

`CPACK_NSIS_MUI_WELCOMEFINISHPAGE_BITMAP`

  The filename of a bitmap to use as the NSIS MUI_WELCOMEFINISHPAGE_BITMAP.

`CPACK_NSIS_MUI_UNWELCOMEFINISHPAGE_BITMAP`

  The filename of a bitmap to use as the NSIS MUI_UNWELCOMEFINISHPAGE_BITMAP.

`CPACK_NSIS_EXTRA_PREINSTALL_COMMANDS`

  Extra NSIS commands that will be added to the beginning of the install Section, before your install tree is available on the target system.

`CPACK_NSIS_EXTRA_INSTALL_COMMANDS`

  Extra NSIS commands that will be added to the end of the install Section, after your install tree is available on the target system.

`CPACK_NSIS_EXTRA_UNINSTALL_COMMANDS`

  Extra NSIS commands that will be added to the uninstall Section, before your install tree is removed from the target system.

`CPACK_NSIS_COMPRESSOR`

  The arguments that will be passed to the NSIS SetCompressor command.

`CPACK_NSIS_ENABLE_UNINSTALL_BEFORE_INSTALL`

  Ask about uninstalling previous versions first. If this is set to “ON”, then an installer will look for previous installed versions and if one is found, ask the user whether to uninstall it before proceeding with the install.

`CPACK_NSIS_MODIFY_PATH`

  Modify PATH toggle. If this is set to “ON”, then an extra page will appear in the installer that will allow the user to choose whether the program directory should be added to the system PATH variable.

`CPACK_NSIS_DISPLAY_NAME`

  The display name string that appears in the Windows Add/Remove Program control panel

`CPACK_NSIS_PACKAGE_NAME`

  The title displayed at the top of the installer.

`CPACK_NSIS_INSTALLED_ICON_NAME`

  A path to the executable that contains the installer icon.

`CPACK_NSIS_HELP_LINK`

  URL to a web site providing assistance in installing your application.

`CPACK_NSIS_URL_INFO_ABOUT`

  URL to a web site providing more information about your application.

`CPACK_NSIS_CONTACT`

  Contact information for questions and comments about the installation process.

`CPACK_NSIS_<compName>_INSTALL_DIRECTORY`

  Custom install directory for the specified component <compName> instead of $INSTDIR.

`CPACK_NSIS_CREATE_ICONS_EXTRA`

  Additional NSIS commands for creating start menu shortcuts.

`CPACK_NSIS_DELETE_ICONS_EXTRA`

  Additional NSIS commands to uninstall start menu shortcuts.

`CPACK_NSIS_EXECUTABLES_DIRECTORY`

  Creating NSIS start menu links assumes that they are in ‘bin’ unless this variable is set. For example, you would set this to ‘exec’ if your executables are in an exec directory.

`CPACK_NSIS_MUI_FINISHPAGE_RUN`

  Specify an executable to add an option to run on the finish page of the NSIS installer.

`CPACK_NSIS_MENU_LINKS`

  Specify links in [application] menu. This should contain a list of pair “link” “link name”. The link may be an URL or a path relative to installation prefix. Like:

      set(CPACK_NSIS_MENU_LINKS
          "doc/cmake-@CMake_VERSION_MAJOR@.@CMake_VERSION_MINOR@/cmake.html"
          "CMake Help" "https://cmake.org" "CMake Web Site")