Month: June 2013

I searched "nsis delete registry value" on google, but found that search results are not really helpful. So I decide to write this post to introduce how to delete registry value (or how to delete registry string).

Deleting registry value need use DeleteRegValue instruction

DeleteRegValue root_key sub_key value_name

If I need to delete a value named "DisplayName" under "HKLM\Software\Microsoft\Windows\CurrentVersion\Uninstall\Pooler" (This is the entry name in Add/Remove Programs in Windows XP or Program & Features in Windows 7/8), I could use:

DeleteRegValue HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\Pooler" "DisplayName"

And we can check this value by using ReadRegStr and MessageBox:

ReadRegStr $0 HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\Pooler" "DisplayName"

MessageBox MB_OK $0

Have fun with NSIS!

I was asked to build a program that monitors employees' actions (e.g. which website is he viewing), it's used to send user actions logs, network requests logs, etc.  to center logging server. But I cannot ask user to run a program which will log their actions, so to start program automatically when Windows starts is necessary.

In summary, there are three methods to achieve this:

1. Add program to Run or RunOnce Key

2. Add program shortcut to Start Menu/Startup Folder

3. Register program as a service (But our program is a GUI application and Windows Service doesn't allow GUI, so we ignore this method)

Run/RunOnce Key

If the program path is written into Run key, then this program will start every time when System boots.

We can write it into HKLM(HKEY_LOCAL_MACHINE) or HKCU(HKEY_CURRENT_USER), HKLM will apply settings to ALL users, while HKCU only applies settings to current user.

WriteRegStr HKLM "Software\Microsoft\Windows\CurrentVersion\Run" "Monitor" "X:\Monitor.exe"

WriteRegStr HKCU "Software\Microsoft\Windows\CurrentVersion\Run" "Monitor" "X:\Monitor.exe"

RunOnce key will only run program automatically when the system boots first time. And after Windows is loaded, entries under RunOnce will be removed (It's usually used when application needs configuration after system reboots).

Start Menu/Startup Folder

Actually, programs under Start Menu/Startup Folder will be started after those defined in "Run" key.

CreateShortCut "$SMSTARTUP\Monitor.lnk" "$INSTDIR\Monitor.exe"

Loading order of Run, RunOnce, StartUp folder

Programs defined in Run, RunOnce or StartUp will be loaded in following order:

(Login Screen)

HKLM\Software\Microsoft\Windows\CurrentVersion\RunOnce
HKLM\Software\Microsoft\Windows\CurrentVersion\Run
HKCU\Software\Microsoft\Windows\CurrentVersion\Run
StartUp Folder
HKCU\Software\Microsoft\Windows\CurrentVersion\RunOnce

I want to add sidebar image to finish page of a NSIS installer, because the default empty area on the left side is too ugly:)

After reading documentation, I found that MUI_WELCOMEFINISHPAGE_BITMAP is used to specify sidebar image for both welcome page and finish page

Ok, after trying add it to installer script, I found it didn't work at all. Following is the source code

!include "MUI2.nsh"

!define MUI_WELCOMEFINISHPAGE_BITMAP "${NSISDIR}\Contrib\Graphics\Wizard\orange-nsis.bmp"

!insertmacro MUI_PAGE_FINISH

Section
SectionEnd

Finally I found that !insertmacro MUI_LANGUAGE "English" is needed, and it must be placed after !insertmacro MUI_PAGE_*. (please check here)

So following code will work:

!include "MUI2.nsh"

!define MUI_WELCOMEFINISHPAGE_BITMAP "${NSISDIR}\Contrib\Graphics\Wizard\orange-nsis.bmp"

!insertmacro MUI_PAGE_FINISH

!insertmacro MUI_LANGUAGE "English"

Section
SectionEnd

But following code will not work:

!include "MUI2.nsh"

!define MUI_WELCOMEFINISHPAGE_BITMAP "${NSISDIR}\Contrib\Graphics\Wizard\orange-nsis.bmp"

!insertmacro MUI_LANGUAGE "English"

!insertmacro MUI_PAGE_FINISH

Section
SectionEnd

And if MUI_LANGUAGE is not defined, some text will not be displayed correctly in the installer.

Also MUI_WELCOMEFINISHPAGE_BITMAP will add sidebar image to Welcome page