NOTE: This repository is now read-only - official repository now at https://git.sr.ht/~flexibeast/pulseaudio-control
Author: Alexis flexibeast@gmail.com, Ellington Santos ellingtonsantos@gmail.com, Sergey Trofimov sarg@sarg.org.ru
Version: 0.1
pulseaudio-control
controls PulseAudio volumes from Emacs, via pactl
.
Selecting a PulseAudio sink in the minibuffer via the Ivy completion UI (not required).
Install pulseaudio-control from
MELPA, or put
pulseaudio-control.el
in your load-path and do a (require 'pulseaudio-control)
.
Initially, the pulseaudio-control
keymap is not bound to any
prefix. You can call the command
pulseaudio-control-default-keybindings
to use the prefix C-x /
to access the pulseaudio-control
keymap globally; if you wish to
use this prefix by default, add the line:
(pulseaudio-control-default-keybindings)
to your init file.
The default keybindings in the pulseaudio-control
keymap are:
-
+ : Increase the volume of the currently-selected sink by
pulseaudio-control-volume-step
(pulseaudio-control-increase-sink-volume
). -
= : Increase the volume of the currently-selected source by
pulseaudio-control-volume-step
(pulseaudio-control-increase-source-volume
). -
- : Decrease the volume of the currently-selected sink by
pulseaudio-control-volume-step
(pulseaudio-control-decrease-sink-volume
). -
_ : Decrease the volume of the currently-selected source by
pulseaudio-control-volume-step
(pulseaudio-control-decrease-source-volume
). -
v : Directly specify the volume of the currently-selected sink (
pulseaudio-control-set-sink-volume
). The value can be:- a percentage, e.g. '10%';
- in decibels, e.g. '2dB';
- a linear factor, e.g. '0.9' or '1.1'.
-
V : Directly specify the volume of the currently-selected source (
pulseaudio-control-set-source-volume
). The value can be:- a percentage, e.g. '10%';
- in decibels, e.g. '2dB';
- a linear factor, e.g. '0.9' or '1.1'.
-
m : Toggle muting of the currently-selected sink (
pulseaudio-control-toggle-current-sink-mute
). -
M : Toggle muting of the currently-selected source (
pulseaudio-control-toggle-current-source-mute
). -
x : Toggle muting of a sink, specified by index (
pulseaudio-control-toggle-sink-mute-by-index
). -
X : Toggle muting of a source, specified by index (
pulseaudio-control-toggle-source-mute-by-index
). -
e : Toggle muting of a sink, specified by name (
pulseaudio-control-toggle-sink-mute-by-name
). -
E : Toggle muting of a source, specified by name (
pulseaudio-control-toggle-source-mute-by-name
). -
i : Select a sink to be the current sink, specified by index (
pulseaudio-control-select-sink-by-index
). -
I : Select a source to be the current source, specified by index (
pulseaudio-control-select-source-by-index
). -
n : Select a sink to be the current sink, specified by name (
pulseaudio-control-select-sink-by-name
). -
N : Select a source to be the current source, specified by name (
pulseaudio-control-select-source-by-name
). -
d : Display volume of the currently-selected sink (
pulseaudio-control-display-volume
). -
] : Toggle use of @DEFAULT_SINK@ for volume operations (
pulseaudio-control-default-sink-mode
). -
[ : Toggle use of @DEFAULT_SOURCE@ for volume operations (
pulseaudio-control-default-source-mode
).
Customisation options, including pulseaudio-control-volume-step
,
are available via the pulseaudio-control
customize-group.
If you discover an issue or bug in pulseaudio-control
not already noted:
-
as a TODO item, or
please create a new issue with as much detail as possible, including:
-
which version of Emacs you're running on which operating system, and
-
how you installed
pulseaudio-control
.
GNU General Public License version 3, or (at your option) any later version.
Converted from pulseaudio-control.el
by el2markdown.