Tretlager

Zwift unter Linux, eingerichtet in fünf Schritten.

Version
0.11.3
Lizenz
GPL-3.0-or-later
Getestet mit
TUXEDO OS mit KDE Plasma 6.7, Arch Linux mit GNOME 51, Wahoo KICKR V4
Projekt
Quellcode

Installation

Flatpak-Bundle flatpak install --user tretlager-0.11.3-x86_64.flatpak
Aus dem Quellcode git clone https://github.com/linuxundich/tretlager.git && cd tretlager && build-aux/flatpak/build.sh

Tretlager

Zwift unter Linux, eingerichtet in fünf Schritten.

v0.11.3 · 6. November 2026 · GPL-3.0-or-later · Kirigami und PySide6 · Flatpak · Deutsch, Englisch

Tretlager installiert die offizielle Windows-Version von Zwift auf deinem Linux-Rechner, meldet dich an und verbindet Smart-Trainer und Pulsgurt per Bluetooth. Du tippst keinen Befehl ins Terminal, bastelst nicht an Wine und brauchst keine Companion-App auf dem Handy. Ein Knopf startet die Fahrt.

// Bevor du loslegst

Tretlager ist ein privates Projekt und keine offizielle Zwift-App. Zwift unterstützt Linux nicht und hat mit Tretlager nichts zu tun. Die Anmeldung läuft außerhalb des Zwift-Launchers, das widerspricht den Nutzungsbedingungen von Zwift. Eine Software-Bridge reicht Sensordaten weiter, Einschränkungen bis zur Sperre des Kontos kann ich nicht ausschließen. Für Rennen ist Tretlager nicht gedacht. Diese Punkte zeigt Tretlager vor dem ersten Start, und es geht erst weiter, wenn du zustimmst.

Zwift unter Linux

Zwift gibt es für Windows, macOS, iOS, Android und Apple TV, aber nicht für Linux. Dabei braucht Zwift wenig Leistung. In vielen Kellern, Garagen und Gartenhäusern steht ein alter Rechner, der nur noch zum Zwiften läuft. Windows 10 bekommt keine Updates mehr, und Windows 11 läuft auf vielen dieser Kisten offiziell nicht. Linux läuft darauf problemlos.

Dazu kommt eine Frage der Zeit: Zwift hat die Unterstützung für Windows 8 damals recht schnell gestrichen. Irgendwann dürfte daher auch Windows 10 folgen, und dann bleibt nur, die Hardware aufzurüsten oder auf Linux umzusteigen. Dafür ist Tretlager da: Der alte Rechner darf bleiben, nur das System darunter wechselt.

Wege zu Zwift unter Linux gibt es seit Jahren: Wine von Hand einrichten, Skripte für Lutris oder den Docker-Container netbrain/zwift, der Zwift fertig verpackt mitbringt. Ich habe mich lange durch die Tiefen der Wine-Konfiguration probiert. Am Ende scheiterte es an der Anmeldung, an den Sensoren oder am nächsten Update, und die Sensoren liefen meist nur über die Companion-App auf dem Handy.

Tretlager baut auf diesen Versuchen auf und macht daraus eine Anwendung mit Assistenten. Es prüft das System, richtet alles Nötige ein und bringt eine eigene Sensor-Bridge mit. So klappt es mit dem Zwiften auch ohne viel Linux-Wissen.

Ein Assistent statt einer Wiki-Seite

Zwift unter Wine heißt sonst: eine lange Liste mit Befehlen, .NET-Installern und Registry-Kniffen. Tretlager führt dich stattdessen durch fünf Schritte. Zuerst prüft es Grafik, Bluetooth, Speicherplatz und Netz, ohne etwas zu ändern, und sagt dir, was fehlt.

Installiert Zwift von selbst

Tretlager bringt ein eigenes Wine mit, lädt den offiziellen Installer direkt von Zwift, prüft dessen Signatur und richtet Schriften, .NET 4.8 und WebView2 ein. Danach holt der Zwift-Launcher das Spiel. Mit einer normalen Leitung dauert das rund 15 Minuten.

Trainer und Pulsgurt ohne Handy

Wine kommt nicht an Bluetooth-Sensoren heran. Die Sensor-Bridge von Tretlager verbindet sich per Bluetooth LE mit Trainer und Pulsgurt und bietet sie Zwift auf demselben Rechner an, so wie ein Wahoo-Trainer mit Direct Connect. In Zwift wählst du einfach „Wahoo KICKR …“ und „Wahoo HRM …“. ERG-Modus und Steigungen funktionieren.

Ein Knopf zum Losfahren

Die Übersicht zeigt Sensoren, Zwift-Version, Grafikkarte, Wine und Anmeldung auf einen Blick. „Zwift starten“ nutzt bei Hybrid-Notebooks die NVIDIA-Karte. Während der Fahrt wartet Tretlager im Hintergrund, zeigt Live-Werte und räumt danach auf.

Was Tretlager noch kann

Anmeldung, die funktioniert

Die Anmeldeseite des Zwift-Launchers läuft unter Wine nicht. Tretlager öffnet Zwifts eigene Anmeldeseite in einem privaten Fenster. Dein Passwort tippst du bei Zwift ein, nie in Tretlager.

Sitzung im Schlüsselbund

Die Anmeldung liegt in KWallet oder im GNOME-Schlüsselbund. Abmelden entfernt sie wieder.

Updates ohne Ärger

Vor jedem Start bringt Tretlager die Zwift-Umgebung in Ordnung und lässt den Launcher Updates installieren. Bei einem Zwift-Update zeigt die Übersicht den Fortschritt.

Bewährtes Wine bleibt

Eine neue Wine-Version kommt mit einer neuen Tretlager-Version. Die letzte funktionierende bleibt erhalten, ein Schalter holt sie zurück.

Warnt rechtzeitig

Tretlager meldet sich, wenn das Notebook am Akku hängt oder Bluetooth-Kopfhörer am Adapter der Bridge die Sensoren stören.

USB-Adapter wählbar

Ist der eingebaute Bluetooth-Chip unzuverlässig oder zu weit weg, wählst du einen USB-Adapter für die Bridge.

Bildschirm bleibt an

Solange Zwift startet und läuft, hält Tretlager den Bildschirm wach, auch in einer Pause ohne Maus und Tastatur.

Fehlerberichte

Bei Problemen speichert Tretlager einen Bericht als ZIP-Datei. Token, Passwörter und Mail-Adressen sind darin entfernt.

Getestete Hardware

RechnerTUXEDO InfinityBook Pro Gen7 (Core i7-12700H, RTX 3050 Ti) mit TUXEDO OS und KDE Plasma 6.7; Dell XPS 15 9560 (Core i7-7700HQ, GTX 1050) mit Arch Linux und GNOME 51
TrainerWahoo KICKR V4: Leistung, Trittfrequenz, ERG-Modus und Steigungen
PulsgurteWahoo TICKR; Garmin HRM-Pro Plus (trennt sich alle 7 bis 15 Minuten selbst und verbindet sich danach wieder)
Nicht unterstütztANT+

Andere Trainer und Pulsgurte mit den Bluetooth-Standards FTMS, Cycling Power und Heart Rate sollten funktionieren, getestet habe ich sie nicht. Details stehen in der Hardware-Liste.

Installieren

Dein System braucht Flatpak mit Flathub, BlueZ mit einem Bluetooth-LE-Adapter, den Avahi-Dienst und einen Schlüsselbund. Das Flatpak-Bundle von GitHub laden und installieren:

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

Fehlt die KDE-Laufzeit 6.11, holt Flatpak sie von Flathub, auf NVIDIA-Systemen auch die passende Treiber-Erweiterung. Bundles aktualisieren sich nicht selbst, neue Versionen findest du auf der Release-Seite.

Fragen und Antworten

Ist Tretlager eine offizielle Zwift-App?

Nein. Tretlager ist ein privates Projekt, Zwift hat damit nichts zu tun und leistet keinen Support. Fehler meldest du bitte auf GitHub.

Verändert Tretlager Zwift?

Nein. Zwift ist das unveränderte Windows-Spiel von den Servern von Zwift. Tretlager umgeht keine Anmeldung und keine Lizenzprüfung und sendet keine Telemetrie.

Kann ich damit Rennen fahren?

Bitte nicht. Ich kann nicht garantieren, dass die Bridge Leistung, Trittfrequenz und Puls immer korrekt an Zwift weitergibt.

Brauche ich die Companion-App?

Nein. Trainer und Pulsgurt verbindet die Sensor-Bridge direkt über Bluetooth LE mit dem Rechner.

Läuft das auch auf älteren Rechnern?

Zwift rendert mit OpenGL und braucht wenig Leistung. Getestet habe ich Tretlager auf zwei Notebooks, das ältere ist ein XPS 15 von 2017. Rückmeldungen zu anderer Hardware sind sehr willkommen.

Warum nicht auf Flathub?

Flathub nimmt keine Anwendungen an, deren Manifest mit KI-Unterstützung entstanden ist. Deshalb gibt es Tretlager als Flatpak-Bundle auf GitHub.

Ausprobiert?

Ob es bei dir läuft oder nicht: Jede Rückmeldung zu Rechner, Trainer und Pulsgurt hilft. Schreib einfach unten einen Kommentar, ein Konto brauchst du dafür nicht. Fehler gern auch als Issue auf GitHub.

Tretlager ist KI-unterstützt entstanden. Code, Symbole und Übersetzungen sind mit Hilfe von KI nach meinen Vorgaben entstanden. Ich habe die Entscheidungen getroffen, die Ergebnisse geprüft und alles auf meinen eigenen Geräten getestet. Zwift ist eine Marke von Zwift, Inc., Wahoo, KICKR und TICKR sind Marken von Wahoo Fitness, Garmin und HRM-Pro Marken von Garmin Ltd. Tretlager ist mit keiner dieser Firmen verbunden.

Kommentare

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht.

Markdown wird unterstützt: **fett**, _kursiv_, [Linktext](URL), `Code`, Zeilen mit - für Listen, 1. für nummerierte Listen, dreifache Backticks für Codeblöcke.

Sicherheitsprüfung: läuft automatisch, du musst nichts tun.