Skip to content
Control PulseAudio volumes from Emacs, via `pactl`.
Branch: master
Clone or download
flexibeast Merge pull request #11 from sarg/mute-sink-input
Initial sink inputs support.
Latest commit 5522068 Apr 20, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
README.md Update documentation. Jan 5, 2019
pulseaudio-control.el
screenshot.png Add screenshot to README.md. Sep 22, 2017

README.md

pulseaudio-control - Use pactl to manage PulseAudio volumes

Author: Alexis flexibeast@gmail.com
Version: 0.1

pulseaudio-control controls PulseAudio volumes from Emacs, via pactl.

Image of selecting a PulseAudio sink in the minibuffer via the Ivy completion UI
Selecting a PulseAudio sink in the minibuffer via the Ivy completion UI.

Table of Contents

Installation

Install pulseaudio-control from MELPA, or put pulseaudio-control.el in your load-path and do a (require 'pulseaudio-control).

Usage

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-volume).

  • - : Decrease the volume of the currently-selected sink by pulseaudio-control-volume-step (pulseaudio-control-decrease-volume).

  • v : Directly specify the volume of the currently-selected sink (pulseaudio-control-set-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).

  • x : Toggle muting of a sink, specified by index (pulseaudio-control-toggle-sink-mute-by-index).

  • e : Toggle muting of a sink, specified by name (pulseaudio-control-toggle-sink-mute-by-name).

  • i : Select a sink to be the current sink, specified by index (pulseaudio-control-select-sink-by-index).

  • n : Select a sink to be the current sink, specified by name (pulseaudio-control-select-sink-by-name).

  • d : Display volume of the currently-selected sink (pulseaudio-control-display-volume).

  • ] : Toggle use of @DEFAULT_SINK@ for volume operations (pulseaudio-control-toggle-use-of-default-sink).

Customisation options, including pulseaudio-control-volume-step, are available via the pulseaudio-control customize-group.

Issues / bugs

If you discover an issue or bug in pulseaudio-control not already noted:

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.

License

GNU General Public License version 3, or (at your option) any later version.


Converted from pulseaudio-control.el by el2markdown.

You can’t perform that action at this time.