Mein (PCT)-Tracker: wie er funktioniert und was dahinter steckt

Zur Vermeidung von Spam werden deine Posts vor Veröffentlichung von den Moderatoren geprüft, falls du Links verwendest.
  • Ein paar haben gefragt, wie mein Tracker funktioniert, deshalb hier mal ausführlich.

    Die Idee
    Familie und Freunde sollen sehen können, wo ich gerade bin, ohne dass ich ständig am Handy hänge. Die Uhr zeichnet den Weg auf, die Seite aktualisiert sich von selbst. Gedanken spreche ich einfach als Notiz ins Handy, und wenn ich in der Stadt Netz habe, schicke ich sie mit einem Kurzbefehl ab. Fotos genauso. Für mich also möglichst wenig Aufwand.

    Seite: https://dacat84.github.io/pct-tracker/
    Bis zum Start am 22. April steht der Punkt noch in Campo und es läuft ein Countdown.

    Was drauf ist

    • Karte mit meiner Position, der gelaufenen Strecke und einem Höhenprofil vom ganzen PCT
    • Statistik: Kilometer, Höhenmeter, Schnitt pro Tag, jeder Tag einzeln
    • Tagebuch und Fotos
    • Ausrüstung mit Base Weight, kommt direkt aus meiner LighterPack-Liste
    • alles auf Deutsch und Englisch

    Vorweg: Ich bin kein Programmierer
    Angefangen hat alles mit dem Tracker von Karel Sabbe: https://pct.karelsabbe.com/
    Den fand ich so gut, dass ich ChatGPT einfach gefragt habe: „Kannst du mir sowas kostenlos bauen?“ Danach ging es mit Copy und Paste weiter, und ich habe ganz oft in den Chat geschrieben „ich habe keine Ahnung, erklär mir Schritt für Schritt, wo ich was kopieren, einstellen oder klicken muss“. Ziemlich schnell bin ich dann auf Claude umgestiegen. Mittlerweile ist Claude so gut in GitHub eingebunden, dass ich nur noch chatte und gar nicht mehr selbst klicke, wenn ich etwas ändern will. Ich sage zum Beispiel „bei der Statistik hätte ich gern noch die Höhenmeter hinter den Kilometern“, und ein paar Minuten später ist es online.

    Wie die Daten von der Uhr auf die Seite kommen
    Die Seite läuft auf GitHub Pages, also ohne eigenen Server. Alles sind einfache Dateien in einem Repo, und sobald sich eine Datei ändert, baut GitHub die Seite neu.

    1. Die Uhr (bei mir eine Enduro 4) synct über die Garmin Connect App aufs Handy, sobald ich Netz habe.
    2. Bei GitHub läuft stündlich ein kleines Python-Skript („GitHub Action“). Es meldet sich bei Garmin Connect an und schaut, ob es neue Wanderungen gibt.
    3. Neue Aktivitäten lädt es als GPX runter, dünnt sie etwas aus und hängt sie an die Strecke an. Der letzte Punkt wird meine aktuelle Position.
    4. Die Seite baut sich neu und zeigt alles an.

    Ehrlicherweise läuft das nicht wirklich stündlich. GitHub schiebt diese geplanten Läufe gerne mal ein paar Stunden nach hinten. Deshalb startet der Abgleich zusätzlich jedes Mal, wenn ich einen Tagebucheintrag schicke. Dann ist die Karte genau dann aktuell, wenn ich Netz habe und etwas poste.

    Das Höhenprofil
    Die Strecke ist die offizielle PCT-Linie der PCTA. Davon wurden einmal rund 2.000 Punkte in gleichen Abständen genommen und für jeden die Höhe aus einem freien Höhenmodell (SRTM, 30 m Raster) abgefragt. Pässe, Gipfel, Orte und Wasserstellen im Profil sind von Hand eingetragen. Das Profil wird also nicht ständig neu berechnet, die Seite lädt es nur.

    Tagebuch und Fotos
    Das Tagebuch ist ein iOS-Kurzbefehl. Der nimmt meine Notiz und legt sie als kleine Textdatei auf Deutsch und Englisch im Repo ab, über die GitHub-Schnittstelle.

    Bei den Fotos suche ich mir am Handy die aus, die ich teilen will, und schiebe sie in der Flickr-App in mein PCT-Album. Die Seite holt sich die Bilder dann direkt aus dem Album. Bei GitHub selbst landen die Fotos also gar nicht. Das hatte ich am Anfang versucht, aber da gab es nur Probleme, und ich hatte auch keine Ahnung, wie viel Platz das auf Dauer braucht. Mit Instagram oder etwas Ähnlichem geht das bestimmt auch, ich nutze aber nur Flickr.

    Die Ausrüstung kommt aus LighterPack. Alle paar Stunden liest ein Skript meine öffentliche Liste und rechnet Base Weight, Zelt, Schlafsystem und Rucksack zusammen. Wenn ich in LighterPack etwas ändere, passt sich die Seite von selbst an.

    Logins und Tokens
    Mein Garmin-Passwort liegt nirgends gespeichert. Ich habe mich einmal am Mac mit einem kleinen Skript angemeldet, das daraus einen Token macht, eine Art Zugangsschlüssel. Den Token habe ich bei GitHub als „Secret“ hinterlegt. Das ist ein verschlüsselter Speicher, den nur die Skripte lesen können, auch wenn das Repo öffentlich ist. Garmin erneuert den Token regelmäßig, und das Skript legt die neue Version jedes Mal verschlüsselt für den nächsten Lauf ab. Dadurch muss ich mich nicht ständig neu anmelden.

    Für den Kurzbefehl braucht man einen eigenen GitHub-Token. Am besten einen, der nur in dieses eine Repo schreiben darf und sonst nichts.

    Für Garmin nutze ich die Python-Bibliothek „garminconnect“. Die ist nicht offiziell von Garmin. Garmin hat dieses Jahr das Login umgestellt, danach ging erstmal nichts mehr, bis ich auf die neue Version umgestiegen bin. Kann also wieder passieren.

    Was er nicht kann

    • Echtes Live-Tracking. Die Seite ist so aktuell wie der letzte Moment mit Netz, plus ein paar Stunden GitHub-Verzögerung.
    • Position über Satellit, also inReach. Hab ich bisher nicht drin.

    Kosten
    Null. GitHub Pages, die Skripte, Flickr und LighterPack sind kostenlos.

    Selbst nachbauen
    Ist alles Open Source: https://github.com/dacat84/pct-tracker
    Funktioniert mit jeder Garmin, die nach Garmin Connect synct. Und das Ganze ist nicht auf den PCT festgelegt. Man tauscht die Strecke gegen die von einem anderen Trail aus, eine GPX-Datei reicht. Dann rechnet man das Höhenprofil einmal neu und passt Orte und Texte an. So geht das genauso für den CDT, den AT, den GR20, den Te Araroa oder auch zwei Wochen in den Alpen.

    Wer was Ähnliches vorhat oder das Ganze einfach für sich kopieren und anpassen will, würde ich einfach bei Claude oder einer anderen KI so etwas eingeben:

    „Schau dir mal den Tracker hier an: https://github.com/dacat84/pct-tracker. Kannst du das für mich auch bauen? Ein paar Sachen möchte ich ändern. Sag mir, was du von mir brauchst und wie ich am besten anfange.“

    Und dann ruhig zugeben, wenn man keine Ahnung hat. Hat bei mir auch funktioniert. Bei Fragen gern hier melden.


    ( Moderatoren keine Ahnung wohin mit dem Post ich hoffe er passt in diese Kategorie)

  • Danke dir! Da es womöglich auch für andere Interessant ist, frage ich mal hier weiter:

    Die GitHub Action, die bei Connect nachschaut, ob's was neues gibt und es dann ins Repo lädt, funktioniert vermutlich nicht mit aktivierter 2-Faktor-Authentifizierung bei Garmin, sehe ich das richtig?
    Ich habe das irgendwann mal bei Garmin Connect aktivieren müssen, um die EKG Funktionen nutzen zu können. Seither gibt's immer den Schwenk über einen Code, der an meine E-Mail Adresse gesendet wird. D.h. ein automatischer Login dürfte so nicht möglich sein – lässt sich leider auch nicht rückgängig machen.

  • Doch, das geht auch mit 2-Faktor. Der Code wird nur einmal gebraucht, nämlich bei der allerersten Anmeldung am eigenen Rechner. Das kleine Login-Skript fragt dann nach E-Mail, Passwort und eben nach dem Code aus der Mail. Daraus entsteht ein Token, und nur der wird bei GitHub hinterlegt.

    Danach meldet sich das Skript bei GitHub nie mehr mit Passwort und Code an, sondern immer nur mit dem Token. Den erneuert Garmin regelmäßig, und das Skript speichert die neue Version jedes Mal für den nächsten Lauf. Einen Code braucht man erst wieder, wenn man sich mal komplett neu anmelden muss, zum Beispiel wenn Garmin den Token ungültig macht oder wieder etwas am Login ändert. Dann macht man das eben einmal neu am Rechner.

  • Ich teste gerade bei mir wie gut es klappt... siehe screenshots vom testsetup.

    Tracke gerade alle Spaziergänge (wenn ich es nicht vergesse hehe)

    Jede Aufzeichnung wechselt sich ab zwischen "cyan" und "magenta" hier kann sich aber auch jeder selbst austoben mit den farben.

  • Ich hab mich auch gefragt, wie einfach man das inReach in eine eigene Karte einbauen kann, und es geht sogar ziemlich leicht, eher leichter als das mit Garmin Connect.

    Sobald MapShare an ist, stellt Garmin automatisch einen öffentlichen Datenfeed bereit, unter share.garmin.com/Feed/Share/<dein MapShare-Name>. Ein Login braucht man dafür nicht, nur das MapShare-Passwort, falls man eins gesetzt hat. Im Feed stehen alle Trackpunkte mit Zeit, Koordinaten und Höhe, dazu die Nachrichten. Andere Programme wie Home Assistant oder Traccar lesen genau den aus.

    Für so einen Tracker hieße das:

    1. Ein kleines Skript bei GitHub holt den Feed regelmäßig ab und speichert die Punkte als Datei, genauso wie der Garmin-Abgleich.
    2. Auf der Karte erscheinen die inReach-Punkte in einer eigenen Farbe.
    3. Der Positionspunkt springt immer auf die neueste Position, egal ob die von der Uhr kommt oder vom inReach.

    Ein paar Sachen sollte man wissen:

    • Je nach Abo schickt das inReach nur alle 10 bis 30 Minuten einen Punkt. Das ergibt eher eine grobe Linie als eine genaue Strecke. Ich würde die Kilometer deshalb weiter von der Uhr nehmen und das inReach nur für die Position.
    • Das inReach sendet zwar per Satellit, die Seite wird aber trotzdem nur aktualisiert, wenn GitHub den Abgleich startet. Also auch hier ein paar Stunden Verzögerung.
    • Ohne MapShare-Passwort ist der Feed öffentlich. Wer den Link hat, sieht deine Position. Ist bei so einer Trackerseite aber eh nicht anders.

    Ich hab es selbst noch nicht drin, aber mit KI ist das vermutlich eine Stunde Chatten. Das eigentliche Testen geht dann nur mit Gerät und aktivem Abo.

    Andere Uhren gehen übrigens auch. Am einfachsten über Strava, weil da fast jede Uhr hin synct, egal ob Suunto, Coros, Polar oder Apple Watch. Mein Tracker lief am Anfang sogar über Strava, der Code liegt noch mit im Repo. Ich hab mich für die Garmin Enduro wegen der Akkulaufzeit entschieden und hole die Daten deshalb direkt aus Garmin Connect.

  • Guter Punkt, und gegen einen geknackten GitHub-Account hilft die Verschlüsselung wirklich nichts, da hast du recht. Dafür ist sie aber auch nicht gedacht.

    Es geht um was anderes: Garmin erneuert den Token regelmäßig, und die neue Version muss irgendwo bis zum nächsten Lauf liegen. In die Secrets kann ein Workflow nicht selbst zurückschreiben, deshalb landet sie im Actions-Cache. Und der ist eben kein geschützter Speicher wie die Secrets. Bei einem öffentlichen Repo kommen da unter Umständen auch Abläufe ran, die nicht von mir sind, zum Beispiel über einen Pull Request mit verändertem Workflow. An die Secrets kommen die nicht.

    Deshalb liegt im Cache nur die verschlüsselte Version, und der Schlüssel liegt getrennt davon in den Secrets. Der Tresor ist also der Cache, und die Kombination steht nicht drauf, sondern liegt woanders.

    Wenn jemand meinen Account übernimmt, ist das sowieso alles egal. Dafür hab ich 2-Faktor bei GitHub an.

Jetzt mitmachen!

Du hast noch kein Benutzerkonto auf unserer Seite? Registriere dich kostenlos und nimm an unserer Community teil!