Revision Date: 15 January 2023

paintdotnet: protocol

The paintdotnet: protocol is used to launch the app with command-line parameters (e.g. images you wish to open). This method of starting paint.net is supported by both Classic and Store versions.

Using the Protocol

To use the protocol, go to Start -> Run (or use Windows Key + R) and type in paintdotnet:"path to file1.png" path_to_file_2.png followed by the Enter key. The app will start and open both the specified files.

If paint.net is already open, the specified images will be opened in the instance of paint.net that's already running.

Running paint.net From a Batch File

In a batch file use start paintdotnet:"%1". Where %1 is the path and filename of the image you wish to open.

To open multiple files, use multiple instances of the protocol.

                @echo off
                start paintdotnet:"C:\Users\Fred\Documents\Cool Icons\Rick.png"
                start paintdotnet:"C:\Users\Fred\Documents\Cool Icons\Astley.png"
            

Running the paint.net Repair Utility (Classic paint.net only)

Open the Windows Run command using either of the following methods
Option 1: In the Search bar, type Run and press Enter
Option 2: press both Windows Key + R at the same time
Type in paintdotnet:/repair followed by the Enter key (or click OK)

This command will run PdnRepair.exe from your paint.net installation directory. The repair tool will verify the paint.net installation and integrity of the files.

Opening the Crash Log folder

Open the Windows Run command using either of the following methods
Option 1: In the Search bar, type Run and press Enter
Option 2: press both Windows Key + R at the same time
Type in paintdotnet:/openCrashLogFolder followed by the Enter key (or click OK)

Force Update Check

This is intended for troubleshooting scenarios to simplify acquiring the latest version.
Open the Windows Run command using either of the following methods
Option 1: In the Search bar, type Run and press Enter
Option 2: press both Windows Key + R at the same time
Type in paintdotnet:/forceUpdateCheck followed by the Enter key (or click OK)

Disable Plugins

This is intended for troubleshooting scenarios where plugins are suspect. Running this command argument stops plugins from being loaded at startup.
Open the Windows Run command using either of the following methods
Option 1: In the Search bar, type Run and press Enter
Option 2: press both Windows Key + R at the same time
Type in paintdotnet:/disablePlugins followed by the Enter key (or click OK)