Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Junker/stumpwm-pamixer
Minimalistic Pulseaudio volume and microphone control module for StumpWM.
https://github.com/Junker/stumpwm-pamixer
pulseaudio sound stumpwm volume-control
Last synced: 3 months ago
JSON representation
Minimalistic Pulseaudio volume and microphone control module for StumpWM.
- Host: GitHub
- URL: https://github.com/Junker/stumpwm-pamixer
- Owner: Junker
- Created: 2022-02-08T06:44:25.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2023-11-18T15:27:10.000Z (12 months ago)
- Last Synced: 2024-06-12T00:09:49.012Z (5 months ago)
- Topics: pulseaudio, sound, stumpwm, volume-control
- Language: Common Lisp
- Homepage:
- Size: 15.6 KB
- Stars: 3
- Watchers: 3
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-stumpwm - pamixer - Pulseaudio volume and microphone control module (Modules)
README
# StumpWM Pamixer
Minimalistic Pulseaudio volume and microphone control module for StumpWM.
## Requirements
- [pamixer](https://github.com/cdemoulins/pamixer) CLI program installed
## Installation
```bash
cd ~/.stumpwm.d/modules/
git clone https://github.com/Junker/stumpwm-pamixer pamixer
```
```common-lisp
(stumpwm:add-to-load-path "~/.stumpwm.d/modules/pamixer")
(load-module "pamixer")
```
## Usage
```common-lisp
(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