Skip to content

User Guide

Welcome to the Tempo User Guide! This section covers everything you need to know to use Tempo effectively.

Overview

Tempo is a self-hosted running tracker that helps you track and analyze your workouts. This guide will walk you through all the features and workflows.

Topics Covered

  • Importing Workouts - Import single GPX/FIT workout files
  • Bulk Import - Import your entire Strava history (Settings → Migrate / restore, or onboarding)
  • Viewing Workouts - Explore the dashboard, activities list, and Workout overview
  • Media - Add photos and videos to your workouts
  • Analytics - Understand metrics, statistics, and performance data
  • Settings - Configure preferences, heart rate zones, unit preferences, shoe tracking, export, and migrate/restore

Getting Started

If you're new to Tempo, start with:

  1. Complete first-run onboarding (restore a Tempo export, or set essentials and optionally import Strava)
  2. Importing your first workout (GPX/FIT on the Import page)
  3. Exploring the dashboard
  4. Configuring your settings

Common Workflows

Daily Workout Import

  1. Export a workout file from your device (Garmin, Apple Watch, etc.)
  2. Go to the Import page
  3. Drag and drop your file
  4. View your workout with maps and analytics

Bulk Import from Strava

  1. Request your Strava data export
  2. During onboarding, choose Strava import — or later open Settings → Migrate / restore → Import Strava archive
  3. Upload the ZIP file
  4. Wait for processing to complete
  5. Review imported workouts

Backup and Restore

  1. Navigate to Settings → Export
  2. Click "Export All Data" to create a backup
  3. Store the ZIP file safely
  4. To restore, expand Migrate / restore → Restore Tempo export and upload the export file — watch upload then restore progress (you can cancel; already restored data stays)
  5. Only one import runs at a time (Tempo restore or Strava bulk); then review the import summary

Analyzing Performance

  1. View weekly and yearly statistics
  2. Analyze relative effort trends
  3. Review heart rate zones
  4. Compare workouts over time

Need Help?

If you encounter any issues, check the Troubleshooting section for solutions.