NXPowerLite Deployment Guide (Windows only)

Once NXPowerLite Desktop has been installed on a machine, it must be registered in order to prevent it from running in “evaluation” mode. The software can be registered on either a per-user or per-machine basis. 

This is achieved using the MSI properties NXNAME and NXCODE, as in the following example (assuming “Filename” “Some User” and “XXXXX-XXXXX-XXXXX-XXXXX-XXXXX” are replaced with the filename of the current NXPowerLite installer, username and registration code):

msiexec /i Filename.msi NXNAME="Some User" NXCODE="XXXXX-XXXXX-XXXXX-XXXXX-XXXXX"

Where the registration details are stored

Registration details for NXPowerLite are stored under one of the following Registry keys, depending on whether NXPowerLite is being registered on a per-user or per-machine basis:

HKEY_CURRENT_USER\Software\Neuxpower\NXPowerLite\10.0

HKEY_LOCAL_MACHINE\Software\Neuxpower\NXPowerLite\10.0

or on 64-bit systems:

HKEY_LOCAL_MACHINE\Software\Wow6432Node\Neuxpower\NXPowerLite\10.0

Under those keys, NXPowerLite looks for the string values “Registered Name” and “Registered Code”. For example, the following Registry script can be used to register NXPowerLite Desktop Edition on a per-machine basis:

REGEDIT4

[HKEY_LOCAL_MACHINE\Software\Neuxpower\NXPowerLite\10.0]

"Registered Name"="Some User"

"Registered Code"="XXXXX-XXXXX-XXXXX-XXXXX-XXXXX" 

On installation by default NXPowerLite will be integrated with the following operating system and applications if present on the system:

• Windows Explorer
• Microsoft Outlook 
• Microsoft PowerPoint
• Microsoft Word
• Microsoft Excel
• Lotus Notes
• Desktop Shortcut

MSI properties can be specified at installation time to select the features to be installed. For example, the following msiexec command line will silently install everything except PowerPoint, Word and Excel integration:

msiexec /i NXPowerLite64Setup100_1.msi /quiet ADDLOCAL=ALL REMOVE=PowerPointIntFeature, WordIntFeature,ExcelIntFeature

The REMOVE property is a comma-separated list of identifiers of the features that should not be installed. The current feature identifiers for NXPowerLite are:

• ExplorerIntFeature (“NXPowerLite” submenu in Windows Explorer’s context menu)
• OutlookIntFeature (integration with Microsoft Outlook)
• PowerPointIntFeature (“Optimize with NXPowerLite” button in Microsoft PowerPoint)
• WordIntFeature (“Optimize with NXPowerLite” button in Microsoft Word)
• ExcelIntFeature (“Optimize with NXPowerLite” button in Microsoft Excel)
• LotusNotesIntFeature (integration with Lotus Notes)
• DesktopShortcut  (Controls creation of the desktop shortcut icon)

NXPowerLite can integrate with Microsoft Outlook and Lotus Notes. Once integrated, NXPowerLite can automatically optimize and zip mail attachments, reducing the size of the sender’s sent mail and the recipient’s Inbox.

It is possible to force different default behaviours in NXPowerLite’s email integration when deploying using the MSI file. For example, an administrator may want to force NXPowerLite’s integration to be enabled for all users’ new emails, while still allowing the user to disable per email.

The following MSI properties can be used to modify the behaviour of NXPowerLite’s email integration:

• NXOLFORCE (Microsoft Outlook)
• NXLNFORCE (Lotus Notes)

Each one of the above can have three possible values – 0, 1 and 2. These options are detailed below:

Option 0 or no setting: NXPowerLite remembers the last setting (default)

If a user disables NXPowerLite email integration, it will remain disabled for all new emails** until the user enables it. NXPowerLite email integration will then remain enabled until changed again. This behaviour applies in the same or next session.

Option 1: NXPowerLite email integration always initially ENABLED

All new emails will have NXPowerLite email integration enabled regardless of any previous setting. Users can disable on a per-email basis.

e.g. To force NXPowerLite to be enabled for all new emails** in Outlook, use the MSI property NXOLFORCE=1.

At the beginning of every email client session, NXPowerLite email integration is enabled.

Option 2: NXPowerLite email integration always initially DISABLED

All new emails will have NXPowerLite email integration disabled regardless of any previous setting. Users can enable on a per-email basis.

e.g. To force NXPowerLite to be disabled for all new emails** in Outlook, use the MSI property NXOLFORCE=2.

At the beginning of every email client session, NXPowerLite email integration is disabled.

** Note: Due to the way Lotus Notes is designed, it is not possible to set the integration per new email, it can only be implemented per session. However, the state of NXPowerLite can be changed during the session.

The following MSI properties allow an administrator to create a custom NXPowerLite optimization settings profile. The custom profile will be created at install and be set as the user's setting profile, however, users can still change the settings by using the desktop application. Where settings are not specified or are invalid Default values will be applied.

Download this text file which contains each setting that can be set in a custom profile. You can amend and then add to any other deployment script/command.

Currently, Microsoft Office file format settings (PowerPoint, Word & Excel) can only be set to the same values. 

Profile settings

Valid screen width and height values:

• 7680 x 4320
• 3840 x 2160
• 2880 x 1800
• 2560 x 1600
• 2560 x 1440
• 2560 x 1080
• 1920 x 1200
• 1920 x 1080
• 1680 x 1050
• 1600 x 1200
• 1440 x 900
• 1366 x 768
• 1280 x 1024
• 1280 x 800
• 1280 x 720
• 1024 x 768
• 960 x 600
• 960 x 540
• 800 x 600
• 720 x 480
• 640 x 480
• 480 x 480
• 320 x 240

For settings where there is a constrained range of valid numbers, if the specified setting is invalid then the application will revert back to the Default setting for that specific setting when the application starts. In the case of Default width and height – where both values have to be both valid and in a valid pair, both numbers must be correct and in a valid combination otherwise, the Default settings will be used.

It is possible to customize the default email settings at install time. Users will always be able to change the settings once deployed.

It is possible to customize some of the attributes of the NXPowerLite Add-in when deploying NXPowerLite. By default, the NXPowerLite group will be installed after the Font group on the Home tab of PowerPoint, Word and Excel.

Working with standard elements

Microsoft TAB-Id and GROUP-Id's can be found by downloading the Office Fluent User Interface Control Identifiers.  

Working with custom elements

When working with customized ribbon, group and tab layouts or you wish to customize some XML attributes use the following properties.

If you intend to use the following properties, you have to set the namespace first.

It is possible to add registry keys after NXPowerLite has been installed to perform the same actions as the deployment options. However, the names of each registry keys are not the same. Please drop the 'NXDT' from the beginning of the property names to make the registry keys. Registry keys should be inserted here:

 Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Neuxpower\NXPowerLite\9.0\Desktop

At the end of the installation process for NXPowerLite Desktop 9.1.5 or later, the default browser is opened to display a getting started guide. On uninstallation, an uninstall survey is opened. It is possible to suppress these actions by using the boolean parameter NXNOURL. For example, to register and suppress the URL opening use the following:

msiexec /i Filename.msi NXNAME="Some User" NXCODE="XXXXX-XXXXX-XXXXX-XXXXX-XXXXX" NXNOURL=1

Automatic URL opening only happens in English installations of NXPowerLite Desktop

NXPowerLite Desktop 10 contains a menu option that allows the user to check whether the currently installed version of NXPowerLite is the latest. If not it will open a URL for them to download the latest version.

It is possible to remove the menu option by using the boolean parameter NXDTDISABLEUPDATECHECK. For example, to register and suppress the URL opening use the following:

msiexec /i Filename.msi NXNAME="Some User" NXCODE="XXXXX-XXXXX-XXXXX-XXXXX-XXXXX" NXDTDISABLEUPDATECHECK=1