Releases · GoldenCheetah/GoldenCheetah

Second development build for v3.8 with planned activities

Changes from version 3.7-sp1

UX and Workflows

Enabled Plan View with Calendar, Agenda, Plan Adherence and Expected PMC charts. It can be selected as startup view if you like to.
Calendar now includes visual refinements, Planned Activities creation and management, and Phases/Events modification.
Planned Activities can include a linked Workout so you can navigate to execute it in Train View, and are used in "Expected PMCs" to forecast training load evolution.
On activity import if a corresponding Planned activity is detected, it is marked automatically as complete.
New Agenda chart to view and manage pending Planned activities
Repeat Schedule Wizard to selectively copy parts of a plan to future dates.
Update Calendar on Batch Import
Copy & Paste for planned activities on calendar
Planned activities: Keeping track of original date
New Plan Adherence chart
Calendar: New option to hide planned activities from summary
User Chart: New action to duplicate a series
Plan activity: Allow to enter Workout Code
Save Routes with better resolution and new Segments chart
Updated Athlete Management:
- New AthleteCard placement, now takes the first available space, supports the dragging of tiles and prevents overlapping issues
- The currently selected athlete's card is now highlighted
- Athlete switching via avatar click
- New buttons, delete, backup,etc
- New actual activity, planned activity & unsaved activity figures
- The first opened athlete can now be closed
- The current athlete can be closed using the tab button

Cloud

Deprecate VeloHero integration since the service will be shutdown this year

Device Support

Upgrade FIT SDK to 21.18
Add reconnect attempt timer after BT40Device unexpected disconnect (#4812)

Platform Support

Deprecate Qt5 support, all builds are Qt6 based now
Downgrade to gcc-11 for Linux builds to avoid issues on still supported distributions s.t. Debian 12/Ubuntu 22.04 LTS and derivatives
Upgraded embedded Python (v3.11) and SIP (v6.15.1) and updated included modules (numpy, pandas, plotly, etc.) plus pip to install other modules and Jinja2 for Segments chart.
Release 3.8 macOS binaries are generated on macOS 14.7 and intended to be used in that version and newer ones.

Bug Fixes

Athlete folder was not saved after change confirmation
Fix invisible label on Interval Metadata selector
Workout Infowidget: Showing real zone name instead of fixed Zn
Icon Manager - Use normalized values for Sport
Fit file import - don't crash on malformed files
Fix several crashes related to seasons and phases
Fix several crashes related to Estimator and Charts
Fix Edit menu disappearing when changing languages on macOS (#4797)

** Other updates**

Choose cyclist default to no avatar (#4814)
Using "actual activity" instead of "completed activity" (#4813)
Add Zoomed Elevation Widget to Graphical Meters For simulation workouts without GPS data
Fix typo in Nonzero Average Power description
Selectable show/hide planned activities (#4811)
Updated Time Range context menu (#4808)
Dialog to build filter queries for similar activities (#4805)
Train mode: Improved readability for ErgFilePlot (#4806)
Update Spanish translation (#4807 and #4801)
Updated German translation
Updating power values of planned activities with linked workouts (#4799)
Added isPlanned to filters

Feedback and ideas 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.

Notes about Python

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:

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 python3.11 binary and pip3 script are available under GoldenCheetah.app/Contents/Frameworks/Python.framework/Version/Current/bin, the base directory and package name depend on your installation choices.

First development build for v3.8 with planned activities

Changes from version 3.7-sp1

UX and Workflows

Enabled Plan View, initially with Calendar, Agenda and Expected PMC charts. It can be selected as startup view if you like to.
Calendar now includes visual refinements, Planned Activities creation and management, and Phases/Events modification.
Planned Activities can include a linked Workout so you can navigate to execute it in Train View, and are used in "Expected PMCs" to forecast training load evolution.
On activity import if a corresponding Planned activity is detected, it is marked automatically as complete.
New Agenda chart to view and manage pending Planned activities
Repeat Schedule Wizard to selectively copy parts of a plan to future dates.
Update Calendar on Batch Import

Cloud

Deprecate VeloHero integration since the service will be shutdown this year

Device Support

Upgrade FIT SDK to 21.188

Platform Support

Deprecate Qt5 support, all builds are Qt6 based now
Downgrade to gcc-11 for Linux builds to avoid issues on still supported distributions s.t. Debian 12/Ubuntu 22.04 LTS and derivatives

Bug Fixes

Athlete folder was not saved after change confirmation
Fix invisible label on Interval Metadata selector
Workout Infowidget: Showing real zone name instead of fixed Zn
Icon Manager - Use normalized values for Sport

Update

Binaries were updated on Jan 24, 2026 to include the following changes:

Update translation files
Choose cyclist default to no avatar (#4814)
Using "actual activity" instead of "completed activity" (#4813)
Add Zoomed Elevation Widget to Graphical Meters For simulation workouts without GPS data
Add reconnect attempt timer after BT40Device unexpected disconnect (#4812)
Fix typo in Nonzero Average Power description
Selectable show/hide planned activities (#4811)
Updated Time Range context menu (#4808)
Revert to Qt 6.5.3 for macOS builds
Dialog to build filter queries for similar activities (#4805)
Train mode: Improved readability for ErgFilePlot (#4806)
Update Spanish translation (#4807 and #4801)
Updating power values of planned activities with linked workouts (#4799)
Fix Edit menu disappearing when changing languages on macOS (#4797)

Feedback and ideas 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.

This is a patch release update for v3.7 to include high priority fixes for stability and security and to make new calendar functionality available to a wider audience

Stability and Security

Corrections to fix a potential vulnerability when accessing Web Services with SSL connectivity. For example; CloudDB, Strava, DropBox, Withings.
Qt6 is used on all 3 supported platforms to provide an updated internal Web Browser for more secure Web Services authentication and authorization and Web site access via the Web Chart.

We advise all users to update to this release as soon as possible

New Planning and Calendar View Functionality

A new Calendar chart is now available as a Trends chart with month/week/day views and configurable as other charts
Icons are configurable based on Sport/SubSport but they are not included in binaries due to license incompatibility (you can download an optional package with icons as illustrated above in Options > Data Fields > Icons > Download Default and you can use others icons of your preference there too)
Reworked the dialog for manually creating activities

Minor enhancements

Metrics override in Overview charts similar to former Metadata edit
Improve support for CORE sensor in Train view
Configurable startup view you can select to start in Trends, Train or the Activities

For the full detail of bug fixes, see the change log, Planned Activities and Agenda were not included in this release since that is work in progress for v3.8

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

ASSET SHAs

Windows x64/Qt6 - GoldenCheetah_v3.7-sp1_x64Qt6.exe SHA-256 - e00d3bcea114c54b64f270b9ab467d1513207d296de85cae2bb1ac2ae25a355f

macOS x64/Qt6 - GoldenCheetah_v3.7-sp1_x64Qt6.dmg SHA-256 - 1c16d136ca5926db70ac7bdea66402a8ae2b880cb8eddbd3757d1519612d77e0

Linux x64/Qt6 (recommended) - GoldenCheetah_v3.7-sp1_x64Qt6.AppImage SHA-256 - 274b31dedd4903811cb16ce052417ec2486247b7490d9d30c8ffb0aec35d0322

Linux x64/Qt5 (for older OS) - GoldenCheetah_v3.7-sp1_x64Qt6.AppImage SHA-256 - 0e24d4977a2b166f8e58ffdeacf9ec5821050b9d951812a5ac2b9c88cf346613

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.7-sp1_x64Qt6.AppImage
c) Run: $ ./GoldenCheetah_v3.7-sp1_x64Qt6.AppImage
Don't use the version from your distro applications store, it is likely outdated and incomplete. If you see 'GLIBCXX_3.4.32 not found at startup you have to update the libstdc++6 library in your system, or to use the Qt5 AppImage which doesn't have this requirement.

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.

Version 3.7

A maintenance release focused on base code migration to Qt 6 preserving Qt 5 compatibility, including some long awaited features s.t. filtering and classification of workouts, selective BTLE sensor pairing, drag-n-drop of activity images, and semi-automatic CP detection for power zones, settings and config harmonization and a lot of small improvements and bug fixes for a better user experience.

Summary of changes from v3.6 release

GUI

New graphical splash screen with version and load progress indications.
Ctrl+q for Quit on Linux, command+Q on macOS and Alt+F4 on Windows.
Drag and Drop Images onto a ride, Images gallery Python chart available for download from CloudDB.
Main Window gets drag/drop from Overview
Context help for Create/Edit User Metrics
Batch Processing now includes metadata update
Improved search/filter box drop down menu icon and color theme fixes
Updated Zones config dialogs with in-place edition
Updated Athlete config and new athlete dialogs
Updated global config dialogs
Improved Data Processors config with automatic-only setting
Edit menu renamed as Process honors automatic-only setting

CHARTS

Overview Chart - Enhanced drag and drop item placement with preview
Overview Chart - Edit content button for metadata tiles
Compare mode for Map chart
Configurable grayscale filter for Map chart
Ignore zeros option for curves in Metrics Trends charts (this makes the charts saved by this version incompatible with previous ones)
Zoom & Pan for the Performance chart using +mouse wheel and mouse wheel click and drag
PfPv Plot (QA) and Scatter Plot (2d) - allow vertical scales up to 2500N
Fixed Weekly tiles in default Trends layouts
Map chart - Added interactivity to the Smallplot
Better user experience when drawing segments on the map
Python Chart Editor Cosmetics
Enabled old Calendar and Navigator charts for Trends,
Table tile in Overview chart - colorize scalar values.
Enable Performance Tests for CV charts

FILE FORMATS

Support for the new FIT structure used by latest Garmin units, fixes the no-laps problem, but still doesn’t work with multisport files.
Read and write XData developer fields to FIT files, previously imported developer data is now preserved on FIT export.
Generic Support for Session and Lap in FIT files
Decode cyclist position from FIT files
GPX parser - support ns3 TrackPointExtension name and uses speed data when available
Consolidate consecutive rest lengths in a single interval for lap swim fit files
Fix lap swim allows to filter min rest lengths
Update FITmetadata.json to FIT SDK v21.158

METRICS

Semi automatic creation of ranges for power zones
Enable Pace metric for Walking (this will trigger a full metric re-computation o the first start)
Rename fatigue zones for consistency
DataFilter - isAero
Interval Metadata
Datafilter xdataseries(), xdataunits() and xdatavalues()
User defined relative date ranges in Trends
Swim Stroke (0 - rest, 1 - free, 2 - back, 3 - breast, 4 - fly, 5 - drill, 6 - mixed)

TRAIN

New icons for the bottom bar honor light and dark themes
Improved the selection of workouts using filters in the toolbar with named workout filters
Added Bluetooth pairing to the device wizard and BTLE support on macOS versions from 12.x
Workout Editor supports MRC flavored qwkcode (Watts as percentages of CP)
Download Strava Routes as Workouts
Download workouts from TrainerDay (previously ErgDB) using the query API with duration and dominantzone operators.
New zoomed elevation widget for slope/distance workouts with video
New zoomed elevation chart for slope/distance workout without video
Option for coalescing neighboring sections with the same watts in ERG mode workouts
Workout Plot - realtime curves honor FFWD/RWND and lap F/B
Coloring by powerzones in ErgFilePlot
Added support for old Daum devices before 2001
Workout editor: preferences are persistent between sessions and line width honors appearance settings
Cycling dynamics in train mode
Add tempe ANT+ sensor support
Add of CoreTemp sensor support
Add Zoom property to Live map chart
Enable VideoSync and Overlay Widgets for QT6 Video Window

CLOUD

CloudDB - Fallback to local cache when server is not available
Adapt CloudServiceSyncDialog with service capabilities
Athlete level WebEngineProfile for cookies and storage, disabled for OAuth workflow.

Python API

GC.deleteXDataSeries(xdata, series) to remove existing XData series
GC.deleteXData(xdata) to remove existing XData

TRANSLATIONS

Updated German translation
Updated Spanish translation
Updated French translation
Updated Italian translation

BUG FIXES

Fix crash on invalid perspective filter
Fixed rounding error on loading and saving erg files
Enable Multiple custom power curves for virtual power
Fix memory leak in Split Activity Wizard
Bluetooth FTMS fix to get device speed
Cursor in text workout editor was invisible
Fix crash on metadata config
Fix some non-translatable strings and update ts files
Fix lap data auto-reset in slope workouts
Fix broken workout directory check for the first start
Fix shortcuts not available due to translations
Fix issues after perspective switch
Ignore dot folders on athlete open/backup/delete
Fix imperial units labels in AeroLab
Fix Ride Cache remove 1 sec intervals
Fix intervals in Compare Pane are 1 sample short
Avoid crash when users try to create a virtual power curve with a single point

DEPRECATED FEATURES

Deprecate Today's Plan integration
Deprecate export to KML files

TECHNICAL CHANGES

Upgraded Qwt to 6.4 (branch: qwt-multiaxes)
Upgrade Travis-ci builds to macOS 12.6 with Qt5.15
Upgrade Travis-ci Linux version to Ubuntu 22.04, AppImage now works with fuse3
Qt6 and Qt6 video support up to latest Qt 6.8.3, updated WebEngine embedded browser fixes login issues on external websites s.t. Garmin Connect and Strava. Available when building from source.

ASSET SHAs

Windows x64 - GoldenCheetah_v3.7_x64.exe SHA-256 - 3a652b5f1919719795b3711a84c8cb212628e34ad9bf49588265b00f3e7848b1

macOS x64 - GoldenCheetah_v3.7_x64.dmg SHA-256 - 000f49df0cb3da1b8b48656f8c0fecb7591be9a0d3eae400d54b76d52d465363

Linux x64 - GoldenCheetah_v3.7_x64.AppImage SHA-256 - b5e58c0c28660b6a161b7509593b47557cc8ce2da485d9333243031534c8eb0f

IMPORTANT:

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

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.7-DEV_x64.AppImage
c) Run: $ ./GoldenCheetah_v3.7-DEV_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.

Fourth development build for 3.7 in December 2024

Summary of changes from v3.6 release

GUI

New graphical splash screen with version and load progress indications, as illustrated above.
Ctrl+q for Quit on Linux, command+Q on macOS and Alt+F4 on Windows.
Drag and Drop Images onto a ride, Images gallery Python chart available for download from CloudDB.
Main Window gets drag/drop from Overview
Context help for Create/Edit User Metrics
Batch Processing now includes metadata update
Improved search/filter box drop down menu icon and color theme fixes
Updated Zones config dialogs with in-place edition
Updated Athlete config and new athlete dialogs NEW in this build
Updated global config dialogs NEW in this build
Improved Data Processors config with automatic-only setting NEW in this build
Edit menu renamed as Process honors automatic-only setting NEW in this build

CHARTS

Overview Chart - Enhanced drag and drop item placement with preview NEW in this build
Overview Chart - Edit content button for metadata tiles
Compare mode for Map chart
Configurable grayscale filter for Map chart
Ignore zeros option for curves in Metrics Trends charts (this makes the charts saved by this version incompatible with previous ones)
Zoom & Pan for the Performance chart using +mouse wheel and mouse wheel click and drag
PfPvPlot (QA) - allow vertical scales up to 2500N
Fixed Weekly tiles in default Trends layouts
Map chart - Added interactivity to the Smallplot
Better user experience when drawing segments on the map
Python Chart Editor Cosmetics
Enabled old Calendar and Navigator charts for Trends (temporary until we have a new calendar)
Table tile in Overview chart - colorize scalar values.
Enable Performance Tests for CV charts NEW in this build

FILE FORMATS

Support for the new FIT structure used by latest Garmin units, fixes the no-laps problem, but still doesn’t work with multisport files.
Update FITmetadata.json to FIT SDK 21.133
Generic Support for Session and Lap in FIT files
Decode cyclist position from FIT files
GPX parser - support ns3 TrackPointExtension name
Consolidate consecutive rest lengths in a single interval for lap swim fit files
Fix lap swim allows to filter min rest lengths

METRICS

Semi automatic creation of ranges for power zones NEW in this build
Enable Pace metric for Walking (this will trigger a full metric re-computation o the first start)
Rename fatigue zones for consistency
DataFilter - isAero
Interval Metadata
Datafilter xdataseries(), xdataunits() and xdatavalues()
User defined relative date ranges in Trends NEW in this build
Swim Stroke (0 - rest, 1 - free, 2 - back, 3 - breast, 4 - fly, 5 - drill, 6 - mixed) NEW in this build

TRAIN

New icons for the bottom bar honor light and dark themes
Improved the selection of workouts using filters (#4400)
Added Bluetooth pairing to the device wizard and BTLE support on macOS versions 12/13/14
Workout Editor supports MRC flavored qwkcode (Watts as percentages of CP)
Download Strava Routes as Workouts
Download workouts from TrainerDay (previously ErgDB) using the query API with duration and dominantzone operators.
New zoomed elevation widget for slope/distance workouts with video
Option for coalescing neighboring sections with the same watts in ERG mode workouts
Workout Plot - realtime curves honor FFWD/RWND and lap F/B
Coloring by powerzones in ErgFilePlot
Added support for old Daum devices before 2001 (#4303)
Workout editor: preferences are persistent between sessions and line width honors appearance settings
Cycling dynamics in train mode

CLOUD

Adapt CloudServiceSyncDialog with service capabilities

Python API

GC.deleteXDataSeries(xdata, series) to remove existing XData series NEW in this build
GC.deleteXData(xdata) to remove existing XData NEW in this build

TRANSLATIONS

Updated German translation
Updated Spanish translation
Updated French translation

BUG FIXES

Fix crash on invalid perspective filter
Fixed rounding error on loading and saving erg files
Enable Multiple custom power curves for virtual power
Fix memory leak in Split Activity Wizard
Bluetooth FTMS fix to get device speed
Cursor in text workout editor was invisible
Fix crash on metadata config
Fix some non-translatable strings and update ts files
Fix lap data auto-reset in slope workouts
Fix broken workout directory check for the first start
Fix shortcuts not available due to translations
Fix issues after perspective switch
Ignore dot folders on athlete open/backup/delete
Fix imperial units labels in AeroLab
Fix Ride Cache remove 1 sec intervals
Fix intervals in Compare Pane are 1 sample short
Avoid crash when users try to create a virtual power curve with a single point

DEPRECATED FEATURES

Deprecate Today's Plan integration
Deprecate export to KML files

TECHNICAL CHANGES

Upgraded Qwt to 6.3 (branch: qwt-multiaxes)
Upgrade Travis-ci builds to macOS 12.6 with Qt5.15
Upgrade Travis-ci Linux version to Ubuntu 20.04

ASSET SHAs

Windows 64Bit SHA-256 - fe8e049bf9eb7e4e1dc115a761fb765e5a29f62108501b46a27cf8c0bb428257

macOS 64Bit SHA-256 - 7811039867aa078c348d6be80deb74e3b21c19092654435e766364ade16b2810

Linux 64Bit SHA-256 - 841cee1dbd3a815ff12fd77e857d56c45a1bba614a79cab32f290add741d0eee

IMPORTANT:

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

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.7-DEV_x64.AppImage
c) Run: $ ./GoldenCheetah_v3.7-DEV_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.

Third development build for 3.7 in October 2024

Summary of changes from v3.6 release

GUI

New graphical splashscreen with version and load progress indications, as illustrated above.
Ctrl+q for Quit on Linux, command+Q on macOS and Alt+F4 on Windows.
Drag and Drop Images onto a ride, Images gallery Python chart available for download from CloudDB.
Main Window gets drag/drop from Overview
Context help for Create/Edit User Metrics
Batch Processing now includes metadata update
Improved search/filter box drop down menu icon and color theme fixes
Updated Zones config dialogs with in-place edition NEW in this build

CHARTS

Overview Chart - Enhanced drag and drop item placement with preview NEW in this build
Overview Chart - Edit content button for metadata tiles NEW in this build
Compare mode for Map chart
Configurable grayscale filter for Map chart
Ignore zeros option for curves in Metrics Trends charts (this makes the charts saved by this version incompatible with previous ones)
Zoom & Pan for the Performance chart using +mouse wheel and mouse wheel click and drag
PfPvPlot (QA) - allow vertical scales up to 2500N
Fixed Weekly tiles in default Trends layouts
Map chart - Added interactivity to the Smallplot
Better user experience when drawing segments on the map
Python Chart Editor Cosmetics
Enabled old Calendar and Navigator charts for Trends (temporary until we have a new calendar)
Table tile in Overview chart - colorize scalar values.
Enable Performance Tests for CV charts NEW in this build

FILE FORMATS

Support for the new FIT structure used by latest Garmin units, fixes the no-laps problem, but still doesn’t work with multisport files.
Update FITmetadata.json to FIT SDK 21.133
Generic Support for Session and Lap in FIT files
Decode cyclist position from FIT files
GPX parser - support ns3 TrackPointExtension name

METRICS

Semi automatic creation of ranges for power zones NEW in this build
Enable Pace metric for Walking (this will trigger a full metric re-computation o the first start)
Rename fatigue zones for consistency
DataFilter - isAero
Interval Metadata
Datafilter xdataseries(), xdataunits() and xdatavalues()
User defined relative date ranges in Trends NEW in this build

TRAIN

New icons for the bottom bar honor light and dark themes
Improved the selection of workouts using filters (#4400)
Added Bluetooth pairing to the device wizard and BTLE support on macOS versions 12/13/14
Workout Editor supports MRC flavored qwkcode (Watts as percentages of CP)
Download Strava Routes as Workouts
Download workouts from TrainerDay (previously ErgDB) using the query API with duration and dominantzone operators.
New zoomed elevation widget for slope/distance workouts with video
Option for coalescing neighboring sections with the same watts in ERG mode workouts
Workout Plot - realtime curves honor FFWD/RWND and lap F/B
Coloring by powerzones in ErgFilePlot
Added support for old Daum devices before 2001 (#4303)
Workout editor: preferences are persistent between sessions and line width honors appearance settings NEW in this build
Cycling dynamics in train mode NEW in this build

CLOUD

Adapt CloudServiceSyncDialog with service capabilities

TRANSLATIONS

Updated German translation
Updated Spanish translation
Updated French translation

BUG FIXES

Fix crash on invalid perspective filter
Fixed rounding error on loading and saving erg files
Enable Multiple custom power curves for virtual power
Fix memory leak in Split Activity Wizard
Bluetooth FTMS fix to get device speed
Cursor in text workout editor was invisible
Fix crash on metadata config
Fix some non-translatable strings and update ts files
Fix lap data auto-reset in slope workouts
Fix broken workout directory check for the first start
Fix shortcuts not available due to translations
Fix issues after perspective switch
Ignore dot folders on athlete open/backup/delete
Fix imperial units labels in AeroLab
Fix Ride Cache remove 1 sec intervals
Fix intervals in Compare Pane are 1 sample short

DEPRECATED FEATURES

Deprecate Today's Plan integration
Deprecate export to KML files

TECHNICAL CHANGES

Upgraded Qwt to 6.3 (branch: qwt-multiaxes)
Upgrade Travis-ci builds to macOS 12.6 with Qt5.15
Upgrade Travis-ci Linux version to Ubuntu 20.04

ASSET SHAs

Windows 64Bit SHA-256 - 37c6ee5ee05efa53870318f94814d7b627ccec24089c307b1ea477831408512c

macOS 64Bit SHA-256 - 1867bca467f5e855aa37db9a4ad9c63ad39e283078e15043ed0c0791a65bef06

Linux 64Bit SHA-256 - 4b560383ba29a187e52ffde1fa53f548dc17a491da377fa2137c1a4a35ad37aa

IMPORTANT:

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

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.7-DEV_x64.AppImage
c) Run: $ ./GoldenCheetah_v3.7-DEV_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.

Second development build for 3.7 in August 2024

Summary of changes from v3.6 release

GUI

New graphical splashscreen with version and load progress indications, as illustrated above.
Ctrl+q for Quit on Linux, command+Q on macOS and Alt+F4 on Windows.
Drag and Drop Images onto a ride, Images gallery Python chart available for download from CloudDB.
Main Window gets drag/drop from Overview
Context help for Create/Edit User Metrics
Batch Processing now includes metadata update
Improved search/filter box drop down menu icon and color theme fixes

CHARTS

Compare mode for Map chart
Configurable grayscale filter for Map chart
Ignore zeros option for curves in Metrics Trends charts (this makes the charts saved by this version incompatible with previous ones)
Zoom & Pan for the Performance chart using +mouse wheel and mouse wheel click and drag
PfPvPlot (QA) - allow vertical scales up to 2500N
Fixed Weekly tiles in default Trends layouts
Map chart - Added interactivity to the Smallplot
Better user experience when drawing segments on the map
Python Chart Editor Cosmetics
Enabled old Calendar and Navigator charts for Trends (temporary until we have a new calendar)

FILE FORMATS

Support for the new FIT structure used by latest Garmin units, fixes the no-laps problem, but still doesn’t work with multisport files.
Update FITmetadata.json to FIT SDK 21.133
Generic Support for Session and Lap in FIT files
Decode cyclist position from FIT files
GPX parser - support ns3 TrackPointExtension name

METRICS

Enable Pace metric for Walking (this will trigger a full metric re-computation o the first start)
Rename fatigue zones for consistency
DataFilter - isAero
Interval Metadata
Datafilter xdataseries(), xdataunits() and xdatavalues()

TRAIN

New icons for the bottom bar honor light and dark themes
Improved the selection of workouts using filters (#4400)
Added Bluetooth pairing to the device wizard and BTLE support on macOS versions 12/13/14
Workout Editor supports MRC flavored qwkcode (Watts as percentages of CP)
Download Strava Routes as Workouts
Download workouts from TrainerDay (previously ErgDB) using the query API with duration and dominantzone operators.
New zoomed elevation widget for slope/distance workouts with video
Option for coalescing neighboring sections with the same watts in ERG mode workouts
Workout Plot - realtime curves honor FFWD/RWND and lap F/B
Coloring by powerzones in ErgFilePlot
Added support for old Daum devices before 2001 (#4303)

TRANSLATIONS

Updated German translation
Updated Spanish translation
Updated French translation

BUG FIXES

Fix crash on invalid perspective filter
Fixed rounding error on loading and saving erg files
Enable Multiple custom power curves for virtual power
Fix memory leak in Split Activity Wizard
Bluetooth FTMS fix to get device speed
Cursor in text workout editor was invisible
Fix crash on metadata config
Fix some non-translatable strings and update ts files
Fix lap data auto-reset in slope workouts
Fix broken workout directory check for the first start
Fix shortcuts not available due to translations
Fix issues after perspective switch
Ignore dot folders on athlete open/backup/delete

DEPRECATED FEATURES

Deprecate Today's Plan integration
Deprecate export to KML files

TECHNICAL CHANGES

Upgraded Qwt to 6.3 (branch: qwt-multiaxes)
Upgrade Travis-ci builds to macOS 12.6 with Qt5.15
Upgrade Travis-ci Linux version to Ubuntu 20.04

ASSET SHAs

Windows 64Bit SHA-256 - c0951e977264896e9025ecda149a5eca49e01b04c2859007a0b6560c8d7bc787

macOS 64Bit SHA-256 - 5ae6473c39a294425f7efff167ce639124b6dc757109de12069ed6d5b26d7cf2

Linux 64Bit SHA-256 - fcf9a5f0e4bd2b17a74e589fb27c86553c4b1cfa42a853978cb8e47938c8f2a4

IMPORTANT:

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

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.7-DEV_x64.AppImage
c) Run: $ ./GoldenCheetah_v3.7-DEV_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.

First development build for 3.7 in April 2024

Summary of changes from v3.6 release

GUI

New graphical splashscreen with version and load progress indications, as illustrated above.
Ctrl+q for Quit on Linux, command+Q on macOS and Alt+F4 on Windows.
Drag and Drop Images onto a ride, Images gallery Python chart available for download from CloudDB.
Main Window gets drag/drop from Overview
Context help for Create/Edit User Metrics

CHARTS

Compare mode for Map chart
Configurable grayscale filter for Map chart
Ignore zeros option for curves in Metrics Trends charts (this makes the charts saved by this version incompatible with previous ones)
Zoom & Pan for the Performance chart using +mouse wheel and mouse wheel click and drag
PfPvPlot (QA) - allow vertical scales up to 2500N
Fixed Weekly tiles in default Trends layouts
Map chart - Added interactivity to the Smallplot
Better user experience when drawing segments on the map
Python Chart Editor Cosmetics

FILE FORMATS

Support for the new FIT structure used by latest Garmin units, fixes the no-laps problem, but still doesn’t work with multisport files.
Update FITmetadata.json to FIT SDK 21.133
Generic Support for Session and Lap in FIT files
GPX parser - support ns3 TrackPointExtension name

METRICS

Enable Pace metric for Walking (this will trigger a full metric re-computation o the first start)
Rename fatigue zones for consistency
DataFilter - isAero
Interval Metadata
Datafilter xdataseries(), xdataunits() and xdatavalues()

TRAIN

New icons for the bottom bar honor light and dark themes
Added Bluetooth pairing to the device wizard and BTLE support on macOS versions 12/13/14
Workout Editor supports MRC flavored qwkcode (Watts as percentages of CP)
Download Strava Routes as Workouts
New zoomed elevation widget for slope/distance workouts with video
Option for coalescing neighboring sections with the same watts in ERG mode workouts
Workout Plot - realtime curves honor FFWD/RWND and lap F/B

TRANSLATIONS

Updated German translation
Updated Spanish translation

BUG FIXES

Fix crash on invalid perspective filter
Fixed rounding error on loading and saving erg files
Enable Multiple custom power curves for virtual power
Fix memory leak in Split Activity Wizard
Bluetooth FTMS fix to get device speed
Cursor in text workout editor was invisible
Fix crash on metadata config
Fix some non-translatable strings and update ts files
Fix lap data auto-reset in slope workouts
Fix broken workout directory check for the first start
Fix shortcuts not available due to translations
Fix issues after perspective switch
Ignore dot folders on athlete open/backup/delete

DEPRECATED FEATURES

Deprecate Today's Plan integration
Deprecate export to KML files

TECHNICAL CHANGES

Upgraded Qwt to 6.2 (branch: qwt-multiaxes)
Upgrade Travis-ci builds to macOS 12.6 with Qt5.15
Upgrade Travis-ci Linux version to Ubuntu 20.04

ASSET SHAs

Windows 64Bit SHA-256 - c0951e977264896e9025ecda149a5eca49e01b04c2859007a0b6560c8d7bc787

macOS 64Bit SHA-256 - 5ae6473c39a294425f7efff167ce639124b6dc757109de12069ed6d5b26d7cf2

Linux 64Bit SHA-256 - fcf9a5f0e4bd2b17a74e589fb27c86553c4b1cfa42a853978cb8e47938c8f2a4

IMPORTANT:

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

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.7-DEV_x64.AppImage
c) Run: $ ./GoldenCheetah_v3.7-DEV_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.

Version 3.6

After 3 years of development and testing this is the public release of version 3.6

What’s new in v3.6 video

NEW FEATURES

UI/UX

New User interface and Navigation model
User definable Perspectives, v3.5 layout available as "Legacy" perspective.
Overview Chart - Configurable interactive dashboards
User Chart - User definable charts using advanced expressions
Tasteful themes and named colors
Updated Default perspectives and charts

Advanced Analytics

R and Python Chart Plot to Qt - Native interactive charting from R and Python
Local python 3.7 runtime, no need to install separately
User expression language enhanced - rich support for vectors and modelling
Upload and Download User Metrics to the cloud DB

Improved Multiple Athlete Support

New Athlete View to manage multiple athletes
Separate dialogs for general options and athlete specific settings
Preferences option to start with last opened athlete or choose an athlete dialog
Configurable Aerobic Threshold HR/Power/Pace for Polarized 3 Zones analysis
Use an existing athlete as template to create a new one

Devices

ErgoFit bike support
VMPro V02 measurement
Bluetooth BTLE support for Windows 10
Bluetooth FTMS support
Daum serial devices (Vital and ErgoBike)
Wahoo Kickr (Core) control vía BTLE
Tacx ANT+ over BTLE for both, erg and slope mode, control
Kurt Kinetic Inride and SmartControl over BTLE

Cloud, Data processing & File Formats

Batch processing dialog to update files en masse
Configurable zones for any sport (including better support for rowing)
Configurable Time Dependent Measures with CSV import, including Nutrition as an example
GPS and Altitude Smoothing
TTS file type import
Upload manual activities to Strava
Better handling of Laps and swims from Strava downloads
New metadata fields trainer and commute are synced with Strava, and Equipment is set from Gear on Strava downloads.
Multisport FIT file support
Import HR during lap swims from FIT files
Ergo Planet Movie (EPM) file import
Updated download from Withings incl. new API
Import serial number and battery status for sensors from FIT files
Updated Ride with GPS upload using API v2
Azum training platform integration

Train

Perspectives for Erg, Slope, Map, Video and Editor
Live Map Chart with route preview and configurable automatic zoom
Next/Previous Lap marker navigation in bottom bar
Configurable Kinetic Energy simulation for both slope and erg modes
Includes vlc 3.0.8 for Windows, Linux and macOS
Video Overlay Widgets for Linux
Elevation Profile Overlay in Video (Windows and Linux)
Live Map Overlay in Video (Windows and Linux)
Overlay Layouts selector in Video (Windows and Linux)
Text cues on bottom bar from ERG, ZWO and JSON files
Custom Virtual Power curve for dumb trainers including inertial mass
GoldenCheetah JSON for workout and video sync
Simulated Hypoxia
Optional start countdown
Automatically select media and video sync for workouts with the same name
Save workout name as Route metadata
Enable standard key bindings for Pause/Continue and Stop while training
Enable Auto-hide bottom bar and hide sidebar when train mode starts
Changed RR and VO2 recording to avoid data loss

Embedding

R versions supported are from 3.4
Python version supported is 3.7 with SIP 4.19.8

Language support

Export to CSV with UTF8 and ISO date format for broader support of translations

Removed redundant or broken features

Deprecate Activity and Trends Summary Charts
Diary view removed to be totally rewritten in version 3.7

Critical Bug Fixes

1434 changes committed and 397 bugs fixed since version 3.5
Metric refresh deadlock and CPU hog resolved
Fixed data filter memory leaks
Withings authorization issues resolved
Sportracks download crashes resolved
VLC video freezing resolved
Python API crash resolved
Estimate distance crash resolved
Startup crash when no power zones resolved
Metric refresh crash resolved
XData copy crash resolved
L/R balance support in ANT+ and FIT files resolved
Improved segment matching
JQuery removed entirely due to security alert

ASSET SHAs

Windows 64Bit SHA-256 - d35beb0180a17e424dcfcd41b297d7c7c6fb6ef73772218e596b52352af1469f

macOS 64Bit SHA-256 - 7d3d8f5682f664b030af61b6988b94a333526dbc686cc7d1f94b6f37889cdb50

Linux 64Bit SHA-256 - 3cc4540d0490c5b1026c5f523cea34dede17c63d4eb582403d710ccb2cba1156

IMPORTANT:

Windows installation notes:
a) 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) Open the DMG and drag
b) Drop where you would like to install
c) Authorize GoldenCheetah to run
Don't run directly from the DMG.

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

Note: you need libfuse2 in your system for the above method to work, otherwise you can self-extract to the current directory: $ ./GoldenCheetah_v3.6_x64.AppImage --appimage-extract and run from there: $ squashfs-root/AppRun

Releases: GoldenCheetah/GoldenCheetah

VERSION 3.8 DEVELOPMENT MARCH 2026

Changes from version 3.7-sp1

Uh oh!

Snapshot Builds

Uh oh!

VERSION 3.8 DEVELOPMENT JANUARY 2026

Changes from version 3.7-sp1

Uh oh!

VERSION 3.7 SP1

Uh oh!

VERSION 3.7

Uh oh!

VERSION 3.7 DEVELOPMENT DECEMBER 2024

Uh oh!

VERSION 3.7 DEVELOPMENT OCTOBER 2024

Uh oh!

VERSION 3.7 DEVELOPMENT AUGUST 2024

Uh oh!

VERSION 3.7 DEVELOPMENT APRIL 2024

Uh oh!

VERSION 3.6

Uh oh!