Skip to content

AppImage

cipres edited this page Feb 17, 2021 · 5 revisions

Infos

The AppImage built from the CI is based on Miniconda 4.8.2 (python 3.7.6) and includes go-ipfs v0.7.0. The PyQt5 version used is version 5.13.2.

Dependencies

The AppImage includes most of the required libraries, and if you're running a modern Linux distribution you shouldn't have any issues running it, but always make sure you have those installed:

  • libv4l (needed by libzbar). On Debian-based distros, install with apt-get install v4l-utils

Troubleshooting

If you are not running the AppImage from a terminal and the main window doesn't appear, run it from a shell to get the error message.

When running the AppImage from the command line, if there are issues with Qt and xcb, you might get this message:

qt.qpa.plugin: Could not load the Qt platform plugin “xcb” in “” even though it was found.

This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.

Run the image with QT_DEBUG_PLUGINS

To get debug information on this issue, run the AppImage with the QT_DEBUG_PLUGINS environment variable set (replace x.xx with your AppImage version):

QT_DEBUG_PLUGINS=1 ./Galacteek-0.x.xx-x86_64.AppImage

In the debug output you'll probably see the name of a library not being found. libxcb is bundled in the AppImage but on some systems there can still be incompatibility issues. Please file an issue with the debug output and the type of distribution you're using.

If QT_DEBUG_PLUGINS doesn't help

If you don't get any helpful insights from QT_DEBUG_PLUGINS, try the following to check any missing libraries (replace x.xx with the AppImage version):

APPIMAGE_LIBCHECK=1 ./Galacteek-0.x.xx-x86_64.AppImage

File an issue

You can file an issue here. Be sure to give information about your Linux distribution.