Skip to content

M-Yankov/TelemetryExporter

Repository files navigation

Telemetry Exporter

Export telemetry data (frames) from Garmin activity.
Since Garmin Virb is not so usable, this program will replace part of its functionality related to exporting the png overlays.
Although this project gives opportunity to develop any kind of widget, depends on demands

presentation.mp4

Usage

Check the video below for detailed usage:
Usage

Download

  • Go to Releases page and download the latest
  • No need install
  • Extract .zip contents
  • Open TelemetryExporter.UI.exe

For now only Windows 10, 11 is supported (MacOS could be added in future, but may need help)

User data privacy

  • This program doesn't use any personal data
  • This program doesn't share data to 3-rd party service
  • This program doesn't require registration
  • It's free and open-source, the owner (developers, contributors) doesn't take responsibility for any malfunctions caused by the bugs
  • Using this program is at your own risk

Usage

  • You need the .fit file activity from Garmin device or downloaded from their website (https://connect.garmin.com/)
  • Open Telemetry Exporter and select the .fit file
  • In Telemetry Exporter configure the settings you want and select widgets
  • Click Export and take a coffee :)

Detailed description

  • In the first page you need to enter the .fit file from Garmin
  • After loading the file, the second page with settings appears
  • The settings: settings-1
  1. The elevation profile (calculated from active time)
  2. The activity range (showing total elapsed time)
    • Consist of two black sliders (start/end)
      • Move this slider smoothly, they are buggy
    • The blue area is the selected area for export
    • the thin red lines indicates paused intervals
  3. The start and end of the sliders - local datetime
    • The dates blinks in green background when ranges sliders moved (if not, try move sliders again), green background indicates the value of the slider is saved.
  4. Start/end since beginning (00:00:00 default for start) (default for end is the duration of the activity)
  5. Distance and duration of the selected range

More settings:
Settings-2

  1. The frames per second
    • It's highly recommended to use lower value here, because of duplicated frames. 60 will generate a lot of duplicated frames which is unnecessary. Later in the video-editing program change the duration of the imported frames 2fps = 500ms, 4fps = 250. In general duration = 1000 / fps
  2. This checkbox will threat the left marker as beginning of the activity
    • It's good when you want to show a part from your activity

Widgets:
Settings-3

  1. Each category is expandable where widgets can be selected
  2. ?
  3. Browse save location, final result is zip archive with name in GUID format (152a22da-d19e-4b87-bd85-153f9a0f3633.zip), default location is desktop
  4. The export button initiating the process of generating frames
  5. With the Cancel button generation of frames can be stopped
  6. The status of overall export process
  7. Each widgets reports its progress (this could be removed in future)

Widgets selection:
Settings-4 Each category may contain one or more widgets presented with an example image. To select widget click the checkbox below the widget.

At least one widget needs to be selected.

Development

  • Visual Studio 2022 (or newer) with installed tools for MAUI development
  • img
  • Set-up TelemetryExporter.UI as start-up project
  • Hit F5 to run te project
  • .NET 8 with C# 12

Checkout more info about Getting started with MAUI and Visual Studio 2022 MAUI release

Contribution

  • It's absolutely free for anyone to open PRs with fixes or new functionality
    • If need help use Discussion tab
  • For problems and bugs use Issues page

Technical info:

In case of error, this temporary directory contains generated frames:

C:\Users\<your-user-name>\AppData\Local\M-Yankov\com.telemetryexporter\Cache

Contents can be safety deleted.

Future

  • More widgets will be added (from garmin virb)
  • Each widget could have separate settings (size, font, color scheme etc.)
  • More configuration settings will be added, check Issues
  • integrating map layers as navigation
  • quick fixes
  • Possibility to set exact start/end times (to second)
  • The MAUI seems not a stable technology for extensibility, may try something different in future