Add-ons (install)

What is an Add-on?

Add-ons are a way to extend and customize Freeplane similar to how plug-ins and extensions can be used to extend and customize well-known applications like Firefox or LibreOffice. Freeplane add-ons can be used to provide a single function, a bundle of multiple functions, bind those functions to a menu item, and much more.

Anybody can write an add-on! (see the add-on developer documentation)

note: add-ons are not necessarily provided by the Freeplane core developers.

Installing an add-on

An add-on is a Freeplane mind map with the special additional suffix <FILENAME>.addon.mm. Add-ons can be installed with a single click with Freeplane version v1.2.10_05 or later.

If Freeplane is not the designated program to open '.mm' files and for Freeplane versions before v1.2.10_05, follow this procedure:

1. In Freeplane, select Tools > Add-ons > Search add-ons > Visit add-on page
2. Search for your add-on and choose download
3. Save the add-on on your computer (for example, on your desktop)
4. Select Tools > Addons > Search and install
5. Select directory icon
6. Find and select the file you just downloaded (for example, on your desktop)
7. Select Install
8. Restart Freeplane

You will now find the new command in the menu. For example, "Insert Inline Image" can be found under Edit->Node extensions with the shortcut Ctrl+Shift+i.)

Add-ons are listed below.

---

FreeIBIS

by L. C. Rees

Issue-Based Information System for Freeplane

Download v0.1.0

---

Freeplane|GTD

This add-on enables using a mind map as a 'trusted system' in the Getting Things Done (GTD) methodology. The hierarchical nature of a mind map is ideal for tracking projects, their associated tasks, and next actions. Features:

• Extracts Next Action lists from nodes marked with a next action icon
• Displays lists sorted by Project, Context, Waiting-For, or Due Dates
• Accepts a simple, natural shorthand notation for entering Next Actions
• Next Actions in lists are hyperlinked back to the GTD mind map for easy editing

See here for more details.

Download latest version

---

http://freeplane.sourceforge.net/wiki/images/2/28/InsertInlineImage-icon.png Insert Inline Image

by Volker Börchers, Rickenbroc

This add-on is a convenient way to add images on the fly in your maps. The images can come from :

• a file from your computer,
• the clipboard : file path or a copy (like a screenshot),
• an url from the internet

You can resize the display (with a preview pane) and put it in :

• node core
• node details
• note
• node extension

You can even decorate the image inserted with a link which point wherever you would want. Download v1.0

---

http://freeplane.sourceforge.net/addons/oldicons-theme/images/oldicons-theme.png Old Icons Theme

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

Download v0.9.5

---

http://freeplane.sourceforge.net/addons/packAndGo/images/packAndGo-icon.png Pack & Go

by Volker Börchers

Pack and Go provides a function to pack a map with all its dependencies into one zip file. All files have to be loaded into the RAM so be prepared to increase Java heap space if you get a "Out Of Memory" Error.

Download v0.4

---

http://freeplane.sourceforge.net/addons/palmIcons/images/palmIcons-icon.png Palm Icons

by Steve Kunkel

Free Palm Os Icons categorized by groups Office, Home.... for Freeplane. Compiled by Steve Kunkel and converted to an Add-on by Predrag. For artist information, see this forum post.

Download v1.0

---

http://freeplane.sourceforge.net/addons/studyPlanner/images/studyPlanner-icon.png Study Planner

by Predrag Cuklin

Study Planner will help in better organization of learning. It is designed for pupils and students in planning everyday school extracurricular activities and obligations. Important functions of Study Planner are:

• organization of subjects and activities by day
• organization of activities by time of learning
• the ability to determine the type of activities
• countdown learning
• creating lists of activity by Day, by Subject, by Type of activity, by Period of learning
• copying list
• print list
• more icons

For more information see this page

Download v1.2.1

---

http://freeplane.sourceforge.net/addons/translation/images/translation-icon.png Translation

by Volker Börchers

Utilities for automatic translation of maps and language resources that use the mymemory translation service. Of most interest for Freeplane translators. The scripts still have some limitations:

• Text size per node/text is limited to 1000 characters.
• Translation time growths mainly with the number of texts/nodes. No optimization for the case of many small texts.

Download v0.6

---

http://freeplane.sourceforge.net/addons/userIcons/images/userIcons-icon.png User Icons

by Predrag Cuklin

This add-on adds standard Freeplane icons under User icons in bigger size (24 px) and adds other icons (computer, more office icons...).

Download v1.1

---

wikdNode

by L. C. Rees

Node wrangling features for Freeplane:

• capitalize first word in node core text
• capitalize all words in node core text
• upper case node core text
• lower case node core text
• delete first chosen characters from node core text
• delete first characters matching a regular expression from node core text
• delete last chosen character from node core text
• delete last characters matching a regular expression from node core text
• delete links on multiple nodes
• split node core tex into multiple nodes on periods
• split node core text into multiple nodes on commas
• split node core text into multiple nodes on spaces
• split node core text into multiple nodes on one or more chosen characters...
• split node core text into multiple nodes before one or more chosen characters...
• split node core text into multiple nodes on characters that match a regular expression...
• split node core text into multiple nodes before characters that match a regular expression...
• splits node core text after one or more chosen characters
• splits node core text after characters matching a regular expression
• join node core text of multiple nodes with spaces
• join node core text of multiple nodes with commas
• join node core text of multiple nodes with periods
• join node core text of multiple nodes with one or more chosen characters
• copy node core text as a new child of the node
• replace parent node core text with the core node text of one of its children
• convert parent node attributes to node children
• convert node children to parent node attributes

Download v0.6.5 (without Java speedups)

Download v0.7.0 (with Java speedups) Using the version of widkNode with Java speedups requires adding 'scripts' to the script classpath in Freeplane's preferences.

---

Roan-Presentation

by Jodi D. Krol

RoAn-Presentation provides a combination of mind mapping with Powerpoint- and Prezi like presentation, using automatic filtering and zooming. Stepping the presentation not only unfolds nodes, but also displays hidden details, centers the current node, executes the named filters which may be connected to each node and more. In short it supports traversing a mind map, taking over abundant clicking from the user. Besides traversing the mindmap depth first, it is possible to define scenes and scenario's for traversing in any order. The included Help file which itself is an example which can be played or stepped as well. The Help file also contains links to example maps and videos which can be downloaded.

Besides functionality for presenting, RoAn may automatically add nodes with links to all folders and files in the directory of the mind map (indexing). As a choice image files may be displayed as inline images. This functionality is more basic than in addon diView(indexfile), but more easy to use.

Installing the add-on results in a new menu Tools> RoAn-Presentation. This menu contains a submenu "Menu" which opens a window with presentation and edit buttons. One of the buttons will open the Help file. Once menu RoAn is used on a mind map, a little button is added to the root to open RoAn's menu with a click next time.

Download roan-presentation 0.1.3 for Freeplane 1.3 only.

Download roan-presentation 0.1.3 for Freeplane 1.2.

ONLY IF YOU USE Freeplane 1.2 (NOT FOR FP 1.3)
After downloading, activate the addon by calling Tools > RoAn-Presentation > Activate addon. This script causes in Tools > Preferences > Plugins:

• classpath: lib
  

(In this way Freeplane knows that the software is in this place. In Freeplane 1.3 this problem does not exist. In lib some of the software (e.g. scriptlib) is used by other addons, which creates a problem that at all times the most recent version must be installed. Why not switch to Freeplane 1.3 ? In some big organisations Freeplane 1.2 is still the standard. If they are over to FP 1.3 the addon will be made to function for Freeplane 1.3 only)

Structure change: The data structure has been changed going from version 0.0 to 0.1. The example files linked to in the Help file must be reloaded for proper functioning.

---

SmartLocker

by Jodi D. Krol

SmartLocker provides a secure repository integrated within a freeplane mind map. Besides it can generate a secure password, automatically login to a website and open multiple sites in one click. Its typical use is illustrated in the video's below. After downloading and installing SmatLocker's menu appears in menu Tools > SmartLocker. This menu contains extensive help, both local and online, and in addition to the local help provided in tooltips. It contains documentation describing all system nodes and preferences which can be set for these nodes through menu Tools > Preferences > SmartLocker. It describes how you can translate SmatLocker's menu and help files, and share them through the freeplane wiki with other users. The Help file also contains a link to a map with predefined nodes for logging in to email providers, facefook etc. And it contains a node Illustration which contains documented nodes explaining the global architecture of SmartLocker (don't forget to to look inside the locker nodes). Finally, if you want to write your own scripts, the documentation contains a number of scripts you can simply import and use.

Video 1. Repository
Video 2. Automatic login

Download preview Smart Locker v0.2
IMPORTANT After downloading, in Tools > Preferences > Plugins set:

• classpath: lib
  
• permit file/ read operation: true

---

dView(indexfile)

by Jodi D. Krol

The add-on dView(indexfile) supports adding annotations, hyperlinks and reminders to file names in a folder structure. For this a specialized dashboard mindmap must be put into the folder to index. When this dashboard is opened and button Index is pressed, a hierarchy of nodes with hyperlinks to the subfolders and files of the indexed folder is generated. Next one can add annotations, add hyperlinks to other files or websites, and add reminders (clock) for file related actions. If email adresses are registered, with one click all users of a particular dashboard can be sent a group-email. In case of image files, a preview can be displayed. The resulting mindmap can be shared with other users, which can navigate it without having to install the add-on. Hyperlinks to indexed files can be copied and pasted into an email. With special options set the add-on can be used with MS Sharepoint or on the internet, and/or be used to generate NATO-compliant file names. Installing add-on dView(indexfile) results in a new menu Tools> dView(indexfile) with different dashboard types to choose from: basic, dossier, meeting, theme, organisation, person and folders, see the descriptions below. Besides it has an extensive Help.
The following functions can be used on any map:

• Copy selected hyperlinks to clipboard (F12), to paste with Ctrl-V in email, Word document, other html-based document
• Copy adresses of links in selected nodes to clipboard (F11), to paste with Ctrl-V
• Copy location of node in map (F10), to paste as link in node of different map (F9)

See Help for details.

For a video and examples see Information management with add-on dView(indexfile).
Download dView(indexfile) 0.3.1
When opening and instaling the add-on:

• jar files scriptlib and indexfile are added to <USERDIR>/lib
• template files are added to <USERDIR>/templates/indexfile
• help files are added to <USERDIR>/doc
• submenu IndexFile is added to menu Tools

See video with instructions for installation.

---

Navigation

by Jodi D. Krol

Scroll leaves to visible

Performs two actions: (1) Folds/unfolds the selected node. And (2) on unfolding moves (grand)children into the screen area. Does not (un)fold (grand)children. The action is performed recursively for al children. As a result the last child may cause the previous child to be moved outside the screen area. This behaviour may be influenced by folding the (other) children. video demonstration

Demote to upper sibling

Moves each selected node to upper sibling and appends as child.

Download navigation 0.3

Installing the addon adds method Scroll leaves to visible and method Demote to upper sibling to menu Tools>scripts.

---

Scroll leaves to visible

Replaced by Navigation, see above  (Entry left for links in Forum)

---

Collaborative tools

by Sébastien Georget

Collaborative tools provides some scripts to ease team working on a single map.

It requires a working versionning system, CVS, SVN and GIT are supported.

Once installed, you can execute the following commands inside freeplane

• diff your mindmap (F10)
• update your mindmap (F11)
• publish your mindmap (F12)

Download the latest version

Feedbacks and contributions are welcome.

GTD Sync with todo.txt

by Henk van den Akker

Groovy script to synchronise a Freeplane|GTD mind map with todo.txt. The catch is that you can make your Next Action list available to other applications and systems. For example, you can use Dropbox to distribute todo.txt and use SimpleTask for Android to consult and maintain todo.txt. What does GTD sync do?

• It imports new next actions from todo.txt to your GTD mind map under node 'New'.
• It updates existing next actions in your GTD mind map with the changes made in todo.txt since last synchronisation. This includes changing the status to completed.
• In case a next action is changed in both todo.txt and the GTD mind map, the attributes changed in todo.txt are logged, so after the synchronisation you are able to check whether any manual update is necessary.
• After the GTD mind map is updated with all new and changed next actions in todo.txt, all its next actions will be exported to todo.txt. The export does not include completed next actions.

For further information consult the wiki or the Quick Start mind map (Alt+F1) provided with the add-on.

Download GTD Sync with todo.txt

For developers

---

http://freeplane.sourceforge.net/addons/devtools/images/devtools.png Add-on Developer Tools

• Build add-on: adds all standard nodes, attributes and notes to the current map. Can be used with an empty Map to create a basic add-on.
• Package add-on for release: It copies the <addon>.mm to <addon>-<version>.mm and updates the script node's context from the files lying around.
• Generate add-on documentation: Creates a snippet for the Freeplane add-ons wiki page.
• Insert binary: Asks for a file to insert as text of the current node (BASE64 encoded).
• Menu item info: Shows technical details about a selected menu item.
• freeplane.dsld: Adds Eclipse editor support for predefined script bindings such as node, c, ui, textUtils, ...

The functions are available under Tools -> Development Tools

For Freeplane 1.2.x: Download v0.9.14

For Freeplane 1.3.x: Download v0.9.20

wikdShell

by L. C. Rees

Groovy console for interacting with a running Freeplane instance

Download 0.2.1 Note: using widkShell requires adding 'scripts' to the script classpath in Freeplane's preferences.

---

scriptlib

Preview Scriptlib help

by Jodi D. Krol

This add-on is aimed at starting developers. It:

• Provides a number of generic ready to use scripts (play audio, set bubble, set cloud etc.);
• Shows how to define local and online Help for add-ons (including translations);
• Shows how to share both binary and groovy code by means of an add-on;
• Shows how add-on scriptlib is defined, including defining menu items, preferences, default properties and translation; scripts and zips; and how the source of the add-on can itself be included in an add-on.

Download scriptlib v0.0.5

IMPORTANT: In Tools >Preferences > Plugins classpath must be set to: lib.
After installing the a menu Tools > Defining scripts is added. It opens two submenu's: Help and Help online. The former contains the help as provided when downloading scriptlib. The latter may contain a newer version of the help file, which is available without having to download a new version of scriptlib.

---