PipeWire — Multimedia processing


PipeWire is a project that aims to greatly improve handling of audio and video under Linux.

It provides a low-latency, graph based processing engine on top of audio and video devices that can be used to support the use cases currently handled by both pulseaudio and JACK. PipeWire was designed with a powerful security model that makes interacting with audio and video devices from containerized applications easy, with supporting Flatpak applications being the primary goal. Alongside Wayland and Flatpak we expect PipeWire to provide a core building block for the future of Linux application development. Find Out More
image/svg+xml
image/svg+xml

Features include:

Capture and playback of audio and video with minimal latency.

Real-time Multimedia processing on audio and video.

Multiprocess architecture to let applications share multimedia content.

Seamless support for PulseAudio, JACK, ALSA and GStreamer applications.

Sandboxed applications support. See Flatpak for more info.

 

Getting PipeWire


An older version of PipeWire (0.2) that does not support the audio use cases should be available in most distributions.

If you want to get the code from GitLab then the latest PipeWire source code is available at GitLab. To clone the repository, just:

  $ git clone https://gitlab.freedesktop.org/pipewire/pipewire.git

Setup

PipeWire is using the Meson build system and we provide a convenience script and Makefile that makes building PipeWire fairly straightforward:

  $ ./autogen.sh --prefix=$PREFIX
  $ make
  $ make install
The $PREFIX is commonly set to /usr or /usr/local.

Running

You can test the PipeWire server from the source directory with:

  $ make run

To test video capture and display with SDL from the source directory, try in another window:

  $ make shell

This sets up the environment variables to run the example apps from the build directory like this:

  $ build/src/examples/video-play

You can play around with the other examples as well. Don't forget to set the correct environment variables as shown above or else the plugins and modules won't be found.

Documentation


There is some documentation to get started here.

Developers can alsa check out the (incomplete) PipeWire API documentation.

A collection of other useful pages can be found on the PipeWire wiki.

Get Involved


PipeWire is Free Software and is developed in the open. It was created by Wim Taymans, Principal Engineer at Red Hat and co-creator of the GStreamer multimedia framework. Code can be found on GitLab.

Join us on IRC at #pipewire on Freenode.

Issues are tracked on GitLab Issues.

We adhere to the Contributor Covenant for our code of conduct: Code of Conduct.