Module: Bluetooth

The bluetooth module displays information about a bluetooth controller and its connections.

Config

Addressed by bluetooth

option	typeof	default	description
controller	string		Use the controller with the defined alias. Otherwise a random controller is used. Recommended to define when there is more than 1 controller available to the system.
format-device-preference	array		A ranking of bluetooth devices, addressed by their alias. The order is from first displayed to last displayed. If this config option is not defined or none of the devices in the list are connected, it will fall back to showing the last connected device.
format	string	 {status}	The format, how information should be displayed. This format is used when other formats aren't specified.
format-disabled	string		This format is used when the displayed controller is disabled.
format-off	string		This format is used when the displayed controller is turned off.
format-on	string		This format is used when the displayed controller is turned on with no devices connected.
format-connected	string		This format is used when the displayed controller is connected to at least 1 device.
rotate	integer		Positive value to rotate the text label.
``		-	.
``		-	.
``		-	.
``		-	.
``		-	.
``		-	.
``		-	.
``		-	.
``		-	.
``		-	.
``		-	.
``		-	.

Format replacements:

string	replacement
{status}	.
{status}	.

Examples:

"bluetooth": {
	// "controller": "controller1", // specify the alias of the controller if there are more than 1 on the system
	"format": " {status}",
	"format-disabled": "", // an empty format will hide the module
	"format-connected": " {num_connections} connected",
	"tooltip-format": "{controller_alias}\\t{controller_address}",
	"tooltip-format-connected": "{controller_alias}\\t{controller_address}\\n\\n{device_enumerate}",
	"tooltip-format-enumerate-connected": "{device_alias}\\t{device_address}"
}

"bluetooth": {
	"format": " {status}",
	"format-connected": " {device_alias}",
	"format-connected-battery": " {device_alias} {device_battery_percentage}%",
	// "format-device-preference": [ "device1", "device2" ], // preference list deciding the displayed device
	"tooltip-format": "{controller_alias}\\t{controller_address}\\n\\n{num_connections} connected",
	"tooltip-format-connected": "{controller_alias}\\t{controller_address}\\n\\n{num_connections} connected\\n\\n{device_enumerate}",
	"tooltip-format-enumerate-connected": "{device_alias}\\t{device_address}",
	"tooltip-format-enumerate-connected-battery": "{device_alias}\\t{device_address}\\t{device_battery_percentage}%"
}

Style

• #bluetooth
• #bluetooth.disabled
• #bluetooth.off
• #bluetooth.on
• #bluetooth.connected
• #bluetooth.discoverable
• #bluetooth.discovering
• #bluetooth.pairable