3. Installation, Updates and Settings

This chapter answers common questions about installing, deploying and updating UniPlot, supported Windows versions, the user directory, saved settings and start-up behaviour.

3.1. Installing and deploying UniPlot

3.1.1. How do I install UniPlot step by step?

You need local administrator rights to install UniPlot.

  1. Download the setup program from the download page of the UniPlot website. Select the UniPlot version and a download server and click Download. You can also download the setup inside UniPlot (see Help=>Check for Updates). Depending on your settings, you may have to disable your antivirus software temporarily for the download.

  2. Start the setup program (Setup.exe) and accept the license terms.

  3. Enter the complete license key and click Next.

  4. Keep all components selected (this includes the menu entries for all users) and click Next.

  5. Select the installation folder and click Install. The default folder is C:\Program Files\UniPlot Software\<release>. For full write access to all files of the installation, choose a folder outside Program Files, for example C:\UniPlot\<release>.

  6. Start UniPlot. Depending on your license type, the UniPlot licensing dialog opens at the first start (see Dialog Box=>License).

The setup pages are shown in the language of the setup.

See also: Installation of UniPlot, Network Installation.

3.1.2. How can I deploy UniPlot through a software centre or company portal (silent install, individual license keys)?

UniPlot is delivered as an EXE setup. An MSI package is not available. The license key is entered in the setup, so choose the way that fits your licenses:

  • Single-user licenses with different keys: package the EXE setup with the packaging format of your distribution tool (for example MSIX) so that the setup runs interactively. When a user installs UniPlot from the portal, the setup window asks for his or her own license key.

  • Floating license (one key for all users): run the setup silently with the key, for example:

    setup-uniplot-<release>.exe /S /LIC=<key> /ALLUSERS /D=C:\Program Files\UniPlot Software\<release>
    

    Then configure the clients to use the license server. The users do not enter a key. To change to a floating license, contact UniPlot support.

The command-line parameters:

  • /S suppresses all dialogs.

  • /LIC passes the license key that the setup would ask for.

  • /ALLUSERS creates the menu entries for all users.

  • /D sets the installation directory. It must be the last parameter, must not contain quotes and must be an absolute path.

See also: Installation of UniPlot, Network Installation.

3.1.3. The installer fails with .dll unpacking or extraction errors, or I cannot reinstall. What can I do?

Installing software always requires local administrator rights. Try the following:

  1. Download the latest installer and run it as administrator (or ask your IT department for the rights).

  2. Install into a directory other than the default one on drive C: (see How do I install UniPlot step by step?). In several cases the unpacking errors disappeared this way.

  3. If the extraction stops while the installer unpacks its files, select a different target folder for the unpacking, for example a folder in your documents. The default folder can be a protected Windows location.

  4. UniPlot R2020.0 and later only runs on 64-bit Windows; 32-bit installers are not provided. Use a 64-bit Windows 10 or Windows 11 PC.

If the software centre does not offer a reinstall, ask your IT department to publish the installer again.

See also: Installation of UniPlot.

3.1.4. UniPlot Viewer shows error -529697949 when opening IPZ or IPW files. What should I do?

Reinstall the UniPlot Viewer. This solved the error in the reported cases.

3.1.5. How can I reset UniPlot settings (for example a path shown as “false”) or clean up before reinstalling?

UniPlot stores your settings in the registry key HKEY_CURRENT_USER\Software\RSB\UniPlot5. The uninstaller does not remove this key or your user directory.

Reset one damaged setting. If a path in Tools > More Options shows false, or a page of this dialog cannot be displayed, a value under HKEY_CURRENT_USER\Software\RSB\UniPlot5\settings is damaged. For example, the Report Directory for Excel Templates (page Paths and Files) is stored in the value ReportTemplatePath.

  1. Close UniPlot.

  2. Start the Registry Editor (regedit) and export the key HKEY_CURRENT_USER\Software\RSB\UniPlot5 as a backup.

  3. Delete the damaged value, for example ReportTemplatePath with the content false. UniPlot then uses the default again (for ReportTemplatePath: the folder template\report of the installation).

  4. Start UniPlot.

If you cannot find the damaged value, close UniPlot, delete the whole key HKEY_CURRENT_USER\Software\RSB\UniPlot5 and start UniPlot again. This resets all settings.

Complete clean-up before a reinstallation. Back up your own scripts, formula files and settings first (see How can I export my settings and transfer them to a new UniPlot version or a new PC?).

  1. Uninstall UniPlot (see Deinstallation).

  2. Start the Registry Editor (regedit) and delete the key HKEY_CURRENT_USER\Software\RSB\UniPlot5.

  3. Optionally rename or delete the UniPlot user directory (default Documents\UniPlot) and C:\Users\<user>\AppData\Local\UniPlot.

  4. Install UniPlot again.

See also: UniPlot’s Use of the Windows Registry, Tools=>More Options, Deinstallation.

3.2. Downloading and updating UniPlot

3.2.1. How do I update UniPlot to the latest version?

UniPlot releases are published regularly (see the release notes under New in R2026). To update:

  1. Choose Help > Check for updates… and click Download.

  2. Quit UniPlot. If UniPlot is installed on your local computer, the setup starts automatically when you quit (administrator rights are required).

  3. Start UniPlot again.

The downloaded setup is stored in the folder updates of the user directory (Documents\UniPlot\updates). You can start it manually from there; in a network installation you must do so. As an alternative, download the installer from the download page of the UniPlot website.

If your company distributes UniPlot through a software centre, ask your IT department to publish the new release. After an update, delete patch scripts you received earlier from the autoload folder, so that the fix integrated in the new release is used. Many problems reported for old releases are already solved in newer ones, so updating is the first recommendation.

To set how often UniPlot checks for updates, choose Tools > More Options > Installation and set Check for Updates to Daily, Weekly or Do not check.

See also: Help=>Check for Updates, Installation.

3.2.2. Help > Check for updates… fails or shows an error. What can I do?

Possible causes:

  • Proxy or firewall: an error such as couldn't resolve host name means that UniPlot cannot reach the update server. Download the installer manually from the UniPlot website or let your IT department deploy it.

  • Other messages: note the exact text of the message and contact the UniPlot support.

  • Frozen start: if UniPlot does not start at all and you cannot use the update function, download the latest installer from the website and install it.

See also: Help=>Check for Updates.

3.2.3. The UniPlot download fails, aborts or the file is corrupt. What can I do?

  • Select the UniPlot version you need on the download page.

  • If a download aborts or the file is corrupt, select another download server offered on the page.

  • Depending on your settings you may have to disable your antivirus software temporarily for the download.

  • Messages such as Bad Gateway or an installer that reports it cannot run on this PC come from the download servers, not from your PC. Try again later or contact the UniPlot support.

  • The setup is too large to be sent by e-mail; use a download link.

  • If possible, use Help > Check for updates… instead of the browser download: the download can be resumed after an interruption, and virus scanners cause fewer problems.

See also: Help=>Check for Updates.

3.2.4. How can I get an older UniPlot version?

Contact the UniPlot support and state the release you need. Typical reasons are that only that release is approved in your company, that a newer release introduced a problem, or that you need to reinstall after a PC change. If the older release needs a different license file, see Dialog Box=>License.

Several UniPlot versions can be installed side by side (see Can I install several UniPlot versions on the same PC?). A 32-bit version is no longer available since R2020.0; the last 32-bit version is R2018.13.

See also: Dialog Box=>License.

3.2.5. Can I install several UniPlot versions on the same PC?

Yes, several versions can be installed side by side, for example to test your scripts before migrating. Note:

3.2.6. How can I choose which UniPlot version opens .ipz and .ipw files when several versions are installed?

Start the version you want to use once. UniPlot registers the file associations of the version that was started last, so afterwards a double click opens the files with it. If the association stays on the wrong version, open the UniPlot command window of the version you want as default and run:

_unregister_uniplot()
_register_uniplot(1)

These functions reset the Windows registry entries for .ipz and .ipw.

3.3. Windows versions, virtual machines and compatibility

3.3.1. Which Windows versions does UniPlot support (Windows 10, Windows 11, Windows 7, 32-bit)?

UniPlot runs on Windows 10 and Windows 11 (64-bit). These are the operating systems listed in the system requirements (see Installation of UniPlot).

See also: Installation of UniPlot.

3.3.2. Do I have to install the Microsoft Visual C++ Redistributable before installing UniPlot?

Normally not. The UniPlot setup copies the Visual C++ runtime files that UniPlot needs (for example vcruntime140.dll and msvcp140.dll) into the Program folder of the installation. A separate Redistributable setup is not needed, also not on a new Windows 11 PC.

If UniPlot or the setup still reports a missing Visual C++ runtime DLL:

  1. Install UniPlot again.

  2. Check whether security software or a restricted installation folder removed or blocked files in the Program folder.

  3. As a last resort, ask your IT department to install the current Microsoft Visual C++ Redistributable (x64).

See also: The installer fails with .dll unpacking or extraction errors, or I cannot reinstall. What can I do?, UniPlot does not start or crashes at startup - what can I do?.

3.3.3. The setup does not start on Windows 11, or UniPlot does not start after installation on Windows 11. What can I do?

  • The setup EXE does not start at all: the Windows file association for EXE files may be misconfigured. This is a Windows setting, not a UniPlot problem. Repair it and use an account with local administrator rights.

  • UniPlot does not start: update to the latest UniPlot version and work through UniPlot does not start or crashes at startup - what can I do? (autoload files, LocalStore and AutoSave folders, user home directory, default printer).

  • For further analysis, note the exact UniPlot version and whether UniPlot starts in a reduced state or crashes. Also collect the log files from the log folder of the user directory, the result of Help > Check drive speed… and the path of the user directory.

See also: Startup Problems, Crashes and Error Messages, Help=>Check Drive Speed.

3.3.4. After updating to a new release, I cannot open or create files. What can I do?

  1. Close UniPlot. Empty the LocalStore and AutoSave folders (see UniPlot does not start or crashes at startup - what can I do?, step 3) and start UniPlot again. Copy documents you still need from AutoSave first (see A UniPlot file can no longer be opened, or UniPlot crashed with unsaved work - can it be recovered?).

  2. If the error remains, a corporate security or protection system may be blocking the new release. Ask your IT department to allow the new UniPlot installation (the program folder and uniplot.exe). Since R2026.1, uniplot.exe is signed with a digital certificate, which makes allow-listing easier.

  3. Until your IT department has allowed it, continue with the previous release. Several releases can be installed side by side (see Can I install several UniPlot versions on the same PC?).

See also: UniPlot does not start or crashes at startup - what can I do?.

3.3.5. Can UniPlot run on a virtual machine, VDI, Citrix or a terminal server?

Yes. Current UniPlot versions install on a virtual PC or VDI in the same way as on a physical computer. UniPlot also works through Remote Desktop (RDP) and Citrix. Check these points:

Releases that are no longer supported (for example R2011) were not tested in virtual environments.

See also: Which graphics rendering setting should I use for the screen and for printing?.

3.3.6. Can documents and scripts from an old UniPlot version (for example from 2012) be used in the current version?

Yes, in general:

  • Documents and data files are forward compatible: IPZ and IPW documents created with an older version open in a newer one. The reverse is not guaranteed: a document saved with a newer version may not open in an older one.

  • UniScript scripts normally keep working. Functions that should no longer be used are kept and listed under Obsolete Functions.

  • External DLLs and COM components: since R2020.0, UniPlot is only available as a 64-bit version. Scripts that call your own DLLs or COM components need 64-bit versions of them.

Before you roll out a new release company-wide:

  1. Install the new release side by side with the old one (see Can I install several UniPlot versions on the same PC?).

  2. Test your important scripts and documents in the new release.

  3. Read the What’s New pages of the releases in between (for example New in R2026).

See also: Obsolete Functions, Which Windows versions does UniPlot support (Windows 10, Windows 11, Windows 7, 32-bit)?.

3.3.7. Why are icons and menus squeezed when Windows display scaling is high (for example 250 percent)?

Use a lower scaling factor in the Windows display settings and restart UniPlot. For small fonts and tabs on high-resolution displays see UniPlot tabs and fonts are very small on a high-resolution display - what helps?.

3.3.8. Which graphics rendering setting should I use for the screen and for printing?

Choose Tools > More Options > Installation. You can select the rendering method separately for the screen and for the printer:

  • Graphics Rendering Screen: 1: GDI, 2: GDI+ or 3: Direct2D (Default).

  • Graphics Rendering Printer: 1: GDI (Default) or 2: GDI+. Direct2D is only offered for screen output.

If the display shows artefacts or black areas, or is slow on a particular PC or virtual desktop, try another rendering method. The exact steps are described in The UniPlot window, diagram or page shows black areas, black bars, garbled display or missing graphics - how do I fix it?.

See also: Installation.

3.4. User directory, settings and autoload

3.4.1. Where is the UniPlot user directory and how do I change it?

By default the user (home) directory is Documents\UniPlot. It contains your own scripts, the Autoload and AutoSave folders, the updates folder, formula files and log files.

  • To see the path, open Tools > More Options > Paths and Files > User Home Directory.

  • To open the folder in the Windows Explorer, choose Help > Open User Directory….

  • The folder LocalStore with cached data is located in the local user directory (GetUserDirectory(1)). This is the user home directory if it is on a local drive, otherwise C:\Users\<user>\AppData\Local\UniPlot.

To change the directory:

  • R2024.2 and later: change User Home Directory directly in Tools > More Options > Paths and Files.

  • Older versions: use the registry or UniScript instead:

    • Registry: value User-Home-Directory under HKEY_CURRENT_USER\Software\RSB\UniPlot5\settings.

    • UniScript command window (the folder must already exist; use doubled backslashes or forward slashes):

      WriteProfileString("Settings", "User-Home-Directory", "D:\\MyUniPlotHome")
      

Restart UniPlot afterwards and move or copy the old contents if needed. GetUserDirectory only reads the current value. The directory must be writable, have enough free space and be quickly accessible (no unreliable network share).

See also: Help=>Open User Directory, Tools=>More Options, UniPlot’s Use of the Windows Registry, WriteProfileString.

3.4.2. UniPlot cannot read the formula list or constants, or imports from an external drive produce empty NC files. Is it a permission problem?

Possibly. The UniPlot user directory must be writable. An unreadable formula list or empty NC files appear when the user directory is not writable, for example after a Windows update removed local rights. Options:

  1. Move the user directory to a writable local folder (see Where is the UniPlot user directory and how do I change it?).

  2. Define a fixed local directory for the converted data files under Tools > More Options > Data Import and Data Browser > Data File Directory, so UniPlot only reads from the external drive.

  3. For very large files enable Delayed Channel Import (supported for the MDF and TDM import filters) to shorten the load time.

Check the *.log files in the user directory for permission errors.

See also: Data Import and Data Browser.

3.4.3. Can I prevent UniPlot from creating .nc2 files, and how much disk space do they need?

No. Importing a data file converts it to a UniPlot data file (.nc2) of roughly the same size as the original. UniPlot needs this file to work. The file is kept after the session because it can hold formula results, points of interest and other data. Delete it manually when you no longer need it.

The files are created next to the original file, or in the folder set under Tools > More Options > Data Import and Data Browser > Data File Directory. Clean this folder regularly: manually, with a batch file or with a UniScript routine that removes files above a size threshold.

See also: Properties of UniPlot data files (nc2), Data Import and Data Browser.

3.4.4. Is there an autosave function for documents?

Yes. UniPlot stores automatic backups in the folder AutoSave of the user home directory. After an improper shutdown, UniPlot reopens documents from this folder at the next start (see Every time I start UniPlot, old documents, windows or the last data file open. How can I stop this?). To recover an unsaved document, see A UniPlot file can no longer be opened, or UniPlot crashed with unsaved work - can it be recovered?. To store the files elsewhere, change the user directory (see Where is the UniPlot user directory and how do I change it?).

3.4.5. How can I export my settings and transfer them to a new UniPlot version or a new PC?

There is no single command that moves everything. Combine the following:

  1. Settings and colours - in the UniPlot command window:

    AppSaveSettings(r"D:\UNIPLOT\ASET01.inb");    // save settings
    AppLoadSettings(r"D:\UNIPLOT\ASET01.inb");    // load settings on the new installation
    UserColorExport("d:/uniplot_color.ini");      // export colours
    UserColorImport("d:/uniplot_color.ini");      // import colours
    
  2. All registry settings - the most complete way:

    registry_save(r"d:/my-uniplot-settings.xml");
    registry_load(r"d:/my-uniplot-settings.xml");
    

    Alternatively export the key HKEY_CURRENT_USER\Software\RSB with regedit (right-click > Export) and import the .reg file on the new PC. Do this before the first UniPlot start if possible.

  3. User directory - copy the complete UniPlot folder of the user directory (own scripts, formula files and so on). On the new PC start UniPlot once and close it so the folder is created, then overwrite it with the old one.

For the licensing steps on a new PC see Dialog Box=>License.

See also: AppSaveSettings, AppLoadSettings, AppGetFileNameSettings, registry_save, registry_load.

3.4.6. How can I deploy custom colours through the registry, and why do they appear with wrong colours?

Swap the first and the last byte of every value. Custom colours are stored in HKEY_CURRENT_USER\Software\RSB\UniPlot5\settings as custcolor0 to custcolor12. The hexadecimal value is not RGB: red and blue are swapped (BGR). To obtain the colour RRGGBB, write the value as BBGGRR. Example: the registry value d2f5ff gives the colour fff5d2, and ff9100 gives 0091ff.

See also: UniPlot’s Use of the Windows Registry.

3.4.7. Can I use different settings or profiles (for example different colour definitions) for different UniPlot versions?

Not directly. Settings are global per Windows user: colours, user directory and other changes affect all installed versions for that user. To get separate profiles:

  • Use two Windows users on the same PC. Each has its own registry keys and user directory.

  • Or use the global options file (Tools > More Options > Paths and Files > Global Options File Location) to load a defined configuration, see AppSaveSettings.

See also: Tools=>More Options.

3.4.8. The drive or folder paths I set in UniPlot are not saved and are reset after each restart. Why?

A script in the Autoload folder of the user directory sets the paths at every start and overrides the saved settings. Reinstalling does not help because the user directory is kept.

  1. Open the user directory (Help > Open User Directory…).

  2. Move scripts of unknown origin that set paths out of the Autoload subfolder.

  3. Restart UniPlot.

The full procedure is described in UniPlot does not start or crashes at startup - what can I do?, step 2.

3.4.9. Can I move the autoload directory or the user directory to OneDrive or another drive?

Yes. Check the path options under Tools > More Options > Paths and Files and correct them if UniPlot reports errors at start. Prefer local folders. If you place the user directory in OneDrive, make sure the folder is fully synchronised (see UniPlot does not start or crashes at startup - what can I do?, step 4).

3.5. Start-up behaviour

3.5.1. Every time I start UniPlot, old documents, windows or the last data file open. How can I stop this?

Three mechanisms can open files at start-up. Check them in this order:

  1. AutoSave and LocalStore: UniPlot reopens documents that were open at the end of the last session or before an improper shutdown. Close UniPlot. Save everything you need, then delete or move the files in the folders AutoSave and LocalStore. To open the user directory, choose Help > Open User Directory…. For the locations and the full procedure, see UniPlot does not start or crashes at startup - what can I do? (step 3) and UniPlot opens many old templates or IPZ files at start, or hangs at “loading DLL libraries” while restoring previous files - how can I stop that?.

  2. Autoload scripts: scripts in an Autoload folder (in the user directory or in the program directory) may open documents. Back them up and remove the unwanted ones.

  3. Last data file in the Data Browser: choose Tools > More Options > Data Import and Data Browser and switch off Open the last recently used data file at start up. Confirm with OK and restart UniPlot. The option is on by default.

The File List window does not control the start-up. Its Configuration… command (right-click the column header or the free space of the File List window) only selects which file lists are shown, for example Recent UniPlot Files, and how many recent files are listed (see Configuration).

See also: The File List Window, Help=>Open User Directory.

3.5.2. UniPlot shows error messages at start, hangs at “Loading DLL libraries” or does not start. What should I do?

Start with UniPlot does not start or crashes at startup - what can I do? (start UniPlot with /NoAutoLoad). The chapter Startup Problems, Crashes and Error Messages describes the complete procedure for start-up errors (for example E06D7363 or C0000005), an empty file list, a faulty autoload script, a damaged LocalStore or AutoSave folder and an inaccessible user home directory. See also Error E06D7363 at start-up (or on every import) - how do I fix it?, Error C0000005 or Internal Error -1073741819 - what does it mean? and An error appears at start-up and the file list, user toolbar, data browser or sidebar tabs are empty or missing - how do I fix it?.

Causes that are specific to the installation:

  • With a floating license: a poor or missing connection to the license server.

  • A freshly installed UniPlot without internet or with an unstable connection can show a message with unreadable characters during the update check. Restart the PC with a stable connection, or set Check for Updates to Do not check under Tools > More Options > Installation.

  • If the problem persists, install UniPlot into a folder on a drive other than C: (see How do I install UniPlot step by step?) and use an account with administrator rights for the installation.

3.5.3. UniPlot installed through a software centre hangs at the start screen (“not responding”), even after reinstalling. What should I do?

Ask your IT department for a fresh installation of the current UniPlot release, and check the autoload folders as described in UniPlot does not start or crashes at startup - what can I do?. The hang happens when the installation becomes inconsistent, for example when the IT department replaces the machine, removes software or applies forced installations. If the license file is missing after the reinstallation, see Dialog Box=>License.

See also: Startup Problems, Crashes and Error Messages.

3.5.4. How can I suppress the splash screen, for example when UniPlot runs in hidden mode?

Set the registry value Settings/StartUp to 0. In the UniPlot command window:

bool = WriteProfileInt("Settings", "StartUp", 0)

If bool is 1, the splash screen is no longer displayed.

See also: WriteProfileInt, UniPlot’s Use of the Windows Registry.

3.5.5. How can I prevent UniPlot from creating a desktop shortcut each time it starts?

This occurs when UniPlot is started from a network share or a batch file.

  1. Delete the existing UniPlot icon from the desktop.

  2. Open Tools > More Options > Installation.

  3. Disable the three options Update UniPlot Start Menu, Update UniPlot Desktop Icon and Update UniPlot Quick Launch Icon.

UniPlot no longer recreates the links.

See also: Network Installation, Installation.

id-1800069