DataFields: RunnersField

Former Member
Former Member
# RunnersField / BikersField
These are free Data Fields for the Fenix 3 that show multiple values on a single field.
RunnersField and BikersField are open source and their code resides at github: https://github.com/kopa/RunnersField and https://github.com/kopa/BikersField

If anyone wants to contribute or report bugs please head over to RunnersField@github or BikersField@github.
The code is licensed with the MIT License. So anyone can do what he/she wants with the code.

Release versions are published in the Garmin App Store

## Features RunnersField
* TIME: 12/24h mode based on system settings.
* PACE: pace in km/min or mi/min based on system settings (as average of the last 10 values).
* AVG PACE: average pace over the whole activity.
* DISTANCE: elapsed distance in km or miles based on system settings.
* DURATION: duration of the activity in [hh:]mm:ss
* GPS: green/blue bars for poor/acceptable/good signal, gray if no signal.
* battery: visualization of battery percentage as indicator bar.
If battery value is lower than 30 the indicator bar gets orange. If value is lower than 10% the exact value will be shown and the indicator bar turns red.
* unit system in use: "(km)" will be shown when metric system is set in the settings, "(mi)" if statute (imperial) units are configured.
* use bright or dark color scheme based on the background color setting of the app (Settings/Apps/Run/Background Color).
needs at least a firmware with SDK 1.2 compatibility (otherwise bright scheme is always used).

## Features BikersField
* TIME: 12/24h mode based on system settings.
* SPEED: speed in km/h or mi/h based on system settings (as average of the last 10 values)
* AVG SPEED: average speed over the whole activity.
* DISTANCE: elapsed distance in km or miles based on system settings.
* DURATION: duration of the activity in [hh:]mm:ss
* GPS: green/blue bars for poor/acceptable/good signal, gray if no signal.
* battery: visualization of battery percentage as indicator bar.
If battery value is lower than 30 the indicator bar gets orange. If value is lower than 10% the exact value will be shown and the indicator bar turns red.
* unit system in use: "(km)" will be shown when metric system is set in the settings, "(mi)" if statute (imperial) units are configured.
* use bright or dark color scheme based on the background color setting of the app (Settings/Apps/Run/Background Color).
needs at least a firmware with SDK 1.2 compatibility (otherwise bright scheme is always used).

## Install Instructions
A Data Field needs to be set up within the settings for a given activity (like Run)

* Long Press UP
* Settings
* Apps
* Run
* Data Screens
* Screen N
* Layout
* Select single field
* Field 1
* Select ConnectIQ Fields
* Select RunnersField
* Long Press Down to go back to watch face

## Usage
Start Run activity.
Hopefully you see the RunnersField datafield.

## Changelog 1.2.3
* fix app name

## Changelog 1.2.2
* fix colorscheme background detection

## Changelog 1.2.1
* change battery critical color


## Changelog 1.2.0
* Use bright/dark color scheme based on app background color settings
* Add german language file


## Changelog 1.1.1
* Further improve memory footprint

## Changelog 1.1.0
* Redesign
* Improve memory footprint

## Changelog 1.0.2
* Fix when black background is configured in device settings.
* Add battery percentage if < 10% left and make visualization red.
* Fix irrelevant slow pace values
* Change string TIMER to DURATION
* Change string metric to km and statute to miles

## Changelog 1.0.1
* Time mode is now dependent on device settings (12/24 hours mode)
* Distance and pace will be presented dependent on device settings (metric [km, km/min] or statute [miles, miles/min]), "metric" or "statute" will be shown below battery/gps
* HR is now dark red to visually decipher the different values faster

## Changelog 1.0.0
* Time of day
* Current Pace (average over 10 seconds)
* Average Pace
* Heart Rate
* Distance
* Timer
* Battery Status
* GPS Status (green = gps lock, red = no gps lock)
  • Former Member
    Former Member over 9 years ago
    Any plans to release for the 230/235/630? This field is fantastic for the Fenix3 and would love to be able to use it on the 235!


    It is hight on my todo list. But as I only work on the code if I have some spare time. So it could take some time ;-)
    If someone else would like to work on it in the mean time, the code is on github. I would be delighted if anyone is willing to contribute.
  • Former Member
    Former Member over 9 years ago
    Thanks!
    What do you think: should I drop average speed (or current speed) and add cadence instead? Or should I try to find a place for the cadence on the screen?
    I am not really sure where to add it.


    Hi, put it between AVG Speed and Duration. Show only one digit after the decimal point. The AVG Speed is not a important value for the actual exercise.
    Same to the actual speed - only one digit after decimal point. Less accuracy is better.

    Hans
  • Former Member
    Former Member over 9 years ago
    I've added some settings and coloration. Not sure if you're interested in any help/ideas (I can send a pull request on github if so) and they're living here at the moment:

    https://github.com/as-j/RunnersField

    Settings works in the simulator, and it's a little rough at the moment, I'm not sure what's available exactly when since the docs are a bit basic. But I like the idea, and I like the idea of making more of the data fields more configurable. For example Hans doesn't like run avg pace, but I find it very useful Easy enough to make a config option.
  • First of all, thank you so much for this great datafield!

    I have a question - is it possible to download from somewhere and install an older (specifically 1.1.1) version? Since the added dark/light versions the datafield feels slow here when switching to another field, with the dark version visible during the sluggish animation even though I use the light one. The 1.1.1 was perfect, would be great to be able to switch back to it.
  • Former Member
    Former Member over 9 years ago
    First of all, thank you so much for this great datafield!

    I have a question - is it possible to download from somewhere and install an older (specifically 1.1.1) version? Since the added dark/light versions the datafield feels slow here when switching to another field, with the dark version visible during the sluggish animation even though I use the light one. The 1.1.1 was perfect, would be great to be able to switch back to it.


    You can find all releases here: https://github.com/kopa/RunnersField/releases

    Konrad
  • Former Member
    Former Member over 9 years ago
    I've added some settings and coloration. Not sure if you're interested in any help/ideas (I can send a pull request on github if so) and they're living here at the moment:

    https://github.com/as-j/RunnersField

    Settings works in the simulator, and it's a little rough at the moment, I'm not sure what's available exactly when since the docs are a bit basic. But I like the idea, and I like the idea of making more of the data fields more configurable. For example Hans doesn't like run avg pace, but I find it very useful Easy enough to make a config option.


    Cool! Thats why I wanted to release it as open source!
    If you want, you can send a pull request and I review the code.

    Thanks Konrad
  • Former Member
    Former Member over 9 years ago
    I have wrote here because I love your Datafield, I just only miss the Average HR data. Nice work I 'll be waiting for the next release with this field.
  • Former Member
    Former Member over 9 years ago
    I have wrote here because I love your Datafield, I just only miss the Average HR data. Nice work I 'll be waiting for the next release with this field.


    Thanks! I will think about it.

    Br Konrad
  • Former Member
    Former Member over 9 years ago
    I've added some settings and coloration. Not sure if you're interested in any help/ideas (I can send a pull request on github if so) and they're living here at the moment:

    https://github.com/as-j/RunnersField

    Settings works in the simulator, and it's a little rough at the moment, I'm not sure what's available exactly when since the docs are a bit basic. But I like the idea, and I like the idea of making more of the data fields more configurable. For example Hans doesn't like run avg pace, but I find it very useful Easy enough to make a config option.


    Hi Stanley,

    I would like to ask you a favor, can you tell me how settings work? I am trying to understand how to make it possible for user to set their own heart rate zone numbers for my Heart rate runner datafield.

    I have downloaded your version of Runnersfield from github and I can see the properties and settings file.
    I also see that you get those settings with for example: paceAvgLen = Application.getApp().getProperty("paceAveraging");

    But I don't see any possibility for me in the emulator to modify the setting as a user??
  • Former Member
    Former Member over 9 years ago
    But I don't see any possibility for me in the emulator to modify the setting as a user??


    In the emulator you can change it by going back to Eclipse and then going to Connect IQ->App Settings Editor and pushing the changes to the emulator.

    Unfortunately at this time you can't test it any further. When you side-load apps you can test settings. This seems a bit nuts, I have to submit apps to the store and just hope it works....