Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Junker/stumpwm-wpctl
PipeWire (WirePlumber) volume and microphone control module for StumpWM
https://github.com/Junker/stumpwm-wpctl
pipewire stumpwm wireplumber
Last synced: about 2 months ago
JSON representation
PipeWire (WirePlumber) volume and microphone control module for StumpWM
- Host: GitHub
- URL: https://github.com/Junker/stumpwm-wpctl
- Owner: Junker
- License: mit
- Created: 2023-09-06T06:16:48.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2023-11-18T15:24:55.000Z (10 months ago)
- Last Synced: 2024-06-12T00:09:52.177Z (3 months ago)
- Topics: pipewire, stumpwm, wireplumber
- Language: Common Lisp
- Homepage:
- Size: 6.84 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-stumpwm - wpctl - PipeWire volume and microphone control module (Modules)
README
# StumpWM wpctl
Minimalistic PipeWire volume and microphone control module for StumpWM.
## Requirements
- [wireplumber](https://github.com/PipeWire/wireplumber) installed
- [parse-float](https://github.com/soemraws/parse-float) installed
## Installation
```bash
cd ~/.stumpwm.d/modules/
git clone https://github.com/Junker/stumpwm-wpctl wpctl
```
```lisp
(stumpwm:add-to-load-path "~/.stumpwm.d/modules/wpctl")
(load-module "wpctl")
```
## Usage
```lisp
(define-key *top-map* (kbd "XF86AudioRaiseVolume") "wpctl-volume-up")
(define-key *top-map* (kbd "XF86AudioLowerVolume") "wpctl-volume-down")
(define-key *top-map* (kbd "XF86AudioMute") "wpctl-toggle-mute")
```
### Commands
- `wpctl-volume-up`
- `wpctl-volume-down`
- `wpctl-mute`
- `wpctl-unmute`
- `wpctl-toggle-mute`
- `wpctl-set-volume volume`
**control of source, e.g. microphone:**
- `wpctl-source-volume-up`
- `wpctl-source-volume-down`
- `wpctl-source-mute`
- `wpctl-source-unmute`
- `wpctl-source-toggle-mute`
- `wpctl-source-set-volume volume`
### Parameters
- `wpctl:*step*` - volume increase/decrease step
- `wpctl:*mixer-command*` - external mixer program that opens on modeline right click (default: pavucontrol)
- `wpctl:*default-sink-id*`
- `wpctl:*default-source-id*`
- `wpctl:*wpctl-path*`
## Modeline
`%P` - wpctl formatter
### Parameters for modeline
- `wpctl:*modeline-fmt*` - format of wpctl 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