# CPack NSIS Generator

CPack Nullsoft Scriptable Install System (NSIS) generator specific options.

Changed in version 3.17: The NSIS generator requires NSIS 3.0 or newer.

## Variables specific to CPack NSIS generator

The following variables are specific to the graphical installers built on Windows Nullsoft Scriptable Install 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`

  New in version 3.5.

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

`CPACK_NSIS_MUI_UNWELCOMEFINISHPAGE_BITMAP`

  New in version 3.5.

  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 Apps & features in 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`

  New in version 3.7.

  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 a 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")

`CPACK_NSIS_UNINSTALL_NAME`

  New in version 3.17.

  Specify the name of the program to uninstall the version. Default is `Uninstall`.

`CPACK_NSIS_WELCOME_TITLE`

  New in version 3.17.

  The title to display on the top of the page for the welcome page.

`CPACK_NSIS_WELCOME_TITLE_3LINES`

  New in version 3.17.

  Display the title in the welcome page on 3 lines instead of 2.

`CPACK_NSIS_FINISH_TITLE`

  New in version 3.17.

  The title to display on the top of the page for the finish page.

`CPACK_NSIS_FINISH_TITLE_3LINES`

  New in version 3.17.

  Display the title in the finish page on 3 lines instead of 2.

`CPACK_NSIS_MUI_HEADERIMAGE`

  New in version 3.17.

  The image to display on the header of installers pages.

`CPACK_NSIS_MANIFEST_DPI_AWARE`

  New in version 3.18.

  If set, declares that the installer is DPI-aware.

`CPACK_NSIS_BRANDING_TEXT`

  New in version 3.20.

  If set, updates the text at the bottom of the install window. To set the string to blank, use a space (" ").

`CPACK_NSIS_BRANDING_TEXT_TRIM_POSITION`

  New in version 3.20.

  If set, trim down the size of the control to the size of the branding text string. Allowed values for this variable are `LEFT`, `CENTER` or `RIGHT`. If not specified, the default behavior is `LEFT`.