dtos-dotfiles/.config/awesome/lain/wiki/pulsebar.md

Usage

Read here.

Description

Shows PulseAudio volume with a progressbar; provides tooltips and notifications.

local volume = lain.widget.pulsebar()

Input table

Variable	Meaning	Type	Default
timeout	Refresh timeout seconds	number	5
settings	User settings	function	empty function
width	Bar width	number	63
height	Bar height	number	1
ticks	Set bar ticks on	boolean	false
ticks_size	Ticks size	number	7
colors	Bar colors	table	see Default colors
followtag	Display the notification on currently focused screen	boolean	false
notification_preset	Notification preset	table	See default notification_preset
devicetype	PulseAudio device type	string ("sink", "source")	"sink"
cmd	PulseAudio command	string or function	see here

Read pulse page for cmd settings.

settings can use these variables.

With multiple screens, the default behaviour is to show a visual notification pop-up window on the first screen. By setting followtag to true it will be shown on the currently focused tag screen.

Default colors

Variable	Meaning	Type	Default
background	Bar backgrund color	string	"#000000"
mute	Bar mute color	string	"#EB8F8F"
unmute	Bar unmute color	string	"#A4CE8A"

Default notification_preset

notification_preset = {
    font = "Monospace 10"
}

Output table

Variable	Meaning	Type
bar	The widget	wibox.widget.progressbar
device	PulseAudio device	string
notify	The notification	function
update	Update state	function
tooltip	The tooltip	awful.tooltip

Buttons

volume.bar:buttons(awful.util.table.join(
    awful.button({}, 1, function() -- left click
        awful.spawn("pavucontrol")
    end),
    awful.button({}, 2, function() -- middle click
        awful.spawn(string.format("pactl set-sink-volume %d 100%%", volume.sink))
        volume.update()
    end),
    awful.button({}, 3, function() -- right click
        awful.spawn(string.format("pactl set-sink-mute %d toggle", volume.sink))
        volume.update()
    end),
    awful.button({}, 4, function() -- scroll up
        awful.spawn(string.format("pactl set-sink-volume %d +1%%", volume.sink))
        volume.update()
    end),
    awful.button({}, 5, function() -- scroll down
        awful.spawn(string.format("pactl set-sink-volume %d -1%%", volume.sink))
        volume.update()
    end)
))

Keybindings

Same as here. If you want notifications, use volume.notify() instead of volume.update().