To use this new UI for for installer, you need +
To use this new interface for for installer, you need to add some code to your NSIS script. Read this document for more info!
Requirements
Screenshot
How to use
-Have a look at the basic example script, Basic.nsi. - This is an example of how the use this interface for your NSIS - installer. The macro system also has multilanguage support, - see MultiLanguage.nsi for a multilanguage example. And if you - want to use Install Options (for extra pages in your installer, - like Start Menu folder selection etc.) have a look at InstallOptions.nsi, - which is an example of the new Install Options macro system.
-If you have an installer with a lot of subsections - or long section names, use the modern2.exe UI, which has a larger - treeview for the component selection. To use modern2.exe, change - the first parameter of the MUI_INTERFACE macro.
-Customize the interface
-To change elements on the dialogs, modify modern.exe - or modern2.exe in the Contrib\UIs folder using a a resource - editor such as Resource - Hacker.
-The 'Loading Setup' text on the splash screen which +
The Modern UI has a macro system, so most of the code + is already written for you!
+Basic Macro System
+ For most scripts, you can use the basic macro system. The basic
+ macro system inserts all code and functions for you. For an example,
+ have a look at Basic.nsi.
+ To remove certain default NSIS pages (such as the License page),
+ remove a define before the language files (for example, remove
+ !define MUI_LICENSEPAGE), and remove the other instruction for
+ the page (for example, LicenseData).
Advanced Macro System, Install Options
+ If you want put your code in certain NSIS functions or want to
+ use custom installer pages, use the Advanced Macro System.
+ The code will still be inserted using the macro's, but
+ you can customize a lot of things, add your own code or
+ add new pages.
+ Using the Install Options macro's, it's also very easy to use
+ custom pages in your installer.
+ Have a look at
+ InstallOptions.nsi for an example of the Install Options
+ and the Advanced Macro System.
Multilanguage installers
+ The Modern UI has full multilanguage support and also uses
+ language files which can be translated easily. You can find the
+ language files in the Contrib\Modern UI\Language files folder.
+ There are already a lot of translations available, but you can
+ also make your own translation.
+ See MultiLanguage.nsi
+ for a multilanguage example using the Basic Macro System.
+
The interface
+Modern.exe and modern2.exe
+ There are two different version of the interface.
+ Modern.exe contains the dialogs of the standard interface.
+ If you have an installer with a lot of subsections
+ or long section names, use modern2.exe, which has a different
+ component-selection page.
Change interface settings
+ You can change the settings of the interface
+ by usings defines before you insert the MUI_INTERFACE macro.
+ Example: !define MUI_UI "${NSISDIR}\Contrib\UIs\modern2.exe"
+ If you don't define a setting, the default will be used.
+ The following settings are available: (default)
+ MUI_ICON (${NSISDIR}\Contrib\Icons\modern-install.ico)
+ - The icon of the instaleller
+ MUI_UNICON (${NSISDIR}\Contrib\Icons\modern-uninstall.ico)
+ - The icon of the uninstaleller
+ MUI_CHECKBITMAP (${NSISDIR}\Contrib\Icons\modern.bmp)
+ - The bitmap with images for the checks of the
+ component select treeview.
+ MUI_UI (${NSISDIR}\Contrib\UIs\modern.exe)
+ - The interface file with the dialog resources
+ MUI_FONT (Tahoma)
+ - The font of the installer and uninstaller
+ MUI_INSTALLCOLORS (/windows)
+ - The hexadecimal colors of the details screen ("foreground" "background")
+ MUI_PROGRESSBAR (smooth)
+ - The style of the progress bar ("colored" to use the MUI_INSTALLCOLORS or ""
+ for a old-school windows look)
Customize the dialogs
+ To change elements on the dialogs, modify modern.exe or modern2.exe in the
+ Contrib\UIs folder using a a resource editor such as
+ Resource Hacker.
+ The 'Loading Setup' text on the splash screen which
is being displayed when the installer is starting (Verifying
installer, Unpacking data when using COMPRESS_WHOLE) cannot
be changed by the script, because the installer is not started
yet when this dialog is being displayed. If you want to change
- this text, modify dialog 111 of modern(2).exe.
To 'verifying installer' and 'unpacking data' - texts are defined in the language header file of the NSIS exehead - (Source\exehead\lang.h). To change them, you need to edit this - file and recompile NSIS.
+ this text, modify dialog 111 of modern(2).exe.Version history