IntelliJ IDEA 14.0.0 Web Help

Edit Tool Dialog

File | Settings | Tools | External Tools


The dialog opens when you click add, copy or edit1 on the External Tools page.

Use this dialog to enable using a specific external tool from IntelliJ IDEA, specify the menus to access it from, define where to display the tool's output, and configure the filters to distinguish it from other output. Based on these filters, IntelliJ IDEA displays paths to the tool's output files as links. When you click such link, the corresponding file is opened in the editor.

Item Description
Name In this text box, specify the name to identify the tool in the IntelliJ IDEA menus.
Group Use this drop-down list to specify the group the current tool belong to. Type a new name or select an existing group from the list.
Description In this text box, provide an optional description of the tool.
Options In this section, specify the following options:
  • Synchronize files after execution: When this check box is selected, IntelliJ IDEA detects all externally changed files and reloads them from a disk on completing tool execution.
  • Open console: Select this check box to have IntelliJ IDEA open a console to display output of the configured external tool.

    When this check box is selected, you can opt to display output of stderr and stdout:

12.0+Show console when standard out changes Select this check box to activate output console and bring it forward, if associated process writes to Standard.out.
Show console when standard error changes Select this check box to activate output console and bring it forward, if associated process writes to Standard.err.
Output Filters Click this button to open the Output Filters dialog box where you can define the filters to distinguish the output of the external tool from other output. Based on these filters, IntelliJ IDEA displays output file paths in output messages as links. When you click such link, the corresponding file is opened in the editor.
Show In In this area, specify the menus the tool should be available from. The available options are:
  • Main menu - select this check box to have the tool command added to the Tools menu.
  • Editor menu - select this check box to have the tool command added to the context menu of the editor.
  • Project views - select this check box to have the tool command added to the context menu of the Project tool window.
  • Search results - select this check box to have the tool command added to the context menu of the Search Results area in the Find tool window.
Tool Settings In this area, specify the following options:
  • Program: Use this field to specify the location of the external tool's executable file in one of the following ways:
    • Type the path explicitly in the text box.
    • Click the Browse button browseButton to open the Select Path dialog box and navigate to the desired location.
    • Click the Insert Macro button to open the Macros dialog box where you can select the desired macro from the list.
  • Parameters: Use this field to define the parameters of the external tool in one of the following ways:
    • Type the list of parameters in the text box.
    • Click the Insert Macro button to open the Macros dialog box where you can select the desired macro from the list.

    When specifying the parameters, follow these rules:

    • Use spaces to separate individual parameters.
    • If a parameter includes spaces, enclose the spaces or the argument that contains the spaces in double quotes, for example, some" "arg or "some arg".
    • If a parameter includes double quotes (e.g. as part of the argument), escape the double quotes by means of the backslashes, for example, -Dmy.prop=\"quoted_value\".
  • Working directory: Use this field to define the working directory of the external tool in one of the following ways:
    • Type the path explicitly in the text box.
    • Click the Browse button browseButton to open the Select Path dialog box and navigate to the desired location.
    • Click the Insert Macro button to open the Macros dialog box, where you can select the desired macro from the list.

See Also

Last modified: 12 November 2014
comments powered by Disqus