/gephi-plugins

Repository for Gephi Plugins maintained by the team. Each plugin has it's branch.

Primary LanguageJavaScript

This repository is an out of the box development environment for Gephi plugins. It contains the latest stable version of Gephi modules so you can run a development version of Gephi in seconds. Checkout the Bootcamp for examples of the different type of plugins you can create.

Branches contains Gephi Plugins supported by the core team:

Get started

Follow the steps to get the right development environment for developing Gephi plug-ins.

  • Download and install the latest version of Netbeans IDE.

  • Fork and checkout the latest version of this repository:

      git clone git@github.com:username/gephi-plugins.git
    
  • Start Netbeans and Open Project. This folder is automatically recognized as a module suite.

  • Right click on the project and select 'Run'. This starts Gephi.

You can also run Gephi from the command-line using the 'ant run' command.

Create a plugin

Create a new module

  • In Netbeans, expand the '''Gephi Plugins''' project and right-click on Modules. Select '''Add New...'''
  • Enter the plugin name: '''MyFirstPlugin''' and click '''Next'''.
  • In the next panel, enter a unique codebase name, for instance '''org.myname.myfirstplugin''' and click '''Finish'''.
  • In the Netbeans Project tree, you should see now your module '''MyFirstPlugin'''. Expand it to find its Source Package. Here you will place your code.

Brand your plugin

  • Right-click on your plugin project '''MyFirstPlugin''' and select '''Properties'''.
  • Select '''Display''' on the left panel and fill '''Display Category''', '''Short Description''' and '''Long Description'''.
  • Select '''Packaging''' on the left panel and fill '''License''', '''Homepage''' (if exists) and '''Author''' information.
  • Click on OK to validate changes.

Distribute your plugin

When you successfully tested your plugin, it's time to create a release. Verify that you have latest updates of Gephi JARs:

  • Pull latest changes:

      git checkout master
      git pull
      git checkout mybranch
    
  • Test your plugin again in case of an update. If it's okay:

  • Right-click on the project and select '''Package As''' and then '''NMBs'''.

  • Go to the '''build''' folder and find the created '''plugin-release.zip''' file. Individual NBM files (one per each module) are packaged in this zip.

Now you can publish you plugin on the Gephi Plugin portal.

Plugins Portal

Our wiki contains a good list of tutorials to code plugins. Also checkout the Bootcamp for real examples.