# 使用 Homebrew, apk, apt, dnf, Nix, pacman, zypper 安装 wireplumber

查看 wireplumber 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:wireplumber
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install wireplumber
```

  证据: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add wireplumber
```

  证据: Alpine Linux edge package indexes: wireplumber from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install wireplumber
```

  证据: Debian stable package indexes: wireplumber from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install wireplumber
```

  证据: Fedora Rawhide package metadata: wireplumber from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#wireplumber
```

  证据: nixpkgs package indexes: pkgs/by-name/wi/wireplumber/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S wireplumber
```

  证据: Arch Linux sync databases: wireplumber from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install wireplumber
```

  证据: openSUSE Tumbleweed package metadata: wireplumber from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

## 软件包事实

- **软件包键:** brew:wireplumber
- **软件包管理器:** Homebrew
- **版本:** 0.5.15
- **来源摘要:** Session / policy manager implementation for PipeWire
- **主页:** <https://pipewire.pages.freedesktop.org/wireplumber/>
- **最后更新:** 2026-06-18T13:22:16Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- wireplumber (别名)
- wpctl (别名)
- wpexec (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 0.5.15
## 项目历史与用法

WirePlumber is a modular session and policy manager for PipeWire. It decides how PipeWire devices, nodes, streams, routes, permissions, and links are created and maintained so the low-level PipeWire media graph becomes a usable desktop, embedded, or specialized media system.

### 项目历史

PipeWire separates media transport from policy: the daemon exposes mechanisms for devices and applications to exchange media, while a session manager decides which components may talk and how they should be linked. WirePlumber was created by Collabora as a more capable replacement for PipeWire's limited example session manager, with a GObject-based library, modules, and scriptable policy.

Early WirePlumber releases were tied to Automotive Grade Linux, with the old release documentation identifying 0.1.0 as the first release shipped in AGL Happy Halibut 8.0.0. By 2020, Collabora was presenting WirePlumber as a general PipeWire session manager for desktop, embedded, professional, and non-professional audio/video use cases.

WirePlumber 0.3 was described by Collabora as ready for desktop use and a working drop-in replacement for `pipewire-media-session`. The project later went through a substantial 0.5 series redesign, including configuration, settings, policy, Bluetooth, and documentation changes, as PipeWire itself stabilized as a Linux multimedia foundation.

### 采用历史

WirePlumber's major desktop adoption moment came with Fedora 35 in November 2021, when Fedora switched to WirePlumber as the default PipeWire session manager. Collabora described this as WirePlumber entering the Linux desktop space after development since 2019 and earlier automotive adoption.

The Fedora change proposal framed the move as replacing a simple, mostly hardcoded example session manager with a more advanced, extensible, Lua-scriptable manager. That pattern then spread through distribution packaging, where WirePlumber commonly provides or conflicts with the PipeWire session-manager role.

### 使用方式

End users usually interact with WirePlumber indirectly through desktop sound settings, Bluetooth audio behavior, screen sharing, camera availability, and PipeWire routing. The service runs in the user session and continuously reacts to device and stream events.

Power users and integrators use WirePlumber configuration and tools such as `wpctl` to inspect or adjust defaults, volumes, devices, routes, and runtime settings. Distribution and product builders use its policy scripts and modules to encode behavior for desktops, embedded devices, automotive systems, or unusual audio hardware.

### 为什么软件包爱好者会关心

WirePlumber is a package-nerd marker for the modern Linux audio transition. If `pipewire-pulse` made applications believe PulseAudio was still there, WirePlumber made the PipeWire graph feel like a coherent desktop sound server rather than a pile of nodes.

Its importance is mostly visible when it breaks or is missing: devices do not route correctly, Bluetooth profiles misbehave, default sinks are not restored, or streams fail to move. That makes it one of those small-sounding desktop packages that actually carries a large part of the user experience.

### 时间线

- 2019: Collabora begins development of WirePlumber.
- 2019: WirePlumber 0.1.0 ships with Automotive Grade Linux Happy Halibut 8.0.0.
- 2020: WirePlumber 0.3 is announced as ready for desktop use and a drop-in replacement for pipewire-media-session.
- 2021: Fedora 35 adopts WirePlumber as the default PipeWire session manager.
- 2024: WirePlumber 0.5.0 lands with major configuration and policy changes for the PipeWire 1.x era.

### Related projects

- PipeWire is the media server and graph framework whose policy is managed by WirePlumber.
- pipewire-media-session was the simpler example session manager that WirePlumber replaced in many desktop distributions.

### 来源

- <https://docs.pipewire.org/page_session_manager.html>
- <https://fedoraproject.org/wiki/Changes/WirePlumber>
- <https://pipewire.pages.freedesktop.org/wireplumber/design/understanding_session_management.html>
- <https://pipewire.pages.freedesktop.org/wireplumber/resources/releases.html>
- <https://www.collabora.com/news-and-blog/blog/2020/05/07/wireplumber-the-pipewire-session-manager/>
- <https://www.collabora.com/news-and-blog/news-and-events/wireplumber-03-released-now-ready-for-the-desktop.html>
- <https://www.collabora.com/news-and-blog/news-and-events/wireplumber-in-fedora-35.html>


## 安全说明

generalized runtime or code generation signal.

- **Geiger 风险:** yellow / 中
- generalized runtime or code generation signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: $XDG_CONFIG_HOME/wireplumber/wireplumber.conf, $XDG_CONFIG_HOME/wireplumber/wireplumber.conf.d/*.conf, $sysconfdir/wireplumber/wireplumber.conf, $datadir/wireplumber/wireplumber.conf
## 其他软件包管理器记录

- Debian apt - gir1.2-wp-0.5 - 0.5.8-2: normalized package name match | Debian stable package indexes: gir1.2-wp-0.5 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | GObject introspection files for WirePlumber | https://gitlab.freedesktop.org/pipewire/wireplumber
- Debian apt - libwireplumber-0.5-0 - 0.5.8-2: normalized package name match | Debian stable package indexes: libwireplumber-0.5-0 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Shared libraries for WirePlumber | https://gitlab.freedesktop.org/pipewire/wireplumber
- Debian apt - libwireplumber-0.5-dev - 0.5.8-2: normalized package name match | Debian stable package indexes: libwireplumber-0.5-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Development files for WirePlumber | https://gitlab.freedesktop.org/pipewire/wireplumber
- Debian apt - wireplumber - 0.5.8-2: normalized package name match | Debian stable package indexes: wireplumber from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | modular session / policy manager for PipeWire | https://gitlab.freedesktop.org/pipewire/wireplumber
- Debian apt - wireplumber-doc - 0.5.8-2: normalized package name match | Debian stable package indexes: wireplumber-doc from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | modular session / policy manager for PipeWire - documentation | https://gitlab.freedesktop.org/pipewire/wireplumber
- Nix - wireplumber: normalized package name match | nixpkgs package indexes: pkgs/by-name/wi/wireplumber/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - gir1.2-wp-0.4 - 0.4.17-1ubuntu4: normalized package name match | Ubuntu 24.04 LTS package indexes: gir1.2-wp-0.4 from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | GObject introspection files for WirePlumber | https://gitlab.freedesktop.org/pipewire/wireplumber
- Ubuntu apt - libwireplumber-0.4-0 - 0.4.17-1ubuntu4: normalized package name match | Ubuntu 24.04 LTS package indexes: libwireplumber-0.4-0 from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | Shared libraries for WirePlumber | https://gitlab.freedesktop.org/pipewire/wireplumber
- Ubuntu apt - libwireplumber-0.4-dev - 0.4.17-1ubuntu4: normalized package name match | Ubuntu 24.04 LTS package indexes: libwireplumber-0.4-dev from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Development files for WirePlumber | https://gitlab.freedesktop.org/pipewire/wireplumber
- Ubuntu apt - wireplumber - 0.4.17-1ubuntu4: normalized package name match | Ubuntu 24.04 LTS package indexes: wireplumber from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | modular session / policy manager for PipeWire | https://gitlab.freedesktop.org/pipewire/wireplumber
- Ubuntu apt - wireplumber-doc - 0.4.17-1ubuntu4: normalized package name match | Ubuntu 24.04 LTS package indexes: wireplumber-doc from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | modular session / policy manager for PipeWire - documentation | https://gitlab.freedesktop.org/pipewire/wireplumber
- apk - wireplumber - 0.5.15-r0: normalized package name match | Alpine Linux edge package indexes: wireplumber from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Session / policy manager implementation for PipeWire | https://pipewire.org/
- apk - wireplumber-bash-completion - 0.5.15-r0: normalized package name match | Alpine Linux edge package indexes: wireplumber-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bash completions for wireplumber | https://pipewire.org/
- apk - wireplumber-dbg - 0.5.15-r0: normalized package name match | Alpine Linux edge package indexes: wireplumber-dbg from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Session / policy manager implementation for PipeWire (debug symbols) | https://pipewire.org/
- apk - wireplumber-dev - 0.5.15-r0: normalized package name match | Alpine Linux edge package indexes: wireplumber-dev from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Session / policy manager implementation for PipeWire (development files) | https://pipewire.org/
- apk - wireplumber-doc - 0.5.15-r0: normalized package name match | Alpine Linux edge package indexes: wireplumber-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Session / policy manager implementation for PipeWire (documentation) | https://pipewire.org/


## Combined YAML source

View the package source record on GitHub. [combined/wireplumber.yml](https://github.com/mxcl/pkgdb/blob/main/combined/wireplumber.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph