Quantcast
Channel: Rainmeter Forums
Viewing all articles
Browse latest Browse all 1035

Community Plugins & Addons • Rainmeter Bluetooth Plugin - v0.1.0.8

$
0
0
Rainmeter Bluetooth Plugin - v0.1.0.8

Since it was missing, I decided to try to make a Bluetooth plugin for Rainmeter.

This plugin is still a WIP (Work In Progress) and it doesn't include all the features that could be useful to have. If you want to see planned features, please check the Features section. If you want to help, please check the Contributing section on Github.

Documentation
Head over to https://droptop.gitbook.io/rainmeter-bluetooth-plugin to read the full documentation.

Features
Image
Example skin
Image
Droptop Four Bluetooth menu


Those are the features we'd like to implement/have in a bluetooth plugin

Already implemented:
  • Enable/Disable/Toggle Bluetooth adapter
  • List Bluetooth devices
  • Return the Bluetooth status
  • List BluetoothLE devices
  • Get device thumbnail
  • Battery level of BLE devices (it's possible that some devices' battery is not displayed)
Not yet implemented:
  • Discover Bluetooth devices
  • Discover BluetoothLE devices
  • Connect to devices
  • Disconnect devices
  • Pair devices
  • Unpair devices
Basic Usage
The plugin at every update, is going to scan for Bluetooth devices, and update the list of available devices. The plugin is going to store the list of devices in a formatted string, that can be accessed using the `AvailableDevices()` function.

The formatted string is going to be in the following format:

device_name|device_address|device_id|connected[0,1]|paired[0,1]|can_pair[0,1]major_category|minor_category|has_battery_level[0,1]|battery|is_ble[0,1];

This is an example of how you can use the plugin in a skin:

Code:

[Bluetooth]Measure=PluginPlugin=BluetoothDevicesUpdatedAction=[!CommandMeasure LuaScript "Refresh()"]UpdateDivider=30    ; Keep a relatively high value, to avoid spamming the plugin with update requests that cannot terminate[LuaScript]Measure=ScriptScriptFile=Example.luaUpdateDivider=-1

Code:

function Refresh()    local DevicesString = SKIN:ReplaceVariables('[&BluetoothMeasure:AvailableDevices()]')    -- DevicesString = Formatted string of all devices    -- ("device_name|device_address|device_id|connected[0,1]|paired[0,1]|can_pair[0,1]major_category|minor_category|has_battery_level[0,1]|battery|is_ble[0,1];")    -- Do something with the devices list    -- See example skin for an exampleend
For a complete example, check out the example skin.
If you want/are able to help, please do. Any help is appreciated

Issues and pull-requests are open in the Github repo: https://github.com/Droptop-Four/Rainmeter-Bluetooth-Plugin

Statistics: Posted by Bunz — Yesterday, 5:41 pm — Replies 0 — Views 77



Viewing all articles
Browse latest Browse all 1035

Trending Articles