Add-ons (install)

What is an Add-on?

Particular preferences of Freeplane are installable and kept in the Freeplane user directory (see Tools->Open user directory). An add-on is a package of some or all of these features, which can be installed at once.

Add-ons may contain any number of scripts and Zip files to be unpacked in the Freeplane user directory. Some of the possible applications:

• Scripts: single scripts and Script libraries, optionally with accompanying libraries/JARs/class files. This way it's possible to bundle some Groovy scripts with the JFreechart library - so there's no need to download and install the JFreechart libraries anymore.
• Icons: single icons, icon libraries or even a complete replacement of all Freeplane icons
• Plugins. Since plugins may also be installed into the Freeplane user directory, add-ons may also provide plugins (such as the Scripting or Formula plugin you know).
• Preferences.
• Translations for menu items, config options etc.
• Keyboard shortcuts (scripts only).
• Script permissions (per script).
• ...

Installing an add-on

The add-on has the form of a mind map. To install the package you simply download the mind map and follow the procedure:

1. copy the link location of the download links (use context menu of your web browser). 2. Open the Manage Add-ons dialog via Tools->Add-ons. 3. Enter the copied link in the text field at the bottom of the dialog. 4. Click on Install. 5. Restart Freeplane.

You will find the new command in the menu. (For instance "Insert Inline Image" can be found under Edit->Node extensions and it will have the shortcut Ctrl+Shift+i.)

Here are the first packages, for use with preview versions only:

Packages for users

Add-on Insert Inline Image

This script asks for an URL and inserts an HTML <img> tag at the end of the node's text. If the node is not already an HTML node it will be converted. Known from the example scripts page. The new menu item can be found under Edit->Extensions and it is bound to Control+Shift+i.

Download

Add-on Example Theme

This little theme add-on installs the old link icons (Link.png and LinkLocal.png).

Download

Add-on for developers (Developer Tools)

This add-on collects some utilities that script and/or add-on developers will find useful. The new functions are available under Tools -> Development Tools. Among other:

• Check Add-on: Adds all standard nodes, attributes and notes to the current map. Can be used with an empty Map to create an add-on skeleton.
• Release Add-on: It copies the <addon>.mm to <addon>-<version>.mm and updates the script node's context from the files lying around.
• freeplane.dsld: Adds Eclipse editor support for predefined script bindings such as node, c, ui, textUtils, ...
• Insert Binary: Asks for a file to insert as text of the current node (BASE64 encoded).

Download

N.B. Scripts are contained just as node text. Zips are BASE64 encoded and also inserted as node text. Script and add-ons developers should first install the Developer Tools add-on. It provides scripts that relieves you from most of the tedious work.