GPX Buddy

Help & Support

Everything you need to get the most out of your workouts

📋

Your Workout List

  1. 1 When you open GPX Buddy, you'll see all your workouts in a scrollable list at the bottom of the screen.
  2. 2 Tap any workout to load it on the map above.
  3. 3 Tap again on the selected workout or on the map to open the full detail view with metrics, segments, and more.
  4. 4 Workouts stored in iCloud show a cloud icon — tap them to download before viewing.
💡 Swipe the sheet panel up to three different heights to give yourself more room to browse the list, or to focus on the map.
❤️

Importing Workouts from Apple Health

  1. 1 Tap the + button in the top-left corner of the screen to open the import flow.
  2. 2 If this is your first time, tap Request Health Authorization and grant GPX Buddy access to your workouts.
  3. 3 Use the date picker to choose how far back you want to look, and the activity type picker to filter by sport (running, cycling, hiking, etc.).
  4. 4 Tap the map icon to preview them on the map, or tap the checkbox to select them for import.
  5. 5 Once you've made your selection, tap the Import button. You can cancel at any time while the import is running.
  6. 6 Toggle Show Imported to see workouts you've already brought in (they'll show a checkmark badge).
✦ GPX Buddy Pro unlocks workouts older than 30 days. Free users can only import from the past 30 days. Upgrade in Settings → Upgrade to Pro.
💡 Enable Auto Import in Settings to have GPX Buddy automatically pull in new workouts as you complete them — no manual steps needed!
🗺️

Viewing a Workout on the Map

  1. 1 Tap any workout in the list — the map will zoom to fit the entire route automatically.
  2. 2 Pinch to zoom and drag to pan the map freely. Direction arrows along the route show which way you were going.
  3. 3 Tap the viewfinder icon (on the right side of the map) to re-center the view on your route at any time.
  4. 4 Tap the location icon to show your current GPS position on the map alongside the route.
  5. 5 In the detail view, use the segment navigator (← →) to step through each segment and see it highlighted on the map.
💡 Tap a segment in the Segments list to jump straight to it on the map and see its individual pace and stats. Long-press a segment to export it into a GPX file.
✦ GPX Buddy Pro unlocks custom segment lengths (1 km / 2 km) so you can analyze your workout in even finer detail.
🔍

Searching & Filtering Workouts

  1. 1 Use the search bar at the top of the list to instantly find workouts by name, distance, or label.
  2. 2 Tap the filter icon next to the search bar to open the Filters panel.
  3. 3 In the Filters panel you can:
    • Set a date range to show only workouts within a period
    • Filter by one or more activity types (running, cycling, hiking…)
    • Set a distance range with the min/max sliders
    • Filter by color labels you've assigned to workouts
    • Switch between All / Favorites / Labeled modes
  4. 4 Tap Clear Filters to reset everything and see your full workout list again.
📁

Managing Workouts

  1. 1 Long-press any workout in the list to open a context menu with all management options.
  2. 2 Rename — Give your workout a more memorable name. A dialog appears with the current name pre-filled.
  3. 3 Favorite — Tap Favorite On to flag a workout so you can filter to it quickly. Tap the heart icon in the toolbar when a workout is open to toggle it too.
  4. 4 Labels — Assign a color label to tag and group workouts visually. Tap Labels in the context menu and pick a color.
  5. 5 Move to iCloud / Move to Device — Keep your workouts in iCloud to save local storage, or move them to your device for offline access.
  6. 6 Adjust Date — Fixes the file's creation date to match the actual workout date stored in the GPX file.
  7. 7 Delete — Permanently removes the workout. You'll be asked to confirm before anything is deleted.
  8. 8 Alternatively, swipe left on a workout row to reveal a quick delete button.
📤

Sharing & Uploading to Strava

  1. 1 Share a GPX file: Long-press a workout → tap Share. The system share sheet lets you send the file via AirDrop, Messages, email, or any other app.
  2. 2 Connect Strava: Go to Settings → Social Networks and tap the Strava button. Follow the sign-in steps to authorize GPX Buddy.
  3. 3 Upload a single workout: Long-press a workout → tap Upload to Strava. An upload panel will show progress and confirm success.
  4. 4 Disconnect Strava: Go to Settings → Social Networks and tap the Strava button again to log out.
💡 Enable Auto Upload in Settings to automatically send new workouts to Strava as soon as they're imported — great for a hands-free workflow.
🎨

Customizing the Route

  1. 1 Change map style: Tap the map icon on the right side of the map and choose between Standard, Satellite, Hybrid, or Muted.
  2. 2 Change route color: Tap the waveform/gradient icon → select None for a solid color, then pick any color from the color picker. ✦ Pro
  3. 3 Pace gradient: Tap the gradient icon → select Pace. The route will be colored from fast (cool tones) to slow (warm tones) so you can spot where you slowed down. ✦ Pro
  4. 4 Elevation gradient: Select Elevation from the gradient menu to color the route by altitude — perfect for spotting hills and descents. ✦ Pro
  5. 5 Heart Rate gradient: Select Heart Rate to visualize workout intensity along the route (requires a heart rate-enabled device). ✦ Pro
  6. 6 You can set a default gradient and color in Settings so every workout opens with your preferred look.
✦ Route color and all gradient modes require GPX Buddy Pro. Upgrade in Settings → Upgrade to Pro to unlock the full palette.
▶️

Route Replay ✦ Pro

  1. 1 Open a workout's detail view by tapping it in the list.
  2. 2 Tap the Play button in the toolbar to start replaying your route. A dot will travel along the path, recreating your workout in real time.
  3. 3 Use the speed stepper (+ / − buttons) to adjust the replay speed from 1× all the way up to 20×.
  4. 4 Tap the Stop button to end the replay at any time.
✦ Route Replay is a Pro feature. Upgrade in Settings → Upgrade to Pro to relive your workouts.
🤖

AI Workout Insights ✦ Pro

  1. 1 Open a workout's detail view and scroll down to the Insights section.
  2. 2 Tap Generate Insight. GPX Buddy will analyze your pace, elevation, heart rate, and segments using AI.
  3. 3 The insight appears as a short, friendly summary highlighting your performance, effort level, and interesting moments in the workout.
  4. 4 To remove an insight, tap the delete icon and confirm. You can always regenerate it later.
✦ AI Insights require GPX Buddy Pro. Upgrade in Settings → Upgrade to Pro to get personalized analysis for every workout.
✅

Bulk Actions

  1. 1 Tap Edit in the list toolbar to enter selection mode. Checkboxes will appear next to each workout.
  2. 2 Tap the checkboxes to select as many workouts as you like.
  3. 3 A toolbar appears with bulk actions:
    • Labels — Apply a color label to all selected workouts
    • Favorite / Unfavorite — Toggle favorites in bulk
    • Download / Remove Download — Manage local vs. iCloud copies
    • Share — Share all selected GPX files at once
    • Upload to Strava — Batch upload to social media
    • Move to Cloud / Move to Device — Reorganize storage
    • Adjust Dates — Fix creation dates for all selected
    • Delete — Remove all selected (with confirmation)
  4. 4 Merge — Select 2 or more workouts and tap Merge to combine them into a single GPX file. ✦ Pro
✦ Merging workouts requires GPX Buddy Pro. All other bulk actions are available to everyone.
⚙️

Settings & Preferences

  1. 1 Tap the gear icon in the top-right corner of the workout list to open Settings.
  2. 2 Metric / Imperial — Toggle between kilometers and miles to match your preference.
  3. 3 Haptic Feedback — Turn on or off the subtle vibrations that accompany button taps.
  4. 4 Auto Import — When enabled, GPX Buddy will automatically import new workouts from Apple Health as soon as they're recorded.
  5. 5 Body Weight — Enter your weight so GPX Buddy can include it in workout calculations.
  6. 6 Default Map Type — Choose whether new routes open on a Standard, Satellite, or Muted map by default.
  7. 7 Default Gradient — Set the default gradient mode (None, Pace, Elevation, Heart Rate) applied when you open any workout. ✦ Pro
  8. 8 Auto Upload — Automatically push new workouts to Strava as they're imported, when you have a connected account.
📱

Widgets ✦ Pro

  1. 1 Long-press your iPhone or iPad Home Screen until icons start wiggling, then tap the + button in the top-left corner.
  2. 2 Search for GPX Buddy in the widget gallery.
  3. 3 Choose from three widget types:
    • Last Workout Map — A snapshot of your most recent route (small or large)
    • Distance Over Time — A bar chart of recent workout distances (medium)
    • Duration Over Time — A bar chart of recent workout durations (medium)
  4. 4 Tap the widget to jump straight into GPX Buddy. Data refreshes automatically after each import.
💡 Widgets update automatically after you import a new workout, so your Home Screen always shows your latest activity.

Still need help?

We're happy to hear from you! If something isn't working as expected or you have a suggestion, drop us a message — we read every one.

Email: gpxbuddy@icloud.com

You can also review our Terms and Conditions.

↑