Dokumentation

Grom ist ein self-hosted Trainings-Tracker mit optionaler ActivityPub-Föderation. Erfassen oder importieren Sie Workouts, verwalten Sie Ausrüstung, folgen Sie anderen Sportlern (lokal oder föderiert), liken und kommentieren Sie Aktivitäten und browsen Sie einen Social Feed — auf Infrastruktur, die Sie kontrollieren.

Der Server ist eine einzelne Go-Binary; der Flutter-Client erscheint als eingebettete Web-UI und als Android-App.

Funktionen

• Workouts — Aktivitäten mit Stats, Notizen, Medien und Kartenvorschauen erstellen und bearbeiten
• GPS-Tracks — GPX und FIT importieren; Live-Aufzeichnung auf Android
• Ausrüstung — Fahrräder, Schuhe und anderes Gear, verknüpft mit Workouts
• Social Feed — Nutzern folgen und ihre Workouts in einer Timeline sehen
• Likes — fremde Aktivitäten liken, Zähler und Likes-Liste; föderierte Like / Undo bei aktiviertem ActivityPub
• Kommentare — eigene und fremde Aktivitäten kommentieren (hinzufügen/auflisten/löschen); föderierte Create/Delete Note bei aktiviertem ActivityPub
• Föderation — optionales ActivityPub, damit Instanzen sich netzwerkweit folgen können
• Strava-Import — Massenimport eines Strava-Datenexport-ZIP
• Health Sync — Aktivitäten von Google Drive auf Android importieren (Health-Sync-Exporte)
• API-Token — persönliche Zugriffstoken mit Scopes (grom_pat_…) für Workouts und Ausrüstung
• Clients — dieselbe Flutter-UI im Browser (vom Server ausgeliefert) und als Android-APK
• Sprachen — Englisch, Russisch und Deutsch in der Flutter-UI

Tour durch die Bildschirme: Benutzerüberblick. Bauen und starten: Installation und Start. Quellcode und Quick Start: Repository-README.

Ich möchte…

Benutzer

Ziel	Seite
Sehen, was der Client kann (Workouts, Likes, Kommentare, Aufzeichnung, Ausrüstung)	Benutzerüberblick
Ein vergessenes Passwort zurücksetzen (wenn der Betreiber E-Mail aktiviert)	Überblick — Anmeldung und Passwort-Reset
Anmelden / registrieren, wenn die Instanz Captcha aktiviert	Überblick — Anmeldung und Passwort-Reset
Grom im Browser nutzen (gleiche UI wie Android)	Basis-URL des Servers nach der Installation öffnen; siehe Benutzerüberblick
Einen Strava-Export importieren (UI + Importverhalten)	Strava-Massenimport
Health-Sync-Aktivitäten von Google Drive importieren (Android)	Health Sync + Google Drive
API-Token für Skripte und externe Apps erstellen	Grom-API-Token
Mein Konto löschen	Grom-Konto löschen

Administration

Ziel	Seite
Server bauen und starten	Installation und Start
TLS, Speicher, Föderation, Logging, Mailer / Passwort-Reset, Captcha konfigurieren	Konfiguration

Referenz

Thema	Seite
Strava-ZIP-Spaltenzuordnung und Importverhalten	Strava-Massenimport
Health-Sync-Import von Google Drive (Android-Client)	Health Sync + Google Drive
Vollständige annotierte Konfiguration	config.full.yaml
HTTP-API (Swagger UI)	Auf dem laufenden Server: /api/docs/ (z. B. http://localhost:8080/api/docs/); OpenAPI-Quellen unter api/docs/
Datenschutzrichtlinie	Privacy Policy