awesome-wm-widgets/battery-widget/README.md

# Battery widget

Simple and easy-to-install widget for Awesome Window Manager.

This widget consists of:

 - an icon which shows the battery level:  
 ![Battery Widget](./bat-wid-1.png)
 - a pop-up window, which shows up when you hover over an icon:  
 ![Battery Widget](./bat-wid-2.png)  
 Alternatively you can use a tooltip (check the code):  
 ![Battery Widget](./bat-wid-22.png)
 - a pop-up warning message which appears on bottom right corner when battery level is less that 15%:  
 ![Battery Widget](./bat-wid-3.png) 

Note that widget uses the Arc icon theme, so it should be [installed](https://github.com/horst3180/arc-icon-theme#installation) first under **/usr/share/icons/Arc/** folder.

## Installation

This widget reads the output of acpi tool.
- install `acpi` and check the output:

```bash
$ sudo apt-get install acpi
$ acpi
Battery 0: Discharging, 66%, 02:34:06 remaining
```

Then refer to the [installation](https://github.com/streetturtle/awesome-wm-widgets#installation) section of the repo.
Battery widget readme 2017-02-02 02:52:08 +01:00			`# Battery widget`
Update README.md 2017-09-29 16:14:03 +02:00
Battery widget readme 2017-02-02 02:52:08 +01:00			`Simple and easy-to-install widget for Awesome Window Manager.`

Update README.md 2017-09-29 16:14:03 +02:00			`This widget consists of:`
Battery widget readme 2017-02-02 02:52:08 +01:00
Update README.md 2017-09-29 16:08:44 +02:00			`- an icon which shows the battery level:`
			`![Battery Widget](./bat-wid-1.png)`
			`- a pop-up window, which shows up when you hover over an icon:`
			`![Battery Widget](./bat-wid-2.png)`
Update README.md 2017-10-04 21:18:51 +02:00			`Alternatively you can use a tooltip (check the code):`
Update README.md 2017-09-29 16:08:44 +02:00			`![Battery Widget](./bat-wid-22.png)`
			`- a pop-up warning message which appears on bottom right corner when battery level is less that 15%:`
			`![Battery Widget](./bat-wid-3.png)`
Battery widget readme 2017-02-02 02:52:08 +01:00
readme update 2017-02-02 03:45:15 +01:00			`Note that widget uses the Arc icon theme, so it should be [installed](https://github.com/horst3180/arc-icon-theme#installation) first under /usr/share/icons/Arc/ folder.`

Battery widget readme 2017-02-02 02:52:08 +01:00			`## Installation`

			`This widget reads the output of acpi tool.`
			- install `acpi` and check the output:

			```bash
			`$ sudo apt-get install acpi`
			`$ acpi`
			`Battery 0: Discharging, 66%, 02:34:06 remaining`
			```

Update README.md 2017-10-13 17:31:18 +02:00			`Then refer to the [installation](https://github.com/streetturtle/awesome-wm-widgets#installation) section of the repo.`