awesome-wm-widgets/README.md

3.8 KiB

AwesomeWM

Set of super simple widgets compatible with Awesome Window Manager v.4.

screenshot

From left to right:

These widgets use Arc icon theme by default but it could be easily changed to any other icon theme. If you want to have separators between widgets like on the screenshot create text widget with : and place it between widgets:

...
sprtr = wibox.widget.textbox()
sprtr:set_text(" : ")
...
sprtr,
volume_icon,
sprtr,
battery_widget,
sprtr,
...

Installation

Install Arc icon theme and follow installation instructions of each widget.

Or you can clone this repo under ~/.config/awesome/ and then add widgets you'd like to use in wibox:

cd ~/.config/awesome/
git clone https://github.com/streetturtle/awesome-wm-widgets.git

and in rc.lua

require("awesome-wm-widgets.battery-widget.battery")
...
 -- Add widgets to the wibox
     s.mywibox:setup {
         layout = wibox.layout.align.horizontal,
         { -- Left widgets
         ...
         },
         s.mytasklist, -- Middle widget
         { -- Right widgets
         ...
             battery_widget,
         ...
         }

Icons

If you don't want to install Arc icon theme you can just download the icons which are used from the Arc repository. Or create your own icons with the same name. Here is the list of icons used:

Widget Icon name Arc Path
email-widget mail-message-new.png
/usr/share/icons/Arc/actions/22/
mail-mark-unread.png
brightness-widget display-brightness-symbolic.svg /usr/share/icons/Arc/status/symbolic/
volume-widget audio-volume-muted-symbolic.svg /usr/share/icons/Arc/status/symbolic/
audio-volume-low-symbolic.svg
audio-volume-medium-symbolic.svg
audio-volume-high-symbolic.svg
battery-widget battery-caution-symbolic.svg /usr/share/icons/Arc/status/symbolic/
battery-caution-charging-symbolic.svg
battery-low-symbolic.svg
battery-low-charging-symbolic.svg
battery-good-symbolic.svg
battery-good-charging-symbolic.svg
battery-full-symbolic.svg
battery-full-charging-symbolic.svg

In case of any questions/suggestions don't hesitate to contact me, I would be happy to help :)

PRs/issues and st★rs are welcome!