Dokumentation

Grom — ein freies Trainings-Ökosystem: Ihr Server, Ihre Communities, offener Code.

Grom soll ein vollständig freies Ökosystem für Sportlerinnen, Sportler und Ambitionierte sein: Betreiben Sie einen Server für sich oder jede Community, behalten Sie Workouts auf Infrastruktur, die Sie kontrollieren, und tauschen Sie Aktivitäten optional über Föderation zwischen Communities aus. Grom bleibt offen für Integrationen mit verfügbaren Sport-Diensten und Formaten — und als Open Source, damit jede und jeder mitgestalten kann. Ausführlicher: Über das Projekt.

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…

Über das Projekt

Ziel	Seite
Mission und Säulen des Projekts lesen	Über das Projekt

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
Eine öffentliche Instanz in Android wählen oder die eigene listen	Freigegebene Grom-Server
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