A precision GPS workout tracker for iPhone and Apple Watch with Kalman-filtered location, HealthKit sync, Live Activities, CarPlay, and full route analytics.
- Start, pause, resume, and stop workout sessions with a single tap
- Choose activity type: Walking, Running, Cycling, Hiking, Flight, or General
- Real-time metrics: distance, speed, GPS-derived acceleration, device-motion acceleration with X/Y/Z components, pitch/roll/yaw attitude, rotation rate, compass heading, GPS quality, altitude, barometric climb/descent, pressure, calories, heart rate
- Scrollable live data log showing raw GPS coordinates, accuracy, and Kalman filter state
- Live signal quality indicator (0-4 bars) with horizontal accuracy readout
- GPS quality score (0-100) saved with each workout so weak tracks are easier to diagnose; the score now considers accuracy, stale timestamps, long update gaps, filtered fixes, and estimated fallback points
- Built-in Kalman filter reduces GPS noise for smoother, more accurate routes
- Three sensitivity levels: Low, Medium, High (configurable in Settings)
- Raw GPS mode available for unfiltered data
- Activity-specific speed and acceleration thresholds reject impossible readings
- iPhone Core Motion records gravity-removed acceleration, attitude, rotation, compass heading, and movement-direction acceleration; Watch workouts receive lightweight iPhone motion assist data without starting Watch device-motion tracking
- iPhone motion assist can relax GPS acceleration-spike filtering when GPS direction and iPhone forward/horizontal acceleration agree, improving tolerance for real starts/stops
- Estimated-location fallback marks low-confidence route points during GPS gaps: iPhone projects from the last real GPS fix using heading and conservative acceleration/speed integration; Apple Watch uses pedometer distance plus iPhone-relayed direction, without starting Watch Core Motion
- Automatic WiFi/cellular fallback when GPS signal is lost
- GPS reconnection logic with 5-second timeout detection
- Speed graph with 10-second rolling average
- Acceleration graph with peak acceleration/deceleration detection
- Device motion graphs from gravity-removed iPhone Core Motion data, with live values and separate saved charts for
$a$,$a_x$,$a_y$,$a_z$, pitch, roll, yaw, rotation rate, and compass heading - Altitude graph tracking elevation changes
- Barometric climb graph with climb/descent rate from CMAltimeter
- Pressure graph from the device barometer (when available)
- GPS quality graph showing confidence over time
- Animated playback of any recorded route on a map
- Variable speed: 1x, 2x, 4x, 8x
- Timeline scrubber with elapsed time and progress
- Start and end markers on the map
After stopping a session, a full summary is presented:
- Route plotted on a static map
- Total distance, duration, average/max speed, max acceleration, motion acceleration, GPS quality, max altitude, barometric climb/descent, calories
- Heart rate stats (average and max, when tracked)
- Kilometer splits with pace and heart rate per split
- Route quality report: total points, valid points, signal coverage %, average accuracy
- Sensor report: motion acceleration, GPS quality score, barometric climb/descent, and max climb/descent rate when supported
- Effort rating (RPE): 1-10 slider saved to HealthKit
- Browse all saved workouts with route maps
- Filter by activity type
- Sort by date, distance, or duration
- Resync individual or all workouts back to HealthKit
- Tap any workout for full details
- Dedicated Map tab with a full Apple Map view
- Shows all saved workout tracks for the selected time period
- Time filters: All, 3 Months, Week, or Custom date range
- Load refreshes local saved workout tracks without touching the Flights tab
- Download All imports HealthKit workout routes into local storage for the Map tab
- Select an individual track to highlight it and zoom to that route, or tap near a route line on the map to show that workout's date
- Visual-only Align Roads button redraws workouts with rate-limited Apple Maps route segments without changing saved workout data; route segments are accepted only when they stay close to the recorded GPS path, and unsupported or low-confidence segments stay on raw GPS
- Daily distance chart for any selected month
- Yearly distance chart showing monthly totals
- All Time mode uses a Plotly-style monthly/cumulative chart from the first workout month through the current month, with optional year filters such as 2026, 2025, and 2024 that switch the graph to day-by-day values with a cumulative toggle
- Filter by workout type
- Month-over-month and year-over-year comparisons
- Auto-save workouts, routes, distance, energy, cadence, steps, and sensor summary metadata to Apple Health
- Heart rate recording during sessions
- Full route export as HealthKit workout routes
- Manual resync with effort rating updates
- Read back workout history from HealthKit
- Export any workout route as a standard GPX file
- Share via AirDrop, email, or cloud services
- Accessible through the iOS Files app
- Full standalone watch app with live tracking
- Real-time metrics, maps, signal quality, iPhone-assisted scalar motion acceleration, GPS quality, and climb rate on-wrist
- Syncs sessions and data with iPhone via WatchConnectivity
- Workout history and replay available on watch
- Lock screen workout status with live timer, distance, and speed
- Dynamic Island compact and expanded views
- Heart rate display when available
- Persists even when the app is backgrounded
- At-a-glance workout status and metrics
- Monthly distance chart
- Year-over-year analytics
- Tap to jump into the app
- "Start Walking Workout", "Start Running Workout", etc.
- "Stop Workout", "Pause Workout", "Resume Workout"
- Natural language feedback with current stats
- Full-screen live route map on the car display
- Auto-tracking camera follows the route
- Stop workout button
- See CARPLAY_README.md for setup details
- Units: km/mi, km/h/mph/knots, meters/feet
- Map style: Standard, Satellite, Hybrid
- GPS filtering: Kalman sensitivity, raw GPS toggle
- HealthKit: auto-save toggle, export type, heart rate toggle
- Permission status cards with quick access to iOS Settings
- macOS with Xcode 16.4+
- iPhone running iOS 18.5+ (physical device recommended)
- Apple Watch running watchOS 11.5+ (optional)
- Open
GPS location app.xcodeprojin Xcode. - Set your Development Team in Signing & Capabilities.
- Select the GPS location app scheme and your device.
- Build and run.
- Grant Location, HealthKit, and Motion permissions on first launch.
GPS and HealthKit features require a physical device. Simulator support is limited.
GPS location app/ # iOS app
Models/ # Flight, FlightLocation, FlightMetrics
Services/ # LocationManager, WorkoutSession, HealthKit, WatchConnectivity
Views/ # Graphs, maps, signal quality, metrics
ViewControllers/ # Live session, summary, history, replay, analysis, settings
LiveActivity/ # Lock screen Live Activity
CarPlay/ # CarPlay scene delegate
Shortcuts/ # Siri Shortcuts intents
GPS location app Watch App/ # watchOS companion
Models/
Services/
Views/
ViewControllers/
WorkoutWidget/ # Widget + Live Activity extension
gpslocationapp://live
Opens the live tracking session directly.
This project is provided as-is for personal and educational use.