MCPcopy Index your code
hub / github.com/dimtpap/obs-pipewire-audio-capture

github.com/dimtpap/obs-pipewire-audio-capture @1.2.1

Chat with this repo
repository ↗ · DeepWiki ↗ · release 1.2.1 ↗ · + Follow
205 symbols 417 edges 5 files 25 documented · 12% updated 9d ago1.2.1 · 2025-09-05★ 76715 open issues
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

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.

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/
Your files should look like this /home/user/.config/obs-studio/plugins ├── linux-pipewire-audio │ ├── bin │ │ └── 64bit │ │ └── linux-pipewire-audio.so │ └── data │ └── locale │ ... - 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 run flatpak override --filesystem=xdg-run/pipewire-0 com.obsproject.Studio

Building (for development)

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
cmake --build build
# To install it system-wide:
cmake --install build

Inclusion in upstream OBS Studio

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

Core symbols most depended-on inside this repo

Shape

Function 99
Class 93
Enum 13

Languages

C87%
C++13%

Modules by API surface

src/pipewire-audio-capture-app.c80 symbols
src/pipewire-audio.c59 symbols
src/pipewire-audio-capture-device.c37 symbols
src/pipewire-audio.h26 symbols
src/linux-pipewire-audio.c3 symbols

For agents

$ claude mcp add obs-pipewire-audio-capture \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page