awesomewm-mirrors
/
awesome-wm-widgets
mirror of https://github.com/streetturtle/awesome-wm-widgets.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
awesome-wm-widgets/experiments/volume
History
streetturtle 878bd6f0ce some improvements 2020-12-16 22:12:45 -05:00
..
icons [experiments] volume widget improvements 2020-11-01 14:03:06 -05:00
screenshots ultimate volume widget improvements 2020-12-14 22:33:56 -05:00
widgets some improvements 2020-12-16 22:12:45 -05:00
README.md some improvements 2020-12-16 22:12:45 -05:00
utils.lua fix more warnings 2020-12-06 14:47:40 -05:00
volume-2.svg [experiments] the volume widget 2020-10-31 14:54:36 -04:00
volume.lua some improvements 2020-12-16 22:12:45 -05:00

README.md

Volume widget

Volume widget based on amixer (is used for controlling the audio volume) and pacmd (is used for selecting a sink/source). Also, the widget provides an easy way to customize how it looks, following types are supported out-of-the-box:

types

From left to right: horizontal_bar, vertical_bar, icon, icon_and_text, arc

A right-click on the widget opens a popup where you can choose a sink/source:
sink-sources

Features

  • switch between sinks/sources by right clicking on the widget;
  • more responsive than previous versions of volume widget, which were refreshed once a second;
  • 5 predefined looks (check the screenshots below);

Customization

It is possible to customize the widget by providing a table with all or some of the following config parameters:

Generic parameter

Name Default Description
type icon_and_text Widget type, one of horizontal_bar, vertical_bar, icon, icon_and_text, arc

icon parameters

Name Default Description
icon_dir ./icons Path to the folder with icons

Note: if you are changing icons, the folder should contain following .svg images:

  • audio-volume-high-symbolic
  • audio-volume-medium-symbolic
  • audio-volume-low-symbolic
  • audio-volume-muted-symbolic

icon_and_text parameters

Name Default Description
icon_dir ./icons Path to the folder with icons
font beautiful.font Font name and size, like Play 12

arc parameters

Name Default Description
thickness 2 Thickness of the arc
main_color beautiful.fg_color Color of the arc
bg_color #ffffff11 Color of the arc's background
mute_color beautiful.fg_urgent Color of the arc when mute
size 18 Size of the widget

horizontal_bar parameters

Name Default Description
main_color beautiful.fg_normal Color of the bar
mute_color beautiful.fg_urgent Color of the bar when mute
bg_color '#ffffff11' Color of the bar's background
width 50 The bar width
margins 10 Top and bottom margins (if your wibar is 22 px high, bar will be 2 px = 22 - 2*10)
shape 'bar' gears.shape, could be octogon, hexagon, powerline, etc
with_icon true Show volume icon

Note: I didn't figure out how does the forced_height property of progressbar widget work (maybe it doesn't work at all), thus there is a workaround with margins.

vertical_bar parameters

Name Default Description
main_color beautiful.fg_normal Color of the bar
mute_color beautiful.fg_urgent Color of the bar when mute
bg_color '#ffffff11' Color of the bar's background
width 10 The bar width
margins 20 Top and bottom margins (if your wibar is 22 px high, bar will be 2 px = 22 - 2*10)
shape 'bar' gears.shape, could be octogon, hexagon, powerline, etc
with_icon true Show volume icon