Tretlager 0.11.3

Tretlager 0.11.3 says when Zwift is updating and drops a warning that turned out to be wrong.

Warning

Not an official Zwift app, use at your own risk. Zwift does not support Linux and has nothing to do with Tretlager. Restrictions up to a suspended account, including your XP and drops, cannot be ruled out. Not for races. The sign-in happens outside the Zwift launcher, which contradicts Zwift's terms of service.

Install

flatpak install --user tretlager-0.11.3-x86_64.flatpak

Installing over an earlier version keeps your Zwift setup, sign-in and sensors. Close and reopen Tretlager afterwards so the new sensor bridge replaces the running one. The bundle does not update itself.

What's new since 0.11.2

• Zwift updates are visible. When Zwift updates itself before the ride, the overview says Zwift is being updated… and, under Version, Updating from … to … – Zwift starts afterwards, together with the download progress. Before, it said Zwift is starting… and claimed the update would happen at the next start. Verified with the first real Zwift update under Tretlager, 1.124.0 → 1.125.0: about 280 MB, done in a minute and a half.
• No more warning for the Garmin HRM-Pro on the Intel AX201. The service discovery that "hung" on this chip was the slow connection interval Linux remembers for the strap. Since 0.11.2 the bridge waits for it, and the HRM-Pro Plus connects through the AX201 in 7 to 12 seconds.

Full list in the changelog.

Tretlager 0.11.2

Tretlager 0.11.2 polishes the reconnecting of heart rate straps introduced in 0.11.1.

Warning

Not an official Zwift app, use at your own risk. Zwift does not support Linux and has nothing to do with Tretlager. Restrictions up to a suspended account, including your XP and drops, cannot be ruled out. Not for races. The sign-in happens outside the Zwift launcher, which contradicts Zwift's terms of service.

Install

flatpak install --user tretlager-0.11.2-x86_64.flatpak

Installing over an earlier version keeps your Zwift setup, sign-in and sensors. Close and reopen Tretlager afterwards so the new sensor bridge replaces the running one. The bundle does not update itself.

What's new since 0.11.1

• As soon as a sensor answers, it shows Found, reading the sensor… instead of Searching for the device…. After a dropout a strap often still uses a slow connection setting, and reading it can take a minute or two; the old text looked as if the strap was not found at all.
• Reading a sensor may now take up to 150 seconds instead of 90: right after the 0.11.1 release the Garmin HRM-Pro Plus needed 80 seconds on the test computer.
• The help section Heart rate straps says how long this can take.

Full list in the changelog.

Tretlager 0.11.1

Tretlager 0.11.1 brings heart rate straps back by themselves after a dropout or a break out of range.

Warning

Not an official Zwift app, use at your own risk. Zwift does not support Linux and has nothing to do with Tretlager. Restrictions up to a suspended account, including your XP and drops, cannot be ruled out. Not for races. The sign-in happens outside the Zwift launcher, which contradicts Zwift's terms of service.

Install

flatpak install --user tretlager-0.11.1-x86_64.flatpak

Installing over 0.10.0 or 0.11.0 keeps your Zwift setup, sign-in and sensors. Close and reopen Tretlager afterwards; the sensor bridge of the new version replaces the running one. Requirements as before: Flatpak with Flathub, BlueZ with a Bluetooth LE adapter, a running avahi-daemon and a Secret Service keyring. The bundle does not update itself.

What's new since 0.11.0

• Straps come back after a dropout. A Wahoo TICKR or Garmin HRM-Pro Plus that lost its connection (out of range during a break, or the strap ending the connection itself) used to hang until the Bluetooth adapter was unplugged or the computer restarted. The straps switch their own connection to long intervals (TICKR about 1 s, HRM-Pro Plus about 2 s) and Linux starts every new connection with that interval, so finding the strap's services took longer than the bridge waited. The bridge now gives this step up to 90 seconds without holding up the other sensors. In tests the TICKR came back after 40 s, the HRM-Pro Plus after 38 s.
• If a strap still does not come back, Tretlager says so: unplug and plug in the Bluetooth adapter, or restart the computer. The automatic adapter reset is only used when no connection comes up at all, so it no longer drops the trainer for nothing.
• Keep screen on during the ride (on by default): the screen does not dim, lock or suspend while Zwift runs, also during a break.
• A notice when Bluetooth headphones share the adapter with the sensors; audio crowds out the sensors.
• Help: a new section Heart rate straps explains these quirks of the TICKR and the HRM-Pro Plus, and why straps should not be paired in the system settings.
• A second sensor bridge no longer runs next to the first one and fights over the sensors.

Known: the Garmin HRM-Pro Plus ends its Bluetooth connection by itself every 7 to 15 minutes on Linux and stays silent for a few minutes; with 0.11.1 it then reconnects without help, but heart rate is missing for that time. The Wahoo TICKR does not do this.

Full list in the changelog.

Tretlager 0.11.0

Tretlager 0.11.0 makes it easy to report problems and fixes Zwift on setups with two monitors.

Warning

Not an official Zwift app, use at your own risk. Zwift does not support Linux and has nothing to do with Tretlager. Restrictions up to a suspended account, including your XP and drops, cannot be ruled out. Not for races. The sign-in happens outside the Zwift launcher, which contradicts Zwift's terms of service.

Install

flatpak install --user tretlager-0.11.0-x86_64.flatpak

Installing over 0.10.0 keeps your Zwift setup, sign-in and sensors. Requirements as before: Flatpak with Flathub, BlueZ with a Bluetooth LE adapter, a running avahi-daemon and a Secret Service keyring. The bundle does not update itself.

Reporting a problem

1. About Tretlager → Error reports → switch on Detailed logging (or right-click Tretlager in the application menu → Start with detailed logging).
2. Reproduce the problem.
3. Save error report… and attach the ZIP file to an issue or send it to me.

The report contains system information (versions, desktop, screens, graphics, Wine, sensor bridge status, system check) and the logs of Tretlager, the sensor bridge, Wine and Zwift. Sign-in tokens, passwords and e-mail addresses are removed; Zwift's own log lists the names of nearby riders.

What's new since 0.10.0

• Error reports and a detailed logging mode (see above).
• Zwift opens on the monitor it was last used on and is only maximised once it has finished loading; its picture no longer sticks out over the edge of the screen when two monitors use different scaling.
• Wine's output of Zwift is kept in zwift-wine.log (plus the previous launch), the sensor bridge writes bridge.log, so crashes leave a trace.
• Help: Reporting a problem and Zwift's picture sticks out over the edge of the screen.

Full list in the changelog.

Tretlager is AI-assisted and free software under the GPL-3.0-or-later. Zwift is a trademark of Zwift, Inc.; Tretlager is not affiliated with or endorsed by Zwift.

Tretlager 0.10.0

The first public release of Tretlager: Zwift on Linux, set up in five steps. Tretlager installs the official Windows version of Zwift with its own Wine, signs you in and connects your smart trainer and heart rate strap over Bluetooth through a sensor bridge. No terminal, no Companion app.

Warning

Not an official Zwift app, use at your own risk. Zwift does not support Linux and has nothing to do with Tretlager. Zwift may not be happy that a software bridge sends data to Zwift that could be manipulated; restrictions up to a suspended account, including your XP and drops, cannot be ruled out. Not for races: there is no guarantee that the bridge passes power, cadence and heart rate correctly. The sign-in happens outside the Zwift launcher, which contradicts Zwift's terms of service.

Install

Your system needs Flatpak with the Flathub remote, BlueZ with a Bluetooth LE adapter, a running avahi-daemon and a Secret Service keyring (KWallet or GNOME Keyring).

flatpak install --user tretlager-0.10.0-x86_64.flatpak

Flatpak fetches the KDE 6.11 runtime from Flathub if it is missing, and on NVIDIA systems the matching driver extension. Start Tretlager from the application menu; setting up Wine and downloading Zwift takes about 15 minutes. The bundle does not update itself.

Tested on TUXEDO OS with KDE Plasma 6.7 (RTX 3050 Ti) and Arch Linux with GNOME 51 (GTX 1050) with a Wahoo KICKR V4, a Wahoo TICKR and a Garmin HRM-Pro Plus. See tested hardware.

What's new since 0.9.0

• Warnings on first start that must be accepted: not an official Zwift app, at your own risk, not for races, sign-in outside the launcher.
• Works outside Plasma: Breeze style with complete icons, follows GNOME's light/dark mode and font.
• Fixed a crash when opening the sign-in window in the Flatpak.
• The graphics setup notices when an NVIDIA card is switched on or off and only uses it when the driver and the Flatpak extension are present.
• The sensor bridge connects the trainer first and gives up on an absent sensor after 20 s instead of 40 s.
• Built against PySide 6.11.3 so it starts with the current KDE 6.11 runtime.
• English is now the source language; the German translation is included.

Full list in the changelog.

Tretlager is AI-assisted and free software under the GPL-3.0-or-later. Zwift is a trademark of Zwift, Inc.; Tretlager is not affiliated with or endorsed by Zwift.