AppImage starting issues on some Linux distributions - GoldenCheetah/GoldenCheetah GitHub Wiki

AppImage binary format is intended to be distribution neutral and to work on a wide range of versions, for that purpose GoldenCheetah AppImages are generated on the oldest still supported Ubuntu version at the time of development and release (16.04 for v3.5, 18.04 for v3.6 and 20.04 for v3.7).

You need libfuse2 in your system to use AppImages, otherwise you can self-extract to the current directory, and run from there:

$ ./GoldenCheetah_v3.6_x64.AppImage --appimage-extract
$ squashfs-root/AppRun

Additionally you can experiment library issues on the newest versions, especially in rolling-release distributions like Arch and its derivatives. These are currently known issues and their fixes:

Error 1

$ ./GoldenCheetah_v3.6_x64.AppImage qt.qpa.plugin: Could not find the Qt platform plugin "wayland" in "" This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem. Available platform plugins are: xcb.

Fix

$ export QT_QPA_PLATFORM="wayland;xcb"
$ ./GoldenCheetah_v3.6_x64.AppImage

Error 2

$ ./GoldenCheetah_v3.7-DEV_x64.AppImage /tmp/.mount_GoldenTqPLAR/GoldenCheetah: symbol lookup error: /usr/lib/libtiff.so.6: undefined symbol: jpeg12_write_raw_data, version LIBJPEG_8.0

Fix

$ export LD_PRELOAD=/usr/lib/libjpeg.so.8
$ ./GoldenCheetah_v3.7-DEV_x64.AppImage

Other issues usually can be diagnosed and fixed by experienced Linux users extracting the AppImage to a local file systemas explained above. Search the users forum and ask there if you need help but, please, don’t open GitHub issues for this.

Create a menu entry with the fix.

Create a Desktop Entry Specification compliant file named GoldenCheetah.desktop. For more information on Desktop Entry Specification, please refer to Desktop Entry Specification

Enter the following into the file and adjust the file path and file name to your needs:

In the example, Path=/opt/ and Exec=/opt/GoldenCheetah_v3.7-DEV_x64.AppImage.

[Desktop Entry]
Comment[de_DE]=Software für die Leistungsanalyse im Radsport.
Comment=Cycling Power Analysis Software.
Exec=LD_PRELOAD=/usr/lib/libjpeg.so.8 /opt/GoldenCheetah_v3.7-DEV_x64.AppImage
GenericName[de_DE]=
GenericName=
Icon=/home/User/.goldencheetah/gc.png
Keywords=Cycling;Training;Bike;Ride
MimeType=
Name[de_DE]=GoldenCheetah
Name=GoldenCheetah
NoDisplay=false
Path=/opt/
StartupNotify=true
Terminal=true
TerminalOptions=
Type=Application
Version=3.3.0
X-DBUS-ServiceName=
X-DBUS-StartupType=
X-KDE-SubstituteUID=false
X-KDE-Username=

If your desktop environment follows the Desktop Entry Specification, save the file in /home/User/.local/share/applications. This is what KDE and Gnome should do. You can now access the `GoldenCheetah entry in the Menu and launch the application from there.