junker / stumpwm-pamixer

Minimalistic Pulseaudio volume and microphone control module for StumpWM.

StumpWM Pamixer

Minimalistic Pulseaudio volume and microphone control module for StumpWM.

Requirements

• pamixer CLI program installed

Installation

cd ~/.stumpwm.d/modules/
git clone https://github.com/Junker/stumpwm-pamixer pamixer

(stumpwm:add-to-load-path "~/.stumpwm.d/modules/pamixer")
(load-module "pamixer")

Usage

  (define-key *top-map* (kbd "XF86AudioRaiseVolume") "pamixer-volume-up")
  (define-key *top-map* (kbd "XF86AudioLowerVolume") "pamixer-volume-down")
  (define-key *top-map* (kbd "XF86AudioMute") "pamixer-toggle-mute")

Additional commands

• pamixer-mute
• pamixer-unmute
• pamixer-set-volume volume

control of source, e.g. microphone:

• pamixer-source-volume-up
• pamixer-source-volume-down
• pamixer-source-mute
• pamixer-source-unmute
• pamixer-source-toggle-mute
• pamixer-source-set-volume volume

Parameters

• pamixer:*step* - volume increase/decrease step
• pamixer:*allow-boost* - allow volume to go above 100%
• pamixer:*source-allow-boost* - allow source volume to go above 100%
• pamixer:*mixer-command* - external mixer program that opens on modeline right click (default: pavucontrol)

Modeline

%P - pamixer formatter

Parameters for modeline

• pamixer:*modeline-fmt* - format of pamixer modeline (default: "%b(%v)")
  • %b - volume bar
  • %v - volume value

Modeline mouse interaction

• left button: mute/unmute
• right button: open mixer program
• wheel up: volume up
• wheel down: volume down

stumpwm-pamixer's Issues

Error to show modeline

Hi,
when I add %P to the screen-mode-line-format the following error is displayed in the mode-line:
"Unable to expand mode line format string: #<TYPE-ERROR expected-type: REAL datum: NIL"

register-ml-on-click-id undefined

Apologies, I am new to CL in general.

I packaged your contribution as a gnu guix package from source code. When I asdf:load-system :pamixer to try to use it, I get: undefined function: STUMPWM::REGISTER-ML-ON-CLICK-ID.

Any ideas for how to deal with this?

Edit: The error also occurs if I follow the README directions.