pulsectl 16.1.2

Python ctypes bindings for pulseaudio (libpulse).

Python 2.X ctypes bindings for PulseAudio (libpulse), forked from pulsemixer project (which had this code bundled) to re-use this awesome stuff in other projects.

Contents

• Usage

• Installation

• Links

Usage

Simple example:

from pulsectl import Pulse

with Pulse('volume-increaser') as pulse:
  for sink in pulse.sink_list():
    pulse.volume_change_all_chans(sink, 10)

Misc other tinkering:

>>> from pulsectl import Pulse
>>> pulse = Pulse('my-client-name')

>>> pulse.sink_list()
[<PulseSinkInfo at 7f7535ef6f10 - ID: 0, Name: Built-in Audio, Mute: 0, Channels: 2, Volumes: ['44.0%', '44.0%']>]

>>> pulse.sink_input_list()
[<PulseSinkInputInfo at 7f7535ef6210 - ID: 549, Name: mpv Media Player, Mute: 0, Channels: 2, Volumes: ['32.0%', '32.0%']>]

>>> pulse.source_list()
[<PulseSourceInfo at 7f7064c53e90 - ID: 0, Name: Monitor of Built-in Audio, Mute: 0, Channels: 2, Volumes: ['100.0%', '100.0%']>,
 <PulseSourceInfo at 7f705da086d0 - ID: 1, Name: Built-in Audio, Mute: 0, Channels: 2, Volumes: ['100.0%', '100.0%']>]

>>> sink = pulse.sink_list()[0]
>>> pulse.volume_change_all_chans(sink, -10)
>>> pulse.volume_set_all_chans(sink, 50)

Module is relatively new and high-level interfaces might change in the future.

Installation

It’s a regular package for Python 2.7 (not 3.X).

Using pip is the best way:

% pip install pulsectl

If you don’t have it, use:

% easy_install pip
% pip install pulsectl

Alternatively (see also pip2014.com and pip install guide):

% curl https://raw.github.com/pypa/pip/master/contrib/get-pip.py | python2
% pip install pulsectl

Or, if you absolutely must:

% easy_install pulsectl

But, you really shouldn’t do that.

Current-git version can be installed like this:

% pip install 'git+https://github.com/mk-fg/python-pulse-control.git#egg=pulsectl'

Note that to install stuff in system-wide PATH and site-packages, elevated privileges are often required. Use “install –user”, ~/.pydistutils.cfg or virtualenv to do unprivileged installs into custom paths.

Links

• pulsemixer - initial source of for this project (embedded in the tool).

• libpulseaudio - low-level bindings module, auto-generated from pulseaudio header files.

  Branches there have bindings for different (newer) pulseaudio versions.