Table of Contents
- GPS data
- Sports Activities
- Sports Activities page Here you can synchronize activities from the device,
- Sports Activity data synchronization
- Selecting, management and viewing
- Filtering
- Summary statistics
- Sports Activity Detail
- GPX files
- View GPX data
- Not supported features Please be aware that not every detail of the workout
Gadgetbridge allows export of Sports Activities (workouts) recorded with the Amazfit Bip (and maybe few other bands - MB3 has also been tested and works). Many workout types are supported and for outside activities (like Walking, Running, Cycling, ...) that contain GPS data (if the band/watch supports that), a GPX file can be exported to your phone or shared with another Android application. The GPX file also contains Heart Rate data, if it was recorded.
If you have activities synced before August 2020 showing only date information + GPX and if these activities are still on the device, you can re-fetch them to get more information, thanks to new parsing implemented in August 2020. See details here.
GPS data
Gadgetbridge does not provide GPS data for activity tracking. If you think it does provide GPS because Location permission is required, it is not correct. Location permission is required for Bluetooth scanning, because on Android this is considered as a possible way to reveal information about the user's location, please see the explanation here.
So if the band/watch does not have it's own GPS, the recorded Activity will not have GPS in the form of GPX file. Therefore the MB3/4/5... do not have GPS recorded with their "Workout" or "Sports" recorded activities, but you can use external sports tracking app and some dedicated features of Gadgetbridge and the link the GPX to your Sports Activity, see details below.
Some watches that do have GPS are for example the Amazfit Bip and they do contain GPS track in the recorded Sports activities.
Sports Activities
Use the running man icon 
in the device card to open the Sports
Activities page:
Sports Activities page Here you can synchronize activities from the device,
view them and also delete.
Sports Activity data synchronization
Syncing is always manual and it is not part of the automatic syncing. This allows you to sync tour activities when you need (rather then when the app decides), because it can take quite some time due to their size and the band is not really usable during the sync.
Press the sync floating action button 
or swipe down. Please note that only one workout
will be fetched at a time, you have to sync again to get the next activity
and so on.
Gadgetbridge remembers the time of last synced item so if the workout data is
still in the band/watch (some devices erase it after transfer), you can
re-fetch the data anytime later by using the three dots menu ⋮ → Reset fetch time, setting the time back (to date before this activity happened) and
re-syncing.
Selecting, management and viewing
Tapping on an Activity opens up a detail, long tap allows multiselection and further Delete or Share the GPX file, if the activity contains it. You can also share the GPX later from the Sports Activity Detail page.
Filtering
You can use the Filter icon 
to only show listing of activities you like to see.
Summary statistics
You can see statistics calculation for the listed activities as a first item of
the list. You can also use the Filter icon 
and get
statistics for the filtered activities only.
Sports Activity Detail
This shows details about the activity. If GPX is part of the activity, it can be shared. There is a hidden function here: if you long tap on the activity icon, the values will switch from recalculated (for example min/km) to raw, as provided by the band (for example sec/m). This is useful for troubleshooting.
You can edit Name of the activity by tapping the pencil icon 
.
GPX files
GPX files can be found in in the files folder
android/data/nodomain.freyourgadget.gadgetbridge/files along with log files.
The prefix is "gadgetbridge-track-" followed by the date/time.
If you like to make a GPS record of your activity, you can also use another sports tracking app and utilize some dedicated Gadgetbridge features that make integration nicer. This allows to utilize the Activity tracking on the watch with some addition details and processing, like number of steps or strokes and so on.
This now offers a new possibility to link a GPX file to a sports activity that did not even allow to have a GPS recording in the first place - like outdoor rowing while using the rowing machine recording or pool swimming (if you have a waterproof phone).
Some activities that you can record without GPS (and make some sense to have GPS linked) include Workout, Outdoor running, Outdoor walking, Treadmill, Freestyle, Indoor cycling, Rowing machine, Pool swimming. These of course must exist in the band/watch, which depends on the watch version.
To link a GPX to an activity, you must either manually copy the GPX file to the files folder or you can use the Share icon in the sports tracking app and use the Gadgetbridge GPX Receiver, which will copy the file to the files folder.
Sharing a file:
This will open Gadgetbridge GPX Receiver, confirm OK.
Existing files overwriting is also indicated:
Link recorded GPX with the Gadgetbridge Sports Activity
In Gadgetbridge, open recorded Sports Activity
Edit GPX track
Select the track
Confirm
GPS track is now added
See a dedicated post on our blog and see also a full manual of Integrating Sports Tracking apps with Gadgetbridge Sports Activities/Workouts on how to set this up.
View GPX data
You can view the GPX file with for example these FLOSS applications:
-
on mobile:
- OpenTracks
- OSM Dashboard for OpenTracks
- OSM Dashboard Offline for OpenTracks
- FitoTrack (not via sharing icon, but by using import function in FitoTrack)
- Another Android Tracker (seems like more precise representation of time and distance, calculates calories)
- osmAnd+
- Milkha
-
on desktop:
- GPXSee (shows also heart rate if included in the file)
Not supported features Please be aware that not every detail of the workout
is currently being stored in Gadgetbridge. Also, interpreting the data is a challenge, if you spot an issue, try to figure out what the correct representation might be and please report.
General
- Home
- ReadMe
- Configuration
- Notifications
- ChangeLog
- Widget
- Weather
- Data Backup
- Pairing
- Permissions Explained
Sports/Activities
- Sports Activities Workouts
- Activity Sessions List
- Activity and Sleep Charts
- Heartrate measurement
- GPS recording of sports activities
- Integrating Sports Tracking apps with Gadgetbridge Sports Activities/Workouts
Device Related
Full list of supported devices
Development
- How to Release
- Developer Documentation
- BT Protocol Reverse Engineering
- Support for a new Device
- New Device Tutorial
- Translating Gadgetbridge
Feature Discussion
FAQ
