Mit Strava verbinden

VeloLoop zeichnet deine Fahrten als Standard-FIT-Dateien auf, die Strava akzeptiert. Du kannst Fahrten jederzeit manuell über die Strava-Website hochladen. VeloLoop enthält außerdem eine integrierte Strava-Anbindung für automatische Uploads und Uploads per Klick, die verfügbar ist, sobald der Projektbetreiber die Strava-API-Verbindung konfiguriert hat.

Zu Strava hochladen (manuell)

Der schnellste Weg, deine Fahrt auf Strava zu bekommen — funktioniert für alle, keine Konfiguration nötig:

  1. 1Öffne Strava im Browser und gehe zur Upload-Seite (strava.com/upload/select)
  2. 2Klicke auf „Dateien auswählen“ und wähle deine FIT-Datei aus Documents/VeloLoop/Rides
  3. 3Setze den Aktivitätstyp auf „Virtual Ride“
  4. 4Füge einen Titel und eventuelle Notizen hinzu
  5. 5Klicke auf Hochladen

Wenn die virtuelle Distanz aktiviert ist, enthält VeloLoop geschätzte Distanz und Geschwindigkeit in der FIT-Datei, sodass Strava diese Werte für deine Fahrt anzeigt.

Integrierte Strava-Anbindung

Hinweis: Die integrierte Strava-Anbindung ist in VeloLoop implementiert, erfordert aber eine einmalige Einrichtung durch den Projektbetreiber (Bereitstellung des Authentifizierungsproxys und Registrierung einer Strava-API-Anwendung). Ohne Konfiguration sind die Strava-Funktionen in der App ausgeblendet. Der End-to-End-Upload wurde noch nicht gegen die Live-Strava-API verifiziert.

  • VeloLoop enthält eine integrierte Strava-Anbindung mit OAuth-2.0-Authentifizierung, automatischem Upload und manuellen Upload-Steuerungen
  • Diese Funktion erfordert eine einmalige Konfiguration durch den Projektbetreiber: Bereitstellung des Cloudflare-Worker-Proxys und Registrierung einer Strava-API-Anwendung
  • Nach der Konfiguration erscheint nach deiner Fahrt ein „Mit Strava verbinden“-Button in der Desktop-App
  • Nach der Verbindung kannst du Fahrten manuell über einen Button im Nachfahrt-Panel hochladen oder den automatischen Upload aktivieren, sodass Fahrten nach Abschluss an Strava gesendet werden
  • Der automatische Upload ist standardmäßig deaktiviert — du entscheidest in den Einstellungen, ob du ihn aktivierst
  • Strava-Zugangsdaten werden sicher in der Anmeldeinformationsverwaltung deines Betriebssystems gespeichert (Windows-Anmeldeinformationsverwaltung oder macOS-Schlüsselbund) — niemals in einer Klartextdatei
  • Zum Trennen: Klicke in den Einstellungen im Strava-Bereich auf Trennen — VeloLoop widerruft den Zugriff und entfernt gespeicherte Zugangsdaten
  • Deine FIT-Dateien bleiben immer lokal in Documents/VeloLoop/Rides, auch nach dem Hochladen
  • VeloLoop verfolgt Uploads lokal, um doppelte Übermittlungen an Strava zu vermeiden

So funktioniert die Verbindung

Sobald die Strava-Integration in deinem Build aktiviert ist, läuft die Verbindung wie folgt ab:

  1. 1Öffne VeloLoop und beende oder überspringe eine Fahrt, sodass das Nachfahrt-Panel sichtbar ist
  2. 2Klicke auf „Mit Strava verbinden“
  3. 3Dein Browser öffnet die Strava-Autorisierungsseite
  4. 4Genehmige VeloLoop — es wird nur die Berechtigung „Aktivitäten hochladen“ angefordert
  5. 5Der Browser zeigt eine Bestätigungsseite — du kannst ihn schließen und zu VeloLoop zurückkehren
  6. 6VeloLoop zeigt deinen Strava-Verbindungsstatus und die Upload-Steuerungen

Aktivitätstyp

  • VeloLoop setzt den Sporttyp in allen FIT-Dateien auf „VirtualRide“
  • Wähle bei manuellen Uploads „Virtual Ride“, damit Strava die Indoor-Daten korrekt verarbeitet
  • Wenn die virtuelle Distanz aktiviert ist, enthält VeloLoop geschätzte Distanz und Geschwindigkeit, die aus deinen Leistungsdaten berechnet werden — Strava zeigt diese neben Leistung, Trittfrequenz und Herzfrequenz an
  • Es werden keine GPS-Koordinaten oder Höhendaten aufgezeichnet — das ist normal für Indoor-Cycling

Häufige Probleme

Doppelte Aktivität abgelehnt

Strava lehnt Dateien ab, die bereits empfangen wurden. Wenn du diesen Fehler beim manuellen Upload siehst, ist die Fahrt bereits auf Strava. Die integrierte Anbindung verfolgt Uploads lokal, um Duplikate automatisch zu vermeiden.

Distanz oder Geschwindigkeit weicht von der Erwartung ab

VeloLoop enthält geschätzte virtuelle Distanz und Geschwindigkeit, die mithilfe eines Flachstraßen-Physikmodells aus der Leistung abgeleitet werden (wenn in den Fahrteinstellungen aktiviert). Dies sind Schätzungen, keine GPS-Messungen. Strava kann leicht abweichende Werte anzeigen, wenn es eigene Berechnungen anwendet.

Upload hängt bei der Verarbeitung

Strava verarbeitet Uploads asynchron. VeloLoop fragt den Status ab (Hochladen, Verarbeiten, Erfolgreich oder Fehler). Wenn sich der Status innerhalb einer Minute nicht aktualisiert, prüfe deine Strava-Aktivitätenseite — der Upload ist meist erfolgreich.

Strava-Option in der App nicht sichtbar

Die integrierte Strava-Anbindung ist nur sichtbar, wenn der Projektbetreiber die Strava-API-Zugangsdaten konfiguriert hat. Wenn du keine Strava-Option siehst, wurde die Integration für deinen Build nicht aktiviert. Du kannst FIT-Dateien jederzeit manuell über die Strava-Website hochladen.

Datenschutz

  • VeloLoop fordert nur die Berechtigung „activity:write“ an — es liest weder deine Strava-Daten noch Follower, Strecken oder persönliche Informationen
  • Strava-Zugangsdaten werden sicher in der Anmeldeinformationsverwaltung deines Betriebssystems gespeichert (Windows-Anmeldeinformationsverwaltung oder macOS-Schlüsselbund) — niemals in einer Klartextdatei
  • Client-Secrets werden niemals in die Desktop-App eingebettet — die Authentifizierung wird an einen serverseitigen Proxy delegiert
  • Du kannst die Verbindung jederzeit trennen und den Zugriff widerrufen — über die VeloLoop-Einstellungen oder die Strava-Seite für verbundene Apps