Difference between revisions of "BLEWidgets"
m |
m |
||
| (8 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
| − | [[File:BLEWidget Heart Rate Preview.png| | + | [[File:BLEWidget Heart Rate Preview.png|frame|400px|right]] |
'''BLEWidgets''' is a Windows App that displays live biometric data such as Heart Rate from Bluetooth LE (BLE) devices.<br> | '''BLEWidgets''' is a Windows App that displays live biometric data such as Heart Rate from Bluetooth LE (BLE) devices.<br> | ||
Each subscribed service has its own live notification (system tray) icon, and optional topmost window widget.<br> | Each subscribed service has its own live notification (system tray) icon, and optional topmost window widget.<br> | ||
| + | <br> | ||
| − | + | == Support == | |
| − | |||
| − | == | + | === Requirements === |
| − | [[ | + | '''Operating System:''' Windows 10 / Windows 11<br> |
| − | [[File: | + | '''.NET Platform:''' [https://dotnet.microsoft.com/en-us/download/dotnet/10.0 .NET 10.0]<br> |
| − | [[File: | + | |
| + | '''Bluetooth:''' Bluetooth 4.0 with Low Energy (LE/BLE) Support.<br> | ||
| + | '''Tested Devices:''' ''Amazfit Helio Strap'' (Works).<br> | ||
| + | Should work on all Devices that broadcast standard [https://www.bluetooth.com/specifications/specs/heart-rate-service Heart Rate Service].<br> | ||
| + | |||
| + | == Setup == | ||
| + | {| | ||
| + | | [[File:BLEWidgets_DeviceSearch.png|thumb|Device Search]] | ||
| + | | [[File:BLEWidgets_DeviceInfo.png|thumb|Device Information]] | ||
| + | |} | ||
First time launching BLEWidgets you will be prompted to add at least one device/service first.<br> | First time launching BLEWidgets you will be prompted to add at least one device/service first.<br> | ||
| Line 15: | Line 24: | ||
In order to find it, on the device I had to enable 'Heart Rate Push', and then 'Reboot Device'.<br> | In order to find it, on the device I had to enable 'Heart Rate Push', and then 'Reboot Device'.<br> | ||
| − | == | + | == Services == |
| + | Currently only the 'Heart Rate' Service is implemented.<br> | ||
| + | |||
| + | === Heart Rate === | ||
| + | Shows a Notification Area (System Tray) icon with current Heart Beat (BPM).<br> | ||
| + | Shows an optional Widget window also displaying the current Heart Beat (BPM), and Heart Rate Chart.<br> | ||
| + | |||
| + | The Widget will display a warning message if no Heart Rate has been received for more than 10 seconds (changeable with <code>App.Settings.HeartRateTimeout</code>).<br> | ||
| + | |||
| + | == Settings == | ||
| + | ''(Keys with multiple values are comma separated).''<br> | ||
| + | ''(Boolean values are formatted as text "True" or "False").''<br> | ||
| + | |||
| + | === Devices === | ||
| + | [[File:BLEWidgets_DeviceSettings.png|thumb|Device Settings]] | ||
| + | Device and Services configurations are saved per device in the "Device*.ini" files:<br> | ||
| + | |||
| + | {| class="wikitable" | ||
| + | |- | ||
| + | ! 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).''<br> | ||
| + | |||
| + | === Triggers === | ||
| + | [[File:BLEWidgets Triggers.png|thumb|Triggers]] | ||
| + | Task (Trigger) configurations are saved in the "Tasks.ini" file:<br> | ||
| − | == | + | {| class="wikitable" |
| + | |- | ||
| + | ! 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).''<br> | ||
Latest revision as of 04:13, 23 May 2026
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.
Contents
Support
Requirements
Operating System: Windows 10 / Windows 11
.NET Platform: .NET 10.0
Bluetooth: Bluetooth 4.0 with Low Energy (LE/BLE) Support.
Tested Devices: Amazfit Helio Strap (Works).
Should work on all Devices that broadcast standard Heart Rate Service.
Setup
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
Currently only the 'Heart Rate' Service is implemented.
Heart Rate
Shows a Notification Area (System Tray) icon with current Heart Beat (BPM).
Shows an optional Widget window also displaying the current Heart Beat (BPM), and Heart Rate Chart.
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).
(Boolean values are formatted as text "True" or "False").
Devices
Device and Services configurations are saved per device in the "Device*.ini" files:
| 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
Task (Trigger) configurations 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).
