BangleApps_old/apps/recorder

**# Recorder

This app allows you to record data every few seconds - it can run in background.

Usually you'd record GPS (but this is not required). The data can later be exported as CSV, KML or GPX files via the Download button in the Bangle.js App Store entry for Recorder.

Usage

First run the Recorder app, here you can configure what you want to record, how often, and you can start and stop recordings.

You can record

• Time The current time
• GPS GPS Latitude, Longitude and Altitude
• HR Heart rate and confidence
• BAT Battery percentage and voltage
• Steps Steps counted by the step counter
• Baro (Bangle.js 2) Using the built-in barometer to record Temperature, Pressure and Altitude
• Accel Average acceleration values in X,Y and Z
• Core CoreTemp body temperature if you have a CoreTemp device and the https://banglejs.com/apps/?id=coretemp app installed

You can then start/stop recording from the Recorder app itself (and as long as widgets are enabled in the app you're using, you can move to another app and continue recording). Some apps like the Run app are able to automatically start/stop the Recorder too.

Note: It is possible for other apps to record information using this app as well. They need to define a foobar.recorder.js file - see the getRecorders function in lib.js for more information.

Viewing and Downloading Data

You can download and visualize the information using the App Loader. Connect to your Bangle, then in My Apps click the disk icon next to the Recorder app to access the download interface.

Interactive Web Interface

The download interface provides individual track visualization with:

• Interactive Leaflet maps - Each GPS track gets its own map using OpenStreetMap tiles
• Track statistics - Distance, duration, and track points automatically calculated
• Start/End markers - Green circles mark track start, red circles mark end points
• Interactive track points - Click anywhere along the GPS track to see detailed data at that point
• Data popups - View available data for each point (time, heart rate, altitude, speed, steps, battery, barometer - if recorded)
• Interactive charts - Collapsible graphs for heart rate, battery, steps, elevation, speed, and barometer data with PNG export
• Download options - KML, GPX, and CSV formats for individual tracks or all at once
• Settings - Option to include/exclude entries without GPS coordinates
• Unit preferences - Choose between metric, imperial, or auto-detect based on your locale
• Mobile responsive - Works well on all devices

On-Watch Visualization

You can also view some information on the watch:

• Tap View Tracks
• Tap on the Track number you're interested in, and you'll see a page with information about that track...
  • Plot Map plots a map using GPS coordinates
  • Plot OpenStMap plots a map using GPS coordinates on top of an OpenStreetMap map (if the app is installed)
  • Plot Alt plots altitude over time
  • Plot Speed plots speed over time
  • Plot HRM plots heart rate over time

Usage in code

You can do:

• Call require("recorder").setRecording(true) to start recording (it returns a promise, and may show a menu)
• Call require("recorder").setRecording(true, {force:"new"/"append"/"overwrite") to start recording (it returns a promise, and will not show a menu)
• Call require("recorder").setRecording(false) to stop recording

And check require("recorder").isRecording() to see if we're recording or not.

Recording new items

You can add new data items to record by creating a JS file on the Bangle named ending in .recorder.js that adds a new item to the supplied recorders array. For example foobar.recorder.js could contain:

(function(recorders) {
  recorders.foobar = {
    name : "Foobar",           // Name to appear in UIs
    fields : ["foobar"],       // Column headings to appear as header in recorded CSV data
    getValues : () => [123],   // Columns of data (length should match 'fields')
    start : () => {},          // Called when recording starts - turn on any hardware/intervals you need
    stop : () => {},           // Called when recording stops - turn off any hardware/intervals
    draw (x,y) => {}           // draw 12x12px status image at x,y on g
  }
})

Tips

When recording GPS, it usually takes several minutes for the watch to get a GPS fix. There is a red satellite symbol, which you will see turn green when you get an actual GPS Fix. You can upload assistant files to speed up the time spent on getting a GPS fix.