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: 5 days ago
JSON representation
PipeWire (WirePlumber) volume and microphone control module for StumpWM
- Host: GitHub
- URL: https://github.com/junker/stumpwm-wpctl
- Owner: Junker
- Created: 2023-09-06T06:16:48.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2024-09-29T09:37:04.000Z (about 1 month ago)
- Last Synced: 2024-11-08T04:38:19.717Z (5 days ago)
- Topics: pipewire, stumpwm, wireplumber
- Language: Common Lisp
- Homepage:
- Size: 7.81 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
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