CRAWLFIT

CONNECTION PROTOCOL / FIELD MANUAL

Connect your activity to the crawl.

CrawlFit requires Android 10 or newer and Health Connect. Your watch or phone's fitness app must write supported activity to Health Connect before CrawlFit can read it.

ANDROID VERSION CHECK On Android 14 and newer, Health Connect is part of Android Settings. On Android 13 and earlier, install or update the separate Health Connect app from Google Play.

Initial setup

  1. Make sure the fitness app paired with your watch or phone is recording activity.
  2. In that fitness app, enable its Health Connect connection and allow it to write the activity types you want.
  3. Open CrawlFit, choose your tracker route, and grant the requested Health Connect read permissions.
  4. Complete CrawlFit's connection check. Permission alone is not enough; setup completes after supported activity is visible through Health Connect.
  5. Choose whether to allow background access. Without it, opening CrawlFit or using refresh still updates activity.

If no activity appears

Find where the records stop before changing permissions or reinstalling:

  1. Missing in your fitness app? Finish syncing your watch with its own app first. CrawlFit cannot repair that connection.
  2. In the fitness app, but missing in Health Connect? Check that app's Health Connect sharing and write permissions for Steps or Exercise. A connected watch alone is not enough.
  3. In Health Connect, but missing in CrawlFit? Check CrawlFit's read permissions, open it and refresh, then run its connection check in Settings.

Connection checklist

  • Open Health Connect and confirm both the fitness app and CrawlFit have the expected permissions.
  • Confirm recent Steps or Exercise records from the fitness app are visible in Health Connect.
  • Open the fitness app and let it finish syncing the watch before refreshing CrawlFit.
  • On Android 13 or earlier, confirm the separate Health Connect app is installed and current.
  • In CrawlFit Settings, run the connection check and use Share diagnostics if support asks for it.

Do not grant CrawlFit heart-rate, calorie, elevation, floor, blood-oxygen, location, or exercise-route permissions. The current app does not request them.

Saves and recovery

Choose a save folder in CrawlFit Settings if you want progress to survive uninstall or data clearing. CrawlFit writes automatic snapshots and manual save points through Android's file picker. A cloud-storage provider may sync that folder under its own terms.

During a fresh installation, use the restore-first Load option before starting replacement progress. Clearing app data or uninstalling removes the local database but does not necessarily remove saves stored in the folder you chose.

Still stuck?

Email crawlfitdev@gmail.com. Include your phone model, Android version, fitness app, and what the connection check reports.

Review any generated diagnostic email before sending it. Do not attach private screenshots or health records unless you intentionally choose to share them.