GitLab

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.

The newest AppImages of OpenWalnut are built on Ubuntu 20.04 LTS. So all dependencies are based on what is in the standard repository of that distro (This is especially true for the dependencies that are not inside the AppImage and need to be on the host).

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.