Module i3status_rs::blocks::kdeconnect
source · Expand description
KDEConnect indicator
Display info from the currently connected device in KDEConnect, updated asynchronously.
Block colours are updated based on the battery level, unless all bat_* thresholds are set to 0, in which case the block colours will depend on the notification count instead.
§Configuration
| Key | Values | Default |
|---|---|---|
device_id | Device ID as per the output of kdeconnect --list-devices. | Chooses the first found device, if any. |
format | A string to customise the output of this block. See below for available placeholders. | " $icon $name{ $bat_icon $bat_charge|}{ $notif_icon|} " |
format_disconnected | Same as format but when device is disconnected | " $icon " |
format_missing | Same as format but when device does not exist | " $icon x " |
bat_info | Min battery level below which state is set to info. | 60 |
bat_good | Min battery level below which state is set to good. | 60 |
bat_warning | Min battery level below which state is set to warning. | 30 |
bat_critical | Min battery level below which state is set to critical. | 15 |
| Placeholder | Value | Type | Unit |
|---|---|---|---|
icon | Icon based on connection’s status | Icon | - |
bat_icon | Battery level indicator (only when connected and if supported) | Icon | - |
bat_charge | Battery charge level (only when connected and if supported) | Number | % |
network_icon | Cell Network indicator (only when connected and if supported) | Icon | - |
network_type | Cell Network type (only when connected and if supported) | Text | - |
network_strength | Cell Network level (only when connected and if supported) | Number | % |
notif_icon | Only when connected and there are notifications | Icon | - |
notif_count | Number of notifications on your phone (only when connected and non-zero) | Number | - |
name | Name of your device as reported by KDEConnect (if available) | Text | - |
§Example
Do not show the name, do not set the “good” state.
[[block]]
block = "kdeconnect"
format = " $icon {$bat_icon $bat_charge |}{$notif_icon |}{$network_icon$network_strength $network_type |}"
bat_good = 101
§Icons Used
bat(as a progression)bat_charging(as a progression)net_cellular(as a progression)notificationphonephone_disconnected