paint.net

documentation

Revision Date: 27 August 2015

Unattended Installation

paint.net supports unattended installation so paint.net can be installed without user interaction. There are two facilities provided for unattended installation:

MSI Deployment

Using the /createMsi command-line parameter (detailed below), MSI packages can be created for AD/GPO deployment.

Two MSI packages will be created when this command is used, 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.

The MSI properties listed in the second table (below) can be configured with the command-line when using /createMsi.  These MSI properties are automatically patched into the generated MSIs 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.4.0.Install.exe is the setup package downloaded from the paint.net website:

Example

paint.net.4.0.Install.exe [/skipConfig | /auto | /createMsi] [PROPERTY=VALUE...]

Configuration Options

/skipConfig

Skips configuration of options and install directory. Uses MSI properties in the following order of precedence:

  1. Supplied via 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.

/createMsi

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

PROPERTY=VALUE

Sets an MSI property named PROPERTY to equal VALUE.  Multiple property values can be specified. See below for a list of applicable properties.

Note

If VALUE has a space in it, 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 use the /auto command-line option. 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 into. %PROGRAMFILES%, usually stands for C:\Program Files.

CHECKFORUPDATES

1 (>0 when /createMsi is specified)

Enables (1) or disables (0) automatic update checking.

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.

TGAEDITOR

1

Register as the default editor for TGA image types.

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.4.0.Install.exe /auto

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

paint.net.4.0.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.4.0.Install.exe /auto "TARGETDIR=E:\Image Apps\paint.net" CHECKFORBETAS=1