How to download, install and run OpenWalnut AppImage

This is an old version of this page. You can view the most recent version or browse the history.

This page describes the process for Linux operating systems.

Download

Downloading OpenWalnut as an AppImage is fairly easy. There is a folder which contains all the current versions, named by their built-date and their commit ID, available under: https://seafile.rlp.net/d/13aaa2e50ad64065984e/
You just have to download the newest version or a specific version of your interest.

Install

AppImages are an executable archive that contains most, if not all, needed dependencies for the program.
So the only thing that you need to do before running OpenWalnut is making it executable:

$ chmod u+x OpenWalnut-<version>.AppImage

Run

As the AppImage is an executable in itself, you just need to run the file.
This can be achieved by doing:

$ ./OpenWalnut-<version>.AppImage

If you are not in the same folder of the AppImage then you have to write the relative or the absolute path to the file.

Known Problems

Missing dependency `libOpenGL.so` or similar

One of the dependencies that is not included inside the AppImage is OpenGL as this dependency can vary from hardware to hardware. To fix this problem you have to either install OpenGL or Mesa.

`GLIBC` or `GLIBCXX` version is too high

/tmp/.mount_OpenWad8nuYY/usr/bin/openwalnut-qt: /lib/x86_64-linux-gnu/libm.so.6: version `GLIBC_2.29' not found (required by /tmp/.mount_OpenWad8nuYY/usr/bin/openwalnut-qt)
/tmp/.mount_OpenWad8nuYY/usr/bin/openwalnut-qt: /usr/lib/x86_64-linux-gnu/libstdc++.so.6: version `GLIBCXX_3.4.26' not found (required by /tmp/.mount_OpenWad8nuYY/usr/bin/openwalnut-qt)
/tmp/.mount_OpenWad8nuYY/usr/bin/openwalnut-qt: /lib/x86_64-linux-gnu/libm.so.6: version `GLIBC_2.29' not found (required by /tmp/.mount_OpenWad8nuYY/usr/lib/libopenwalnut.so.1)
/tmp/.mount_OpenWad8nuYY/usr/bin/openwalnut-qt: /usr/lib/x86_64-linux-gnu/libstdc++.so.6: version `GLIBCXX_3.4.26' not found (required by /tmp/.mount_OpenWad8nuYY/usr/lib/libopenwalnut.so.1)
/tmp/.mount_OpenWad8nuYY/usr/bin/openwalnut-qt: /usr/lib/x86_64-linux-gnu/libstdc++.so.6: version `GLIBCXX_3.4.26' not found (required by /tmp/.mount_OpenWad8nuYY/usr/lib/libboost_thread.so.1.71.0)

This is a sample how this error could look like.
To fix this you either have to use an OpenWalnut version that was compiled with a lower GLIBC version, if such a version exists, or upgrade your GLIBC and GLIBCXX version.