github GoldenCheetah/GoldenCheetah snapshot
Snapshot Builds

pre-releaseone month ago

Python - SIP - Numpy - Plotly Upgrade and some new features

This build is v3.8-DEV2601 with upgraded embedded Python (v3.11) and SIP (v6.15.1) and updated included modules (numpy, pandas, plotly, etc.).

  1. If you enable Python and set the Python Home empty in GC config, the change should be mostly transparent and most of existing Python charts and DPs should work without changes using Python and modules included in the binary distribution.
  2. To use an external Python, you need to install Python 3.11 on your system and the required modules. To install the required modules you can run pip install -r requirements.txt using the attached file, and to get the folder to use as Python Home in GC you can run in the Python interpreter: import sys; sys.exec_prefix.

NB: option 1. was created to avoid users the complexities of option 2. Please use that unless you have the working knowledge of Python necessary for option 2.

New features and fixes

  1. Copy & Paste for planned activities on calendar
  2. Planned activities: Keeping track of original date
  3. Fit file import - don't crash on malformed files
  4. Updated German translation

Notes

On Windows it is possible to run python -m pip install <module-name> on GoldenCheetah folder to install additional modules as an alternative to have a separate Python install. You need an administrator command prompt if you installed GoldenCheetah in Program Files.

Example listing installed modules and installing the requests module:
Screenshot 2026-02-05 131325

On Linux it is possible too, but you need to extract the AppImage to the local filesystem, this may take a while but it is a one time job and then you can run GoldenCheetah from that folder as shown in the last line:

$ ./GoldenCheetah_v3.8_x64.AppImage --appimage-extract
$ squashfs-root/opt/python3.11/bin/python3.11 -m pip list
$ squashfs-root/opt/python3.11/bin/python3.11 -m pip install requests
$ squashfs-root/GoldenCheetah --debug

If you get SSL errors you may need to run $ export SSL_CERT_DIR=/etc/ssl/certs

On macOS this is not possible yet due to lack of SSL support, collaboration is welcome.

Feedback and questions are welcome at the users forum, you will find a thread about this release there.

IMPORTANT

Windows installation notes:
a) Download and run the .exe file, do not install to the same folder as an existing install
b) Install the vc++ redistributable
c) Reboot before running
All 3 steps are required.

MacOS installation notes:
a) Download and open the dmg file
b) Drag and drop where you would like to install
c) Authorize GoldenCheetah to run
Don't run directly from the DMG.

Linux installation notes:
a) Download the AppImage where you like to install
b) Make it executable: $ chmod a+x GoldenCheetah_v3.8_x64.AppImage
c) Run: $ ./GoldenCheetah_v3.8_x64.AppImage
Don't use the version from your distro applications store, it is likely outdated and incomplete.

Note: If you experience problems please see Troubleshooting on the wiki and ask questions at the users forum if you need help, please don't open GitHub issues until a bug is confirmed.

Don't miss a new GoldenCheetah release

NewReleases is sending notifications on new releases.