Skip to content

euu2021/Freeplane_UtilityPanels

Repository files navigation

Warning

There are 2 versions: add-on and script . The add-on version is updated less frequently, so it may not be compatible with latest Freeplane version. If the add-on version doesn't start, try the script version.



UtilityPanels is a script that creates integrated panels in the Freeplane interface.

java_ID1CJC5S2N

Main Features

Recent nodes panel

  • A list with recently selected nodes.

java_Mthv2Gb2bT

Pinned nodes panel

Pinned nodes are saved on FreePlane restarts

chrome_aAZD6TPbjq

Tags panel

2025-03-21_14-58

Quick Search panel, with transversal search

Results are highlighted everywhere: in the panels, in the inspectors, and in the map:

image

Breadcrumbs bar

A bar above the map:

java_8h8bXxzVTx

Inspector

  • Inspector tooltip:

java_QqJ9lfYHoY

  • Infinite inception navigation in the Inspector tooltip:

java_Fau6l6yDOX

Other features

Drag and Drop operations

It's possible to do drag and drop (move nodes) between itens in the panel, nodes in the map, and vice versa.

dragff3 borda2

Clicking the panel item navigates to the node.

javaw_UtEw62hVSn

Tags Panel features

Single click adds the node to selected nodes.

Right click gives the option to remove from selected nodes.

Hoverving over the tags on the panel show the nodes with the tag:

2025-03-21_17-46

Combine tags for the search 2025-03-21_17-47

Settings

Right click on a list item:

2025-03-21_17-48 2025-03-21_17-49

Update Selection

It makes the first inspect be about the selected node. The first inspector has this option in the 3 lines menu: 2025-03-21_17-50

Hotkeys

If Freeplane is already using the hotkey for other function (it happens with the Ctrl+F, for example), it's necessary, first, to clear the Freeplane hotkey assignment.

Currently:

  • Ctrl + F: focus the QuickSearch panel search box
  • Ctrl + U: toggles hide and show panels

Can be changed in settings window.

Transversal Search in QuickSearch panel

(inspired by the Jumper Add-On) Transversal search is a technique that finds relevant nodes not only based on the text they contain, but also by looking at the content of their parent nodes. For example, if you search for the terms "a", "b", and "c", a node with the text "a" might be considered a match if one of its ancestors contains "b" and another contains "c". This means that even if the node itself doesn't include all the search terms, the surrounding context provided by its ancestry is taken into account, yielding more meaningful and flexible search results.

image

When performing a search with multiple terms (for example, "a", "b", and "c"), the algorithm processes each node in the mind map as follows:

  1. Initial Check:     The algorithm first checks if the node's text contains at least one of the search terms. If the node does not contain any of the terms, it is immediately disregarded.

  2. Secondary Verification:     If the node contains at least one search term directly, the algorithm then verifies that every search term that is missing in the node’s text is found in one of its ancestor nodes. In other words, for each term not directly present in the node, the algorithm looks up the node’s parent chain to see if the term appears there.

  3. Match Condition:     The node is considered a match (i.e., a positive result) only if every search term is present either directly in the node or in one of its ancestors.

This approach allows the search function to combine context from a node and its hierarchical position. As a result, a node might be considered relevant if it has partial information, while the remaining search terms are provided by its ancestral context.

Hide panels

Toggle hide/show panels with Ctrl + U hotkey.

Freeze Inspectors

The inspectors have a freeze option, so the user can easily do drag and drop operations, or navigate the map while the inspectors stay on screen.

2025-03-21_14-55

Other interesting aspects:

  • The panel follows the active tab

chrome_6rDGvc0k22

  • deleting a node in the map, immediately deletes the item in the list:

chrome_Fs2nVtzqKp

  • the nodes get marked with a ⚠️ sign in the panels when clicking on them will lead to a Jump Out in the current map view:

javaw_t0YcE237zu

  • the nodes get marked with a ○ sign in the panels when it has children:

image

  • the selected node get marked with a red border in the panels:

image

  • The panels are transparent:

javaw_2jN2VSzuVX

  • Panels autoexpand on mouse hover:

java_yDJOmoi0pM

  • Panels autosizing according to the size of the Freeplane window:

SKdsOzKgIy

Proportions can be changed in settings window.

  • Text autosizing in inspector (notice that the size is smaller when the text is longer, in order to try to fit the maximum ammount of text)

java_ggp6aUZLfC

Minimum and maximum sizes be changed in settings window.

  • Right to left (RTL) text orientation

Can be activated in settings window.

  • Auto position (to avoid overlap with the selected node):

java_KQbwI5AUzb

  • Inside right click contextual menu: Option to open new view with node selected

image

Disclaimer

Some of the features modify the information in the map, so do extensive testing before using the script on important maps. And create backups.

About

Utility Panels that are integrated in the Freeplane interface.

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •  

Languages