Merge branch 'espruino:master' into Weather-Feels-Like-Updates

Author: RKBoss6

apps/backlite/ChangeLog

@@ -0,0 +1,2 @@
+0.01: New app! (settings, boot.js).
+0.02: Fix settings defaulting brightness to 0

apps/backlite/README.md

@@ -0,0 +1,20 @@
+# BackLite
+### This app needs the latest settings app update (v 0.80), to ensure that setting the brightness to `0` does not default to `1`.
+
+BackLite is an app which greatly conserves battery life by only turning the backlight on when you long press the button from a locked state.
+
+Modern watches have a dedicated button to turn the backlight on, so as not to waste battery in an already light environment. This app recreates that functionality for the Bangle.js, which only has one button.
+
+#### Warning: This app overwrites the LCD brightness setting in `Bangle.js LCD settings`. If it is changed, the app will basically lose functionality. It auto-fixes itself every boot, so if you change the brightness, just reboot :)
+# Usage
+When you unlock with a press of the button, or any other way you unlock the watch, the backlight will not turn on, as most of the time you are able to read it, due to the transreflective display on the Bangle.js 2. 
+
+If you press and hold the button to unlock the watch (for around half a second), the backlight will turn on for 5 seconds - just enough to see what you need to see. After that, it will turn off again.
+
+Some apps like `Light Switch Widget` will prevent this app from working properly.
+# Settings
+`Brightness` - The LCD brightness when unlocked with a long press.
+# Creator
+RKBoss6
+
+TODO: Add a setting for long press time, or light duration

apps/backlite/boot.js

@@ -0,0 +1,36 @@
+{
+  let getSettings = function(){
+    return Object.assign({
+      // default values
+      brightness: 0.3,
+
+    }, require('Storage').readJSON("BackLite.settings.json", true) || {});
+  };
+
+  
+  //Set LCD to zero every reboot
+  let s = require("Storage").readJSON("setting.json", 1) || {};
+  s.brightness = 0;
+  require("Storage").writeJSON("setting.json", s);
+  //remove large settings object from memory
+  delete s;
+  const longPressTime=400; //(ms)
+
+  Bangle.on('lock', function(isLocked) {
+    Bangle.setLCDBrightness(0);
+
+    if (!isLocked) {
+      // Just unlocked — give a short delay and check if BTN1 is still pressed
+      setTimeout(() => {
+        if (digitalRead(BTN1)) {
+          //set brightness until. locked.
+          Bangle.setLCDBrightness(getSettings().brightness);
+        } else {
+          Bangle.setLCDBrightness(0);
+        }
+      }, longPressTime); // Slight delay to allow unlock to settle
+    }
+  });
+
+}
+

apps/backlite/icon.png

@@ -0,0 +1,17 @@
+{
+  "id": "backlite",
+  "name": "BackLite",
+  "version": "0.02",
+  "description": "Conserves battery life by turning the backlight on only on a long press of the button from a locked state. **Requires the latest settings update (v0.80)**",
+  "icon": "icon.png",
+  "type": "bootloader",
+  "tags": "system",
+  "readme": "README.md",
+  "supports": ["BANGLEJS2"],
+  "storage": [
+    {"name":"backlite.boot.js","url":"boot.js"},
+    {"name":"backlite.settings.js","url":"settings.js"}
+    
+  ],
+  "data": [{"name":"BackLite.settings.json"}]
+}

apps/backlite/metadata.json

@@ -0,0 +1,25 @@
+(function(back) {
+  var FILE = "BackLite.settings.json";
+
+  var settings = require("Storage").readJSON(FILE, 1) || {};
+  
+  if (!isFinite(settings.brightness)) settings.brightness = 0.3;
+
+  function writeSettings() {
+    require("Storage").writeJSON(FILE, settings);
+  }
+
+  E.showMenu({
+    "" : { "title" : "BackLite" },
+    "< Back": back, // fallback if run standalone
+    "Brightness": {
+      value: settings.brightness,
+      min: 0.1, max: 1,
+      step: 0.1,
+      onchange: v => {
+        settings.brightness = v;
+        writeSettings();
+      }
+    },
+  });
+})

apps/backlite/settings.js

@@ -0,0 +1,4 @@
+0.01: It works somehow, early version for testers and feedback :)
+0.02: Changed almost all code with Frederic version of Pong and adjusted to be a BrickBreaker!, still Alpha
+0.03: Rewrote the whole thing to have less code and better graphics, now it works.
+0.04: Rewrote part of the code to coupe with the flickering and added better logic to handle the graphics.

apps/bbreaker/ChangeLog

@@ -0,0 +1,28 @@
+# BrickBreaker
+
+A simple BreakOut clone for the Banglejs
+
+![Screenshot](bbreaker.png)
+
+## Usage
+
+![Screenshot](playing.png)
+
+Buttons 1 and 3 to move the BrickBreaker!
+
+Button 2 to pause and start the game again.
+
+## Disclaimer
+
+This game was created to learn JS and how to interact with Banglejs, meaning that it may not be perfect :).
+
+Built with love with base on the tutorial: 2D breakout game using pure JavaScript
+https://developer.mozilla.org/en-US/docs/Games/Tutorials/2D_Breakout_game_pure_JavaScript
+
+Started on 2020 but rewrote all in 2025 and this is the version I got without having issues with Memory Exhaustion.
+
+And yes, for Bangle 1, old school!
+
+## Creator
+
+Israel Ochoa <isuraeru at gmail.com>