Heap space problems

When you are getting heap space errors in jAlbum it is because jAlbum is running out of memory. It can happen if you for instance have an album with a large number of images or if you have really large original images.

Give jAlbum more memory

On Windows

To give jAlbum more memory on Windows you can go to Tools -> Open Directories -> Program Directory. Now close the jAlbum application, and open the jalbum.ini file in a text editor.

Find the line that begins with...

 Virtual Machine Parameters=-Xms64M -Xmx800M ... 

and change the value -Xmx800M to -Xmx1200M or -Xmx1600M and save the file.

On Mac

To give jAlbum more memory on Mac you can go to Tools -> Open Directories -> Program Directory. Now close the jAlbum application, and open the info.plist file.

JVMOptions.png

Find the line that read JVMOptions and expand it. Then change the value of Item 2 to -Xmx800M to -Xmx1200M or -Xmx1600M and save the file.


On Linux

The default invocation limits heap size to 1200M specified in your Jalbum.desktop file. For allowing larger heap size omit -Xmx1200M from the command. This will allow heap size to grow up to 25% of available physical memory (4G on a machine with 16 G total). You may allow larger heap sizes by specifying huge values, e.g. -Xmx64G.

Limitations

AboutJalbum.png
AboutJalbum2.png

If you are running a 32bit version of jAlbum the value can not be set higher than 2000M. You can check if you are running a 32bit version or a 64bit version if you go to jAlbum-> About jAlbum.


Some general hints on lowering memory usage

  • Lower the # of threads under Preferences (ctrl/cmd+,) -> General.
  • Set the image scaling method under Settings->Images to Medium.
  • Ensure that Use hardware accelerated scaling is checked under Settings->Images->Advanced.