Difference between revisions of "BLEWidgets"

From DanIT
Jump to navigation Jump to search
m
m
Line 21: Line 21:
  
 
== Settings ==
 
== Settings ==
 +
''(Keys with multiple values are comma separated (CSV).''<br>
 +
''(Boolean values are formatted as text "True" or "False").''<br>
  
 
=== Devices ===
 
=== Devices ===
 
Each configured Device has a "Device*.ini" file. Containing Device settings, and per Service settings.<br>
 
Each configured Device has a "Device*.ini" file. Containing Device settings, and per Service settings.<br>
(Keys with multiple values are comma separated (CSV).<br>
 
(Boolean values are formatted as text "True" or "False").<br>
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 39: Line 39:
 
| [Service_*] || ServiceName= || String || ''Name of the device service.''
 
| [Service_*] || ServiceName= || String || ''Name of the device service.''
 
|-
 
|-
| [Service_*] || ServiceAutoShow= || Boolean || ''Automatically show the Widget on launch.''
+
| [Service_*] || ServiceAutoShow= || Boolean || ''Automatically show the Widget on App launch.''
 
|-
 
|-
| [Service_*] || ServiceTopMost= || Boolean || ''Widget window is always on top (TopMost).''
+
| [Service_*] || ServiceTopMost= || Boolean || ''Widget's window is always on top.''
 
|-
 
|-
| [Service_*] || ServiceDarkMode= || Boolean || ''Widget displays in Dark Mode style.''
+
| [Service_*] || ServiceDarkMode= || Boolean || ''Widget's theme is Dark Mode style.''
 
|-
 
|-
| [Service_*] || ServiceShowGraph= || Boolean || ''Show or hide Widget's Graph (Heart Rate).''
+
| [Service_*] || ServiceShowGraph= || Boolean || ''Show or hide Widget's Graph.''
 
|}
 
|}
(Replace Service asterisk (*) with the Device's Service index count number).
+
''(Replace Service asterisk (*) with the Device's Service index count number).''<br>
  
 
=== Triggers ===
 
=== Triggers ===
Line 60: Line 60:
 
| [Task_*] || TaskEnabled= || Boolean || ''Enable or disable the trigger.''
 
| [Task_*] || TaskEnabled= || Boolean || ''Enable or disable the trigger.''
 
|-
 
|-
| [Task_*] || TaskTriggers= || String, String, Int || ''Conditions of the trigger.''
+
| [Task_*] || TaskTriggers= || String, String, Int || ''Condition "When", Condition "Is", Condition "Value".''
 
|-
 
|-
| [Task_*] || TaskActions= || String, String || ''Actions of the trigger.''
+
| [Task_*] || TaskActions= || String, String || ''Action "Do", Action "Value".''
 
|}
 
|}
(Replace Task asterisk (*) with the Task's index count number).
+
''(Replace Task asterisk (*) with the Task's index count number).''<br>

Revision as of 03:18, 23 May 2026

BLEWidget Heart Rate Preview.png

BLEWidgets is a Windows App that displays live biometric data such as Heart Rate from Bluetooth LE (BLE) devices.
Each subscribed service has its own live notification (system tray) icon, and optional topmost window widget.

Supported Services: Heart Rate.
Supported Devices: Amazfit Helio Strap (Confirmed Supported). Everything else.

Usage

BLEWidgets DeviceSearch.png
BLEWidgets DeviceInfo.png

First time launching BLEWidgets you will be prompted to add at least one device/service first.

If you do not know the BLE Address of your device, you can use the Search functionality to find it.
In order to find it, on the device I had to enable 'Heart Rate Push', and then 'Reboot Device'.

Services

Heart Rate

The Widget will display a warning message if no Heart Rate has been received for more than 10 seconds (changeable with App.Settings.HeartRateTimeout).

Settings

(Keys with multiple values are comma separated (CSV).
(Boolean values are formatted as text "True" or "False").

Devices

Each configured Device has a "Device*.ini" file. Containing Device settings, and per Service settings.

Section Key Value(s) Description
[Device] DeviceName= String Name of the device.
[Device] DeviceAddress= String BLE Address of the device.
[Device] DeviceServices= String[] Services of the device.
[Service_*] ServiceName= String Name of the device service.
[Service_*] ServiceAutoShow= Boolean Automatically show the Widget on App launch.
[Service_*] ServiceTopMost= Boolean Widget's window is always on top.
[Service_*] ServiceDarkMode= Boolean Widget's theme is Dark Mode style.
[Service_*] ServiceShowGraph= Boolean Show or hide Widget's Graph.

(Replace Service asterisk (*) with the Device's Service index count number).

Triggers

All created Triggers are saved in the "Tasks.ini" file.

Section Key Value(s) Description
[Task_*] TaskName= String Name of the trigger.
[Task_*] TaskEnabled= Boolean Enable or disable the trigger.
[Task_*] TaskTriggers= String, String, Int Condition "When", Condition "Is", Condition "Value".
[Task_*] TaskActions= String, String Action "Do", Action "Value".

(Replace Task asterisk (*) with the Task's index count number).