Skip to content

dimtpap/obs-pipewire-audio-capture

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Audio device and application capture for OBS Studio using PipeWire

This plugin adds 3 sources for capturing audio outputs, inputs and applications using PipeWire Device capture properties App capture properties

Usage

Requirements

PipeWire 0.3.62 or later is highly recommended (#17, PipeWire#2874)

For the plugin to be able to capture applications, PipeWire should be set up to handle audio on your system. For most applications, the pipewire-pulse compatibility layer should be enough, but there are also pipewire-jack and pipewire-alsa. If applications aren't showing up in the plugin, your system may be missing one of those components.
See the PipeWire wiki for more info.

Binary installation

Get the linux-pipewire-audio-(version).tar.gz archive from the latest release
If OBS Studio is installed as a

  • Regular package: Extract the archive in ~/.config/obs-studio/plugins/
  • Flatpak:

Important

THIS INSTALLATION METHOD IS UNSUPPORTED BY THE OBS STUDIO TEAM AND CAN BREAK AT ANY TIME
This plugin relies on a Flatpak permission that OBS Studio could remove at any time, so it can't be on Flathub.
If after updating OBS Studio the plugin stops working, check the latest release for a new version, or build the plugin yourself against the latest OBS Studio.

Note that native OBS Studio packages do not have this problem.

  • Extract the archive in ~/.var/app/com.obsproject.Studio/config/obs-studio/plugins/
    • Note: If the plugin isn't working try running OBS using flatpak run --filesystem=xdg-run/pipewire-0 com.obsproject.Studio or run flatpak override --filesystem=xdg-run/pipewire-0 com.obsproject.Studio and then open OBS as usual

Building and installing

Ensure you have CMake, PipeWire and OBS Studio/libobs development packages, then in the repo's root:

cmake -B build -DCMAKE_INSTALL_PREFIX="/usr" -DCMAKE_BUILD_TYPE=RelWithDebInfo
cd build
make
make install #May need root

Inclusion in upstream OBS Studio

This plugin is currently in the process of being worked on to merge into upstream OBS Studio. See obsproject/obs-studio#6207