Paint.NET

documentation

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.

Tip

If the file path or filename has spaces in it, wrap the parameter in quotes. E.g.
paintdotnet:"C:\Users\Fred\Documents\Cool Icons\RickAstley.png"
will work. Without the quotes
paintdotnet:C:\Users\Fred\Documents\Cool Icons\RickAstley.png
will not work because of the space between Cool and Icons.

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)

Paint.NET repair utility
Paint.NET repair utility

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.

Paint.NET repair verification
Paint.NET repair verification

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)

Paint.NET protocol > Open Crash Log
Paint.NET protocol > Open Crash Log

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)

Paint.NET protocol > Force Update Check
Paint.NET protocol > Force Update Check

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)