FIT Files Import

Status: Current implemented behavior. Audience: Users and contributors. Implementation: features/manualentry/activity/routeimport. Navigation: Screen.SettingsDataImport, then Screen.ActivityEntry for review. Related: Feature map, GPX/KML/KMZ route import, Recording of activity, Apple Health import.

FIT import lives in Settings, Data Importers. It lets users bring supported activity, course, and workout files into OpenVitals for review before saving to Health Connect.

What FIT Import Is For

FIT files commonly come from fitness devices and activity platforms. OpenVitals reads the Garmin FIT File Id type and handles Activity, Course, and Workout files differently: completed activities can provide timing, calories, distance, elevation, and optional GPS samples; courses provide route geometry and optional estimated duration; workouts provide structured workout metadata such as name, sport, and supported timed step duration.

Review Before Save

Imported FIT files are not written immediately. The user reviews detected details, adjusts supported fields where needed, and then chooses whether to save the activity to Health Connect.

Relationship To Route Import

FIT uses the same activity review screen as route import after the file is selected from Settings, Data Importers. Unlike plain route files, FIT files do not need GPS route points; OpenVitals imports supported activity, course, or workout details and attaches a route only when usable route samples are present.

Limits

FIT files vary by device and exporter. OpenVitals imports supported fields and leaves unsupported or missing fields out of the saved Health Connect record.