Step sync setup
Step sync setup
Step challenges require a daily step source. The app walks you through this during first launch; you can change it later under Profile → Step source.
Phone-based sources #
| Source | Platform | Notes |
|---|---|---|
| Apple Health | iOS | Reads step data HealthKit already collects |
| Health Connect | Android | Google's health hub (recommended on newer Android) |
| Google Fit | Android | Legacy access in older DistantRace app versions only; not offered to new users |
| Phone pedometer | Android | On-device step counter — keep the app installed and background refresh enabled |
Grant health / activity permissions when prompted. Without them, step totals stay at zero.
Google Health is a separate read-only connection for synchronized health and exercise data. See Supported apps for how it differs from Health Connect and legacy Google Fit.
Watch and partner apps #
You can also count steps from connected sport apps:
- Garmin
- Polar
- Fitbit
- Suunto
- Withings (Health Mate)
Connect the app first under Profile → Partner apps, then select it as your step source. Polar and Suunto may trigger a server pull when you open the step screen.
Changing source later #
- Profile → Step source
- Pick a new provider
- If you chose a sport app that is not connected yet, the app opens the OAuth connect flow and returns you to step setup
On the website you can also change source at /accounts/step_data_source/ — Daily steps on the website.
One primary source
Use only one active step source to avoid double counting the same walks.
Coverage sync (Apple Health / Health Connect) #
The app checks which days still need uploads and sends missing daily totals to DistantRace automatically when you open Home or after background refresh. Older app versions may estimate calories from steps; newer versions send calories and distance from the health store when available.
On Android, allow Health Connect's additional background access when prompted. If you dismiss or deny it, normal foreground sync still works and Home keeps a non-blocking reminder so you can grant access later. You can also grant it directly in Android's Health Connect settings; DistantRace detects the change when it resumes.
Background work is scheduled periodically by Android and can be delayed by battery saving or manufacturer restrictions. It syncs daily steps only—Health Connect workouts are still imported when the app starts, resumes, or you refresh it. A force-stopped app cannot run background work until you open it again.
Troubleshooting #
| Problem | Try |
|---|---|
| Steps stuck at zero | Re-open permissions in phone Settings → DistantRace → Health |
| Android background reminder remains | Open Health Connect → App permissions → DistantRace and allow background/additional access, then return to DistantRace |
| Garmin/Fitbit missing days | Open the sport app to force a sync, then reopen DistantRace |
| Wrong totals after switching source | Wait one full day — do not run two sources at once |
More: Data synchronization troubleshooting.