HILFE & ANLEITUNG TrackLog v2.0.2
2. VON FAHRUHR GPS ZU TRACKLOG

Der ursprüngliche Name kam aus der ersten Version. Ganz am Anfang war die App nur eine einfache große Uhr für unterwegs. Später kamen Geschwindigkeit, Fahrzeit, Standzeit, GPX-Aufzeichnung, Rohdaten-Export und Web-Upload dazu.

Mit Version 2.0 trägt die App den Namen TrackLog – passender für das, was sie heute leistet: ein vollständiger GPS-Tracker für Fahrrad, Moped und Wandern.

3. FUNKTIONSWEISE DER APP – SO BEDIENST DU SIE

📱 Zentrales Bedienkonzept: TrackLog wurde speziell für einfache Ein-Hand-Bedienung entwickelt. Alle wichtigen Aktionen sind direkt auf dem Startbildschirm erreichbar.

⏱️ Uhrzeit
Zum Starten auf die große Uhrzeit tippen.
Fahrt beginnt, Timer läuft.
🚀 km/h-Feld
Pause / Weiter
Einmal tippen = Pause. Nochmal tippen = Aufzeichnung fortsetzen.
📍 GPS-Tracking
Unten separater Button „GPS Tracking Start“ – erst dann werden GPX-Punkte aufgezeichnet.
Mit „GPS Tracking Stop“ beendest du die Aufzeichnung.
💾 GPX speichern
Nach der Fahrt „GPX speichern“ lädt GPX + JSON herunter (und optional per Web-Upload auf deinen Server).

🔁 Kurzzusammenfassung: Uhrzeit antippen → Fahrt läuft. km/h-Feld antippen → Pause. km/h-Feld nochmal → weiterfahren. GPS-Aufzeichnung extra starten. Nach der Fahrt „GPX speichern“ für Track-Download.

ℹ️ Zusatzfunktionen: Der Bewegungsstatus (Fahrt / Stehend) wird automatisch über GPS-Geschwindigkeit und optionalem Bewegungssensor erkannt. Die Status-LEDs (rot/gelb/grün) zeigen dir an, ob du dich bewegst oder stehst.

4. DOWNLOAD ZIP – SERVER-DATEIEN (PHP + PWA)

Lade das komplette Paket herunter, das upload.php, eine vorkonfigurierte index.html und zusätzliche PWA-Assets enthält. Entpacke die ZIP und lade alle Dateien per FTP in den gewünschten Ordner deines Webspaces hoch (z.B. /tracklog/).

📦 tracklog-server.zip herunterladen

Die ZIP enthält: upload.php.template (PHP-Vorlage ohne echte Zugangsdaten), index.html, hilfe.html, manifest.webmanifest, sw.js, icon-192.png, icon-512.png und eine README.txt. Die PHP-Vorlage lokal anpassen und als upload.php hochladen.

5. EINRICHTEN PHP – WEB-UPLOAD IN 4 SCHRITTEN
1
upload.php anpassen
Öffne upload.php in einem Texteditor. Suche nach $allowedUsers und trage dort deinen Benutzernamen und ein eigenes Upload-Passwort ein.
Das ist nicht dein FTP-Passwort – frei wählbar!
2
Dateien auf Webserver laden
Lade upload.php und die gesamte App (index.html, manifest.webmanifest, sw.js) per FTP in denselben Ordner hoch, z. B. /public_html/tracklog/.
3
Zugriffsrechte prüfen
Stelle sicher, dass der Zielordner (z. B. tracks/) Schreibrechte (755 oder 775) besitzt. Die PHP-Datei legt diesen automatisch an, falls er nicht existiert.
4
In der App konfigurieren
Öffne in TrackLog die „Web-Upload Einstellungen“. Trage die Webadresse (z. B. https://meinedomain.de/tracklog/), Benutzername und Passwort ein. Speichern – fertig!

✅ Nach erfolgreichem Upload landen GPX- und JSON-Dateien im Ordner, den du unter „Zielordner“ angibst (relativer Pfad, z. B. tracks/2026-03).

6. EINSTELLUNGSFELDER ERKLÄRT (Web-Upload)
Webadresse / App-Ordner Die vollständige URL zum Ordner, in dem sich deine upload.php befindet. Beispiel: https://meinserver.de/tracklog/ (mit oder ohne Slash am Ende).
Zielordner auf Webspace Relativer Unterordner (unterhalb des App-Ordners), wo die Dateien gespeichert werden. z. B. tracks/2026-03. Wird automatisch erstellt, wenn nicht vorhanden.
Benutzername Der Name, den du in $allowedUsers in der upload.php festgelegt hast.
Passwort Das dazugehörige Upload-Passwort aus der upload.php. Achtung: Nicht dein FTP- oder Hosting-Passwort.

📌 Lokal speichern: Die Checkbox „Lokal auf dem Handy speichern“ bewirkt, dass zusätzlich zum Web-Upload ein Download der Dateien auf dein Smartphone erfolgt – perfekt für Backup.

⚙️ BEISPIEL: PASSWORT IN UPLOAD.PHP

Öffne upload.php und passe diesen Bereich an:

$allowedUsers = [ 'meinbenutzername' => 'MeinSicheresPasswort123!', ];

Mehrere Benutzer sind möglich, indem du weitere Zeilen hinzufügst. Danach akzeptiert der Upload nur diese Kombination.

7. HÄUFIGE FRAGEN (FAQ)

❓ Was bedeutet der Name TrackLog?
Velo steht für Fahrrad / Zweirad, Log für das Aufzeichnen von Daten. Mit Version 2.0 wurde die App von „Fahruhr GPS" in TrackLog umbenannt.

❓ Warum muss ich „GPS Tracking Start“ extra drücken?
Damit du die Fahrt vorbereiten kannst, ohne sofort hunderte GPS-Punkte zu sammeln. Erst nach dem Start werden Punkte für die GPX-Datei aufgezeichnet. Die Geschwindigkeit & Strecke laufen aber bereits im Hintergrund – perfekt für spontane Fahrten.

❓ Welche Dateien landen auf dem Server?
Pro Speichervorgang werden zwei Dateien hochgeladen: *.gpx (GPS-Track) und *.json (Rohdaten mit allen Statistiken, Wegpunkte, Sensordaten).

❓ Kann ich die App ohne eigenen Server nutzen?
Ja! Die App funktioniert vollständig offline. Du kannst GPX und JSON direkt auf deinem Smartphone speichern (Download). Der Web-Upload ist ein optionales Extra für deine eigene Cloud.

❓ Woher weiß ich, ob der Web-Upload geklappt hat?
Nach dem Speichern erscheint eine Meldung im Einstellungsbereich. Bei Erfolg: „Web-Upload erfolgreich: …“, bei Fehler siehst du die genaue Ursache (z. B. falsches Passwort oder Server-Problem).

❓ Wie öffne ich GPX-Dateien?
Mit Apps wie komoot, OsmAnd, Garmin Connect oder im Browser auf gpx.studio kannst du die Strecke anzeigen, analysieren und teilen.

❓ Unterstützt die App auch Bewegungssensor (Gyroskop)?
Ja – falls dein Gerät DeviceMotion unterstützt und du die Berechtigung erteilst, hilft der Sensor, Stillstand präziser zu erkennen. Das verbessert die Standzeiterkennung im Stop-and-Go.

← Zurück zur App