Freeplane does not start

  • Check that the java runtime environment is installed. Sun JRE 1.6 or later is recommended.
  • Run freeplane.bat (under linux run freeplane.sh) from a shell and look at the output printed there. If you can not understand the reasons for failure yourself, open a bug request and post there the output.

Freeplane throws out-of-memory exception

You can increase memory available to Freeplane by setting Java VM option -Xmx to higher values

Examples: -Xmx1024M (1024 MB) -Xmx2G (2 GB) -Xmx8G (8 GB)

Depending on your OS the configuration can be changed at different places.

Windows

Add line

-Xmx4G

to files freeplane.l4j.ini and freeplaneConsole.l4j.ini which are used when you start freeplane.exe or freeplaneConsole.exe.

If you use freeplane.bat you need to configure this option there.

Mac OS

Go to Application==> Left click on specific application (like Weka)==> Show Package Content==> Contents==>app

Edit file Freeplane.cfg ane replace any of lines

java-options=-XX:MaxRAM=...
java-options=-XX:MaxRAMPercentage=...
java-options=-Xmx...

by line

java-options=-Xmx4G

Save the changes.

Linux

Edit freeplane.sh and replace -Xmx... by whatever value you need.

Graphics Issues with the UI

Try disabling the DirectDraw pipeline by adding the following flag to your Freeplane options (freeplane.l4j.ini and freeplaneConsole.l4j.ini on Windows, freeplane.sh on Linux):

-Dsun.java2d.noddraw=true

For explanations and other configuration options you can try, see this documentation.

Performance issues when scrolling/selecting nodes

Try to use OpenGL rendering instead of Direct3D by adding the following flag into your Freeplane options (freeplane.l4j.ini and freeplaneConsole.l4j.ini on Windows, freeplane.sh on Linux)

-Dsun.java2d.d3d=false

Html text and images can not be pasted from Web pages in nodes and notes on Linux

It is a java issue on linux. Use Firefox for Windows with Wine.

Nodes are not displayed properly on linux if the map is zoomed

Install the latest sun java from http://www.java.com/de/download/. The open jdk behaves buggy and is also significantly slower.

I cannot find the spell check function

The spell checker has to be enabled, see the Spell checker how-to.

The editor freezes

Create an entry in Bugs and provide as much information as possible about the conditions under which the behavior occurs:

  • Does it happen always if you do ...?
  • Is there a dependency on the size of the loaded map(s)?
  • Post the output of "java -version" (it contains the build number)
  • Do you have something special in your environment?
  • Is Freeplane consuming computation power when it freezes or not?
  • Before the freeze, was there any activity in the logfile? At least if there is anything suspicious, please post the logfile.
  • Can you stop it with normal means (close window, send SIGTERM, ...)?
  • Try a downgrade to an older Freeplane version - does that help?

It would be of great help in any case if you would provide a listing ("stacktrace") of what Freeplane is currently doing when it freezes by using the jstack tool. Find out the process id (PID) of the Freeplane Java process instance via Taskmanager, top, ps or whatever tool. Let's assume that the PID is 2345. Please post the output of

jstack -l 2345

(You have to replace "2345" with the real PID.) For comparison also post the jstack output of Freeplane before the freeze (if possible). As you can easily check by inspecting the output it's pure technical stuff, nothing of your private mindmap is contained in it. Unfortunately you have to have the JDK installed to use jstack (the JRE wouldn't suffice). Please tell us, if you cannot install the JDK for some reason. - We might be able to help.

For more on jstack see its Sun documentation.