120 lines
		
	
	
		
			2.1 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			120 lines
		
	
	
		
			2.1 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
| waybar-upower(5)
 | |
| 
 | |
| # NAME
 | |
| 
 | |
| waybar - upower module
 | |
| 
 | |
| # DESCRIPTION
 | |
| 
 | |
| The *upower* module displays the main battery capacity with all other upower
 | |
| compatible devices in the tooltip.
 | |
| 
 | |
| # CONFIGURATION
 | |
| 
 | |
| *native-path*: ++
 | |
| 	typeof: string ++
 | |
| 	default: ++
 | |
| 	The battery to monitor. Refer to the https://upower.freedesktop.org/docs/UpDevice.html#UpDevice--native-path ++
 | |
| 	Can be obtained using `upower --dump`
 | |
| 
 | |
| *icon-size*: ++
 | |
| 	typeof: integer ++
 | |
| 	default: 20 ++
 | |
| 	Defines the size of the icons.
 | |
| 
 | |
| *format*: ++
 | |
| 	typeof: string ++
 | |
| 	default: {percentage} ++
 | |
| 	The text format.
 | |
| 
 | |
| *format-alt*: ++
 | |
| 	typeof: string ++
 | |
| 	default: {percentage} {time} ++
 | |
| 	The text format when toggled.
 | |
| 
 | |
| *hide-if-empty*: ++
 | |
| 	typeof: bool ++
 | |
| 	default: true ++
 | |
| 	Defines visibility of the module if no devices can be found.
 | |
| 
 | |
| *tooltip*: ++
 | |
| 	typeof: bool ++
 | |
| 	default: true ++
 | |
| 	Option to disable tooltip on hover.
 | |
| 
 | |
| *tooltip-spacing*: ++
 | |
| 	typeof: integer ++
 | |
| 	default: 4 ++
 | |
| 	Defines the spacing between the tooltip device name and device battery ++
 | |
| 	status.
 | |
| 
 | |
| *tooltip-padding*: ++
 | |
| 	typeof: integer ++
 | |
| 	default: 4 ++
 | |
| 	Defines the spacing between the tooltip window edge and the tooltip content.
 | |
| 
 | |
| *on-click*: ++
 | |
| 	typeof: string ++
 | |
| 	Command to execute when clicked on the module.
 | |
| 
 | |
| *show-icon*: ++
 | |
| 	typeof: bool ++
 | |
| 	default: true ++
 | |
| 	Option to disable battery icon.
 | |
| 
 | |
| # FORMAT REPLACEMENTS
 | |
| 
 | |
| *{percentage}*: The battery capacity in percentage
 | |
| 
 | |
| *{time}*: An estimated time either until empty or until fully charged ++
 | |
| depending on the charging state.
 | |
| 
 | |
| # EXAMPLES
 | |
| 
 | |
| ```
 | |
| "upower": {
 | |
| 	"icon-size": 20,
 | |
| 	"hide-if-empty": true,
 | |
| 	"tooltip": true,
 | |
| 	"tooltip-spacing": 20
 | |
| }
 | |
| 
 | |
| ```
 | |
| ```
 | |
| "upower": {
 | |
| 	"native-path": "/org/bluez/hci0/dev_D4_AE_41_38_D0_EF",
 | |
| 	"icon-size": 20,
 | |
| 	"hide-if-empty": true,
 | |
| 	"tooltip": true,
 | |
| 	"tooltip-spacing": 20
 | |
| }
 | |
| 
 | |
| ```
 | |
| ```
 | |
| "upower": {
 | |
| 	"native-path": "battery_sony_controller_battery_d0o27o88o32ofcoee",
 | |
| 	"icon-size": 20,
 | |
| 	"hide-if-empty": true,
 | |
| 	"tooltip": true,
 | |
| 	"tooltip-spacing": 20
 | |
| }
 | |
| ```
 | |
| ```
 | |
| "upower": {
 | |
| 	"show-icon": false,
 | |
| 	"hide-if-empty": true,
 | |
| 	"tooltip": true,
 | |
| 	"tooltip-spacing": 20
 | |
| }
 | |
| 
 | |
| ```
 | |
| 
 | |
| # STYLE
 | |
| 
 | |
| - *#upower*
 | |
| - *#upower.charging*
 | |
| - *#upower.discharging*
 | |
| - *#upower.full*
 | |
| - *#upower.empty*
 | |
| - *#upower.unknown-status*
 |