Documentation

Unattended Installation

Paint.NET supports unattended installation which enables you to install Paint.NET with no user interaction. There are two facilities provided for unattended installation:

  • MSI-Based Deployment is designed for use with Active Directory and Group Policy in order to install Paint.NET on multiple user systems on an administrated network.
  • Automatic Installation is useful for general scripting or automation purposes for personal use.

MSI Deployment

Using the /createMsi command-line parameter detailed below, you may create MSI packages useful for AD/GPO deployment.

Two MSI packages will be created when you use this command, one for each CPU architecture (x86 and x64). The x86 MSI is for 32-bit Intel/AMD systems. The x64 MSI is for Intel/AMD systems that have both a 64-bit CPU and a 64-bit "x64" edition of Windows.

Warning

The x86 MSI (PaintDotNet.x86.msi) will not function on 64-bit systems, so plan your deployment accordingly.

Additionally, the MSI properties listed in the 2nd table below may be configured on the command-line when using /createMsi. These MSI properties will be automatically patched into the MSI's that are generated so no further transforms should be necessary.

Automatic Installation

To perform an automatic installation, use the /auto or /skipConfig command-line parameter detailed below.

Command-Line Syntax

The setup package supports the following command-line syntax, where Paint.NET.3.5.Install.exe is the setup package downloaded from our website:

Example

Paint.NET.3.5.Install.exe [/skipConfig | /auto | /createMsi] [PROPERTY=VALUE...]

Description of Options

/skipConfig

Skips configuration of options and install directory. Uses MSI properties in the following order of precedence: 1. supplied on command-line, 2. read from HKLM\Software\Paint.NET, 3. default values.

/auto

Like /skipConfig, but does not show the final wizard page that details the result of installation. This option provides a completely automated install that requires no user interaction to start or finish the installation.

/createMsi

This will create two MSI packages in a folder on your desktop called PaintDotNetMsi. These MSIs are each targeted at a specific OS/CPU platform type (x86 or x64). These may be deployed via standard AD/GPO mechanisms, and are already patched with the MSI properties that you specify using the PROPERTY=VALUE command-line options (if any).

PROPERTY=VALUE

TSets an MSI property named PROPERTY to equal VALUE. You may specify multiple property values. See below for a list of applicable properties.

Note

If VALUE has a space in it, you must enclose the entire PROPERTY=VALUE text inside quotation marks. For example, to set the hypothetical TEST property equal to "1 2 3", you would specify "TEST=1 2 3" on the command-line, including the quotation marks.

For a default automatic installation it is sufficient to just use the /auto command-line. Further customization is possible by changing the values of the MSI properties, where "1" is used for enabling a behavior or action, and "0" is used for disabling it:

MSI Property Name

Default Value

Description

TARGETDIR

%PROGRAMFILES%\Paint.NET

Specifies the directory to install Paint.NET to %PROGRAMFILES%, usually stands for C:\Program Files.

CHECKFORUPDATES

1 (0 when /createMsi is specified)

Enables (1) or disables (0) automatic update checking. Please note that on Windows XP, checking for updates is only enabled and allowed in the first place for users that are in the local Administrators group. It is not possible to enable this for users that are not in the Administrators group.

CHECKFORBETAS

0

When checking for updates, also check for pre-release ("beta") versions.

JPGPNGBMPEDITOR

1

Register as the default editor for JPG, PNG, and BMP image types. Note that this registers Paint.NET for the "Edit" verb, which does not change the default double-click ("preview") behavior in Windows.

TGAEDITOR

1

Register as the default editor for TGA image types. Note that this registers Paint.NET for the "Edit" verb, which does not change the default double-click behavior in Windows.

DESKTOPSHORTCUT

1

Create a shortcut on the desktop for launching Paint.NET.

PROGRAMSGROUP

[blank]

This configures which Start menu Programs group the Paint.NET shortcut will be placed into. By default this is blank which places the shortcut "loose" at the top of the hierarchy among other shortcuts such as Windows Media Player and Internet Explorer.

This is commonly used to place the Paint.NET shortcut into a group such as "Graphics Applications" or something similar. If you want to place Paint.NET in a group-within-a-group, use syntax similar to that for file paths. For example, to place Paint.NET into the "Graphics" group inside of the "Applications" group (i.e., "Start menu -> All Programs -> Applications -> Graphics") specify "PROGRAMSGROUP=Applications\Graphics".

Examples

To install Paint.NET with the default options, to the default installation directory, with no user interaction:

Paint.NET.3.5.Install.exe /auto

To install Paint.NET to a directory called D:\PDN, without creating a desktop shortcut:

Paint.NET.3.5.Install.exe /auto TARGETDIR=D:\PDN DESKTOPSHORTCUT=0

To install Paint.NET to a directory called E:\Image Apps\Paint.NET, and to check for betas when checking for updates:

(Note that the entire TARGETDIR parameter must be enclosed in quotations when the target directory contains one or more space!)

Paint.NET.3.5.Install.exe /auto "TARGETDIR=E:\Image Apps\Paint.NET" CHECKFORBETAS=1