WirePlumberのソースを表示

[[Category:マルチメディア]]
{{Related articles start}}
{{Related|PipeWire}}
{{Related articles end}}

[https://pipewire.pages.freedesktop.org/wireplumber WirePlumber] is a powerful session and policy manager for [[PipeWire]]. Based on a modular design, with Lua plugins that implement the actual management functionality, it is highly configurable and extendable.

== Installation ==

[[Install]] the {{Pkg|wireplumber}} package. It will conflict with other PipeWire Session Managers and make sure they are uninstalled.

WirePlumber uses [[systemd/User]] for management of the server and automatic socket activation.

Optionally, install {{Pkg|wireplumber-docs}} to review the documentation.

== Configuration ==
WirePlumber's modular design confers lots of flexibility when it comes to swapping the implementation of a specific functionality without having to re-implement the rest of it. Detailed information can be found at the [https://pipewire.pages.freedesktop.org/wireplumber/configuration.html official documentation].

Bellow we add examples of simple configurations.

=== Changing a device/node property ===

To change a device or node property, such as it's description or nick, you must create a Lua script and add it into {{ic|~/.config/wireplumber}} under the proper path and name.

For instance, to change the description of an ALSA node, you would create a file such as {{ic|~/.config/wireplumber/main.lua.d/51-alsa-rename.lua}} with the following content:
{{hc|head=51-alsa-rename.lua|output=rule = {
  matches = {
    {
      { "node.name", "equals", "alsa_output.pci-0000_00_1f.3.output_analog-stereo" },
    },
  },
  apply_properties = {
    ["node.description"] = "Laptop",
  },
}

table.insert(alsa_monitor.rules,rule)}}

If instead you wish to change something on a Bluetooth node or device, you could create {{ic|~/.config/wireplumber/bluetooth.lua.d/51-rename.lua}} with a content such as:
{{hc|head=51-rename.lua|output=rule = {
  matches = {
    {
      { "node.name", "equals", "bluez_output.02_11_45_A0_B3_27.a2dp-sink" },
    },
  },
  apply_properties = {
    ["node.nick"] = "Headphones",
  },
}

table.insert(bluez_monitor.rules,rule)}}

The Lua scripts' filenames and locations are thus devised in a way that allows [https://pipewire.pages.freedesktop.org/wireplumber/configuration/config_lua.html#multi-path-merging WirePlumber's Multi-path merging] to run them just after the default config files (e.g. {{ic|/usr/share/wireplumber/main.lua.d/50-alsa-config.lua}}) but before the file that loads and enables the devices (e.g. {{ic|/usr/share/wireplumber/main.lua.d/90-enable-all.lua}}).

The properties that you can change as well as the matching rules to select devices or nodes are documented at [https://pipewire.pages.freedesktop.org/wireplumber/configuration/alsa.html ALSA configuration] and [https://pipewire.pages.freedesktop.org/wireplumber/configuration/bluetooth.html Bluetooth configuration].

== See also ==

* [https://pipewire.pages.freedesktop.org/wireplumber/ Documentation] — Official documentation
* [https://www.collabora.com/news-and-blog/blog/2020/05/07/wireplumber-the-pipewire-session-manager/ WirePlumber, the PipeWire session manager] — Blog post by George Kiagiadakis (Collabora) from May 2020, detailing how WirePlumber works