109 lines
3.3 KiB
Markdown
109 lines
3.3 KiB
Markdown
# Volume widget
|
|
|
|
Simple and easy-to-install widget for Awesome Window Manager which shows the sound level: 
|
|
|
|
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.
|
|
|
|
## Customization
|
|
|
|
It is possible to customize widget by providing a table with all or some of the following config parameters:
|
|
|
|
| Name | Default | Description |
|
|
|---|---|---|
|
|
| `volume_audio_controller`| `pulse` | audio device |
|
|
| `display_notification` | `false` | Display a notification on mouseover and keypress |
|
|
| `notification_position` | `top_right`| The notification position |
|
|
| `delta` | 5 | The volume +/- percentage |
|
|
|
|
## Installation
|
|
|
|
- clone/copy **volume.lua** file;
|
|
|
|
- include `volume.lua` and add volume widget to your wibox in rc.lua:
|
|
|
|
```lua
|
|
local volume_widget = require("awesome-wm-widgets.volume-widget.volume")
|
|
...
|
|
s.mytasklist, -- Middle widget
|
|
{ -- Right widgets
|
|
...
|
|
volume_widget({display_notification = true}),
|
|
...
|
|
|
|
```
|
|
### Control volume
|
|
|
|
To mute/unmute click on the widget. To increase/decrease volume scroll up or down when mouse cursor is over the widget.
|
|
|
|
If you want to control volume level by keyboard shortcuts add following lines in shortcut section of the **rc.lua**:
|
|
IF you have notification activated, a notification will pop-up on key press
|
|
|
|
```lua
|
|
-- Key bindings
|
|
globalkeys = gears.table.join(
|
|
awful.key(
|
|
{},
|
|
'XF86AudioRaiseVolume',
|
|
volume_widget.raise,
|
|
{description = 'volume up', group = 'hotkeys'}
|
|
),
|
|
awful.key(
|
|
{},
|
|
'XF86AudioLowerVolume',
|
|
volume_widget.lower,
|
|
{description = 'volume down', group = 'hotkeys'}
|
|
),
|
|
awful.key(
|
|
{},
|
|
'XF86AudioMute',
|
|
volume_widget.toggle,
|
|
{description = 'toggle mute', group = 'hotkeys'}
|
|
),
|
|
```
|
|
|
|
### Icons
|
|
|
|
- _Optional step._ In Arc icon theme the muted audio level icon () looks like 0 level icon, which could be a bit misleading.
|
|
So I decided to use original muted icon for low audio level, and the same icon, but colored in red for muted audio level. Fortunately icons are in svg format, so you can easily recolor them with `sed`, so it would look like this ():
|
|
|
|
```bash
|
|
cd /usr/share/icons/Arc/status/symbolic &&
|
|
sudo cp audio-volume-muted-symbolic.svg audio-volume-muted-symbolic_red.svg &&
|
|
sudo sed -i 's/bebebe/ed4737/g' ./audio-volume-muted-symbolic_red.svg
|
|
```
|
|
|
|
### Pulse or ALSA only
|
|
|
|
Try running this command:
|
|
|
|
```bash
|
|
amixer -D pulse sget Master
|
|
```
|
|
|
|
If that prints something like this, then the default setting of 'pulse' is probably fine:
|
|
|
|
```
|
|
Simple mixer control 'Master',0
|
|
Capabilities: pvolume pvolume-joined pswitch pswitch-joined
|
|
Playback channels: Mono
|
|
Limits: Playback 0 - 64
|
|
Mono: Playback 64 [100%] [0.00dB] [on]
|
|
|
|
```
|
|
|
|
If it prints something like this:
|
|
|
|
```bash
|
|
$ amixer -D pulse sget Master
|
|
ALSA lib pulse.c:243:(pulse_connect) PulseAudio: Unable to connect: Connection refused
|
|
|
|
amixer: Mixer attach pulse error: Connection refused
|
|
```
|
|
then set `volume_audio_controller` to `alsa_only` in widget constructor:
|
|
|
|
```lua
|
|
volume_widget({
|
|
volume_audio_controller = 'alsa_only'
|
|
})
|
|
```
|