How to use the External Command Plugin to send screenshots to other applications

Configuring external commands

Ever wondered what is the quickest way to have Greenshot output images to other applications on your PC, e.g. your favorite image manipulation software, upload application or instant messenger?

The Greenshot installer comes with a handy plugin called "External Command Plugin", allowing Greenshot to output files to a large number of other programs on your computer. E.g. if you prefer Adobe Photoshop or Inkscape for editing your screenshots, it is an easy task to configure custom destinations which you then can select like any other destination. This will work for any program that offers a command line interface accepting an image path.

What is a command line interface?

A command line interface can be used to send commands to a program, e.g.

explorer.exe C:
will open Windows Explorer and display the contents of your local hard drive C:

copy myfile.txt myfile-2.txt
will create a copy of myfile.txt, creating a new file called myfile-2.txt

mspaint.exe "C:\path\to\image.png"
will open MS Paint to edit image.png located in C:\path\to\ (of course, these are just examples, there's probably no directory called C:\path\to on your hard drive)

You can execute commands yourself using the Windows command line tool (called cmd.exe)

But you can also configure Greenshot to execute commands like these which comes very handy if you often need to pass your screenshots to other software.

So how does Greenshot's External Command Plugin work?

List of external commands It's easy... Right click the Greenshot systray icon and click "Configure external commands".

(If it is not there, you are either using an old version of Greenshot or did not select to install the External Command plugin during the installation process. In both cases, you should download the latest version of Greenshot's installer and install it. When the installer asks about plugins to install, make sure to check the box next to "External Command Plugin", and proceed with the installation.)

After doing so, the configuration dialog opens up. For your convenience, we have already added MS Paint to the list (i.e. you can already use it as a screenshot destination from Greenshot's image editor or destination picker.)
Let's have a look at its configuration: click "MS Paint" in the list and then the "Edit" button on the right-hand side, you'll see the configuration options for the MS Paint command:
External command configuration window

  • Name: how the external command is displayed by Greenshot, you can put in there whatever you like, e.g. MS Paint
  • Command: path and file name of the executable program accepting the image, e.g. C:\Windows\System32\mspaint.exe
  • Argument: additional information to pass to the program, e.g. "{0}"

In the Argument section {0} will be replaced with the path of the temporary file you are about to export from Greenshot. You should wrap this in double quotes, otherwise it could lead to unexpected behavior if the file name or path contains whitespace characters.

You can close this window. Now that you've had a look at the MS Paint command, you're ready to configure external commands yourself. Simply use the "New" button to add new commands and they will be available in the editor and destination picker.

Please note: not every program offers a command line interface, and arguments are often different than in this example. We (the Greenshot development team) will not be able to offer guidance for working with third party software. Read the other program's documentation or contact its developers to find out whether and how it is possible to pass an image via command line arguments.