widpedom 0.23: Allow tapping on the widget to disable step counting (2v29+ needed) - also add readme

Author: gfwilliams

apps/widpedom/ChangeLog

@@ -22,3 +22,4 @@
 0.20: Fix issue where step count would randomly reset
 0.21: Memory usage improvements, fix widget initial width (fix #1170)
 0.22: Fix 'stps' regression for 0.21 (fix #1233)
+0.23: Allow tapping on the widget to disable step counting (2v29+ needed)

apps/widpedom/README.md

@@ -0,0 +1,18 @@
+# Pedometer widget
+
+Daily pedometer widget that can display steps in large/small size, and also your progress towards a step goal.
+
+## Usage
+
+Once installed, the pedometer will display the step count in the top left of the watch (when widgets are displayed)
+
+On 2v29 and later firmwares, tapping on the widget with the watch unlocked will make it buzz and cause the steps to go grey, which will disable step detection. Tapping again will re-enable it.
+
+## Settings
+
+This app has a settings screen (under `Settings -> Apps -> Pedometer widget`)
+
+* `Daily Goal` - set how many steps your goal for the day is. The Bangle will buzz when the goal is reached.
+* `Show Progress` - show progress towards the step goal in the widget bar
+* `Large Digits` - show large digits for the step counter rather than small ones
+* `Hide Widget` - don't show the widget. Normally in this case we'd suggest just uninstalling the widget, but keeping it installed but hidden will allow the Bangle to buzz when your step goal is reached.

apps/widpedom/metadata.json

@@ -1,12 +1,13 @@
 {
   "id": "widpedom",
   "name": "Pedometer widget",
-  "version": "0.22",
-  "description": "Daily pedometer widget",
+  "version": "0.23",
+  "description": "Daily pedometer widget that can display steps in large/small size, and also your progress towards a step goal.",
   "icon": "widget.png",
   "type": "widget",
   "tags": "widget",
   "supports": ["BANGLEJS","BANGLEJS2"],
+  "readme": "README.md",
   "storage": [
     {"name":"widpedom.wid.js","url":"widget.js"},
     {"name":"widpedom.settings.js","url":"settings.js"}

apps/widpedom/widget.js

@@ -5,6 +5,7 @@
   var lastStepCount;
   let stp_today = 0;
   let settings;
+  let stepDisabled = Bangle.getOptions().stepCounterDisabled; // 2v29+
 
   function loadSettings() {
     const d = require('Storage').readJSON("wpedom.json", 1) || {};
@@ -109,6 +110,7 @@
         }
         g.reset();
       }
+      if (stepDisabled) g.setColor("#888"); // dim down step count
       if (settings.large) {
         g.setFont("6x8",2);
         g.setFontAlign(-1, 0);
@@ -141,4 +143,14 @@
     delete pedomData;
   }
   WIDGETS["wpedom"].width = WIDGETS["wpedom"].getWidth();
+  if (!settings.hide) Bangle.on("touch", (_,e) => { // allow disabling steps on tap
+    if (!e || WIDGETS["back"]) return; // ignore taps if back widget shown - it's too close
+    let w = WIDGETS["wpedom"];
+    if (w._draw || e.y<w.y || e.y >= (w.y+24) || e.x<w.x || e.x>(w.x+w.width)) return; // ignore out of bounds or if hidden (w._draw set)
+    if (stepDisabled===undefined) return; // 2v28 or before, disable steps not supported
+    Bangle.buzz(50); // feedback
+    stepDisabled = !stepDisabled;
+    Bangle.setOptions({stepCounterDisabled:stepDisabled}); // 2v29
+    w.draw();
+  });
 })()