Edit Plugin Path

The Plugin Path is a preference that indicates where Ghidra should search for Java classes outside of the standard installation locations.  User developed Java classes can be used to extend Ghidra with additional plugins and data types.

All plugins discovered by Ghidra can be displayed in the Configure dialog for all tools. All known data types are shown in the Data Type Manager display.

The User Plugin Paths list shows the paths in the order to be searched. Each path is either a directory path or a jar file path. If the path is a directory, then only class files in that directory will be used (not jar files within that directory). If the path is a jar file, then classes within the jar file will be used.

The User Plugin Jar Directory shows the directory that contains jar files to search.

In addition to the above, Ghidra also searches in the installation directory, in the <home>/.ghidra/.ghidra-<version>/plugins directory, if it exists.

The directories noted above, as well as any found jar files, are added to Ghidra's classpath. The search order of these paths is:

  1. Jar files in User Plugin Jar Directory (Plugin Path preference)
  2. Jar files in the Ghidra plugins installation directory
  3. User Plugin Paths from the Plugin Paths preference

Editing Plugin Paths

After you make a change to the plugin path, you must restart Ghidra to see the effects.

Add a Plugin Path

To add a Plugin Path,

  1. From the Ghidra Project Window, select Edit Plugin Path...
  2. The Edit Plugin Path dialog is displayed; in the Directory or Jar File Name field
    • Select the Add Jar... or Add Dir... button to choose either a jar file or directory from the file system.
    • Locate and select the appropriate jar file or directory within the file chooser dialog.
    • Select the Add Jar, or Add Dir button within the file chooser dialog.
  3. Select the Apply or OK button from the Edit Plugin Path dialog.
    • Apply applies the changes and leaves the dialog up.
    • OK applies the changes and dismisses the dialog.

Change the Search Order

To change the search order of the paths within the User Plugin Path list, 

  1. Select a path from the User Plugin Paths list.
  2. Select the button to move the path up in the list; select the to move the path down in the list. 

The search order is important when you have different versions of a plugin in different jar files. The first class that is loaded is the one that you will be using when you run Ghidra. 

Set the User Plugin Jar Directory

  1. Enter the absolute directory path in the User Plugin Jar Directory field, OR click on the ... button to choose a directory from the file system.
  2. Select the Apply or OK button.
    • Apply applies the changes and leaves the dialog up.
    • OK applies the changes and dismisses the dialog. 

Remove Paths

  1. From the Ghidra Project Window,  select Edit Plugin Path...
  2. Select a User Plugin Path.
  3. Click the Remove Button.
  4. Click Apply or OK.
  1. Clear the User Plugin Jar Directory field.
  2. Select the Apply or OK button.
    • Apply applies the changes and leaves the dialog up.
    • OK applies the changes and dismisses the dialog.

When you click on the Apply or OK button, your preferences file in your <home>/.ghidra/.ghidra-<version> folder is updated immediately.



If you have a tool that was built with Plugins that came from the paths that you removed, you will get an error message listing each Plugin that could not be found when you re-open the project or when you launch that tool.



Related Topics: