BangleApps/apps/lightswitch
Gordon Williams 2ba72f8954 lightswitch 0.03: Settings page now uses built-in min/max/wrap (fix #1607) 2022-03-22 09:48:45 +00:00
..
images lightswitch: Correct misspelling in filename 2022-01-21 19:46:58 +01:00
ChangeLog lightswitch 0.03: Settings page now uses built-in min/max/wrap (fix #1607) 2022-03-22 09:48:45 +00:00
README.md lightswitch: Update README.md 2022-01-22 12:13:30 +01:00
boot.js lightswitch: Create boot.js 2022-01-20 10:44:12 +01:00
images.json lightswitch: Update images.json 2022-01-20 12:46:13 +01:00
lib.js lightswitch: Create lib.js 2022-01-20 10:56:11 +01:00
metadata.json lightswitch 0.03: Settings page now uses built-in min/max/wrap (fix #1607) 2022-03-22 09:48:45 +00:00
settings.js lightswitch 0.03: Settings page now uses built-in min/max/wrap (fix #1607) 2022-03-22 09:48:45 +00:00
settings.json lightswitch: Change default timeout 2022-01-21 20:12:14 +01:00
widget.js lightswitch: Add setting 2022-01-21 20:09:25 +01:00

README.md

Light Switch Widget

Whis this widget I wanted to create a solution to quickly en-/disable the LCD backlight and even change the brightness.
In addition it shows the lock status with the option to personalize the lock icon with a tiny image.


Control


  • On / off
    Single touch the widget to en-/disable the backlight.
  • Change brightness (can be disabled)
    First touch the widget, then quickly touch the screen again and drag up/down until you reach your wished brigthness.
  • Double tap to flash backlight (can be disabled)
    By defaut you can double tap on the right side of your bangle to flash the backlight for a short duration.
    (While the backlight is active your bangle will be unlocked.)
  • Double tap to unlock (disabled by default)
    If a side is defined in the app settings, your bangle will be unlocked if you double tap on that side.

Settings


Widget - Change the apperance of the widget:

  • Bulb col
    red / yellow / green / cyan / blue / magenta
    Define the color used for the lightbulbs inner circle.
    The selected color will be dimmed depending on the actual brightness value.
  • Image
    default / random / ...
    Set your favourite lock icon image. (If no image file is found no image will be displayed.)
    • random -> Select a random image on each time the widget is drawn.

Control - Change when and how to use the widget:

  • Touch
    on def clk / on all clk / clk+setting / clk+launch / except apps / always on
    Select when touching the widget is active to en-/disable the backlight.
    • on def clk -> only on your selected main clock face
    • on all clk -> on all apps of the type clock
    • clk+setting -> on all apps of the type clock and in the settings
    • clk+launch -> on all apps of the types clock and launch
    • except apps -> on all apps of the types clock and launch and in the settings
    • always on -> always enabled when the widget is displayed
  • Drag Delay
    off / 50ms / 100ms / ... / 500ms / ... / 1000ms
    Change the maximum delay between first touch and re-touch/drag to change the brightness or disable changing the brightness completely.
  • Min Value
    1% / 2% / ... / 10% / ... / 100%
    Set the minimal level of brightness you can change to.

Unlock - Set double tap side to unlock:

  • TapSide
    off / left / right / top / bottom / front / back

Flash - Change if and how to flash the backlight:

  • TapSide
    off / left / right / top / bottom / front / back
    Set double tap side to flash the backlight or disable completely.
  • Tap
    on locked / on unlocked / always on
    Select when a double tap is recognised.
  • Timeout
    0.5s / 1s / ... / 2s / ... / 10s
    Change how long the backlight will be activated on a flash.
  • Min Value
    1% / 2% / ... / 20% / ... / 100%
    Set the minimal level of brightness for the backlight on a flash.

Images


Lightbulb Default lock icon
( full / dimmed / off ) ( on / off )

Examples in default light and dark theme.

Lock Heart Invader JS Smiley Skull Storm

This images are stored in a seperate file (lightswitch.images.json).


Worth Mentioning


To do list

  • Catch the touch and draw input related to this widget to prevent actions in the active app.
    (For now I have no idea how to achieve this, help is appreciated)
  • Manage images for the lock icon through a Customize and Upload App page.

Requests, Bugs and Feedback

Please leave requests and bug reports by raising an issue at github.com/storm64/BangleApps or send me a mail.

Thanks

Huge thanks to Gordon Williams and all the motivated developers.

Creator

Storm64 (Mail, github)

License

MIT License