Skip to content

Commit ef1fb7e

Browse files
committed
config/media/pipewire.md: remove instructions for pipewire-media-session
1 parent 34e9eff commit ef1fb7e

File tree

1 file changed

+15
-34
lines changed

1 file changed

+15
-34
lines changed

src/config/media/pipewire.md

Lines changed: 15 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -35,40 +35,21 @@ deprecated and the authors recommend using
3535
[WirePlumber](https://pipewire.pages.freedesktop.org/wireplumber/) in its place.
3636
Install the `wireplumber` package to use this session manager with PipeWire.
3737

38-
The standard Void configuration, which causes `pipewire` to launch
39-
`pipewire-media-session` automatically, must be overridden to use `wireplumber`.
40-
The only change necessary is to comment out the `pipewire-media-session`
41-
invocation in the `context.exec` section, which can be done with a single `sed`
42-
substitution. To make this configuration change visible to all users, place the
43-
new configuration file in `/etc/pipewire`:
44-
45-
```
46-
# mkdir -p /etc/pipewire
47-
# sed '/path.*=.*pipewire-media-session/s/{/#{/' \
48-
/usr/share/pipewire/pipewire.conf > /etc/pipewire/pipewire.conf
49-
```
50-
51-
Alternatively, place the new configuration file in the expected location for a
52-
single user:
53-
54-
```
55-
$ : "${XDG_CONFIG_HOME:=${HOME}/.config}"
56-
$ mkdir -p "${XDG_CONFIG_HOME}/pipewire"
57-
$ sed '/path.*=.*pipewire-media-session/s/{/#{/' \
58-
/usr/share/pipewire/pipewire.conf > "${XDG_CONFIG_HOME}/pipewire/pipewire.conf"
59-
```
60-
61-
> A custom `pipewire.conf` in either `/etc/pipewire` or
62-
> `${XDG_CONFIG_HOME}/pipewire` will prevent entirely the use of the default
63-
> system configuration. Users who override the default configuration to enable
64-
> `wireplumber` are encouraged to monitor the default configuration and
65-
> reconcile any changes with each `pipewire` update.
66-
67-
Now, configure `wireplumber` to start alongside `pipewire`. If your window
68-
manager or desktop environment auto-start mechanism is used to start `pipewire`,
69-
it is recommended to use the same mechanism for starting `wireplumber`. The
70-
`wireplumber` package includes a `wireplumber.desktop` Desktop Entry file that
71-
may be useful in this situation.
38+
> If you have installed an earlier version of the Void `pipewire` package, make
39+
> sure to update your system to eliminate any stale system configuration that
40+
> may attempt to launch `pipewire-media-session`. Users who previously overrode
41+
> the system configruation to use `wireplumber`, *e.g.* by placing a custom
42+
> `pipewire.conf` file in `/etc/pipewire` or `${XDG_CONFIG_HOME}/pipewire`, may
43+
> wish to reconcile these overrides with `/usr/share/pipewire/pipewire.conf`
44+
> installed by the most recent `pipewire` package. If the sole purpose of a
45+
> prior override was to disable `pipewire-media-session`, deleting the custom
46+
> configuration may be sufficient.
47+
48+
There are several methods for starting `wireplumber` alongside `pipewire`. If
49+
your window manager or desktop environment auto-start mechanism is used to start
50+
`pipewire`, it is recommended to use the same mechanism for starting
51+
`wireplumber`. The `wireplumber` package includes a `wireplumber.desktop`
52+
Desktop Entry file that may be useful in this situation.
7253

7354
> Be aware that `wireplumber` must launch *after* the `pipewire` executable. The
7455
> Desktop Application Autostart Specification makes no provision for ordering of

0 commit comments

Comments
 (0)