Skip to content

Commit a7ce9d9

Browse files
committed
config/media/pipewire.md: document launching pipewire-pulse from pipewire
1 parent ef1fb7e commit a7ce9d9

File tree

1 file changed

+22
-6
lines changed

1 file changed

+22
-6
lines changed

src/config/media/pipewire.md

Lines changed: 22 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ Install the `wireplumber` package to use this session manager with PipeWire.
3838
> If you have installed an earlier version of the Void `pipewire` package, make
3939
> sure to update your system to eliminate any stale system configuration that
4040
> may attempt to launch `pipewire-media-session`. Users who previously overrode
41-
> the system configruation to use `wireplumber`, *e.g.* by placing a custom
41+
> the system configuration to use `wireplumber`, *e.g.* by placing a custom
4242
> `pipewire.conf` file in `/etc/pipewire` or `${XDG_CONFIG_HOME}/pipewire`, may
4343
> wish to reconcile these overrides with `/usr/share/pipewire/pipewire.conf`
4444
> installed by the most recent `pipewire` package. If the sole purpose of a
@@ -71,6 +71,7 @@ directly. This can be accomplished by running
7171
for system configurations or, for per-user configurations, running
7272

7373
```
74+
$ true "${XDG_CONFIG_HOME:=${HOME}/.config}"
7475
$ mkdir -p "${XDG_CONFIG_HOME}/pipewire/pipewire.conf.d"
7576
$ echo 'context.exec = [ { path = "/usr/bin/wireplumber" args = "" } ]' \
7677
> "${XDG_CONFIG_HOME}/pipewire/pipewire.conf.d/10-wireplumber.conf"
@@ -113,10 +114,25 @@ Server Name: PulseAudio (on PipeWire 0.3.18)
113114
```
114115

115116
Once you confirmed that `pipewire-pulse` works as expected, it's recommended to
116-
autostart it from the same place where you start PipeWire. It is possible to
117-
modify [pipewire.conf(5)](https://man.voidlinux.org/pipewire.conf.5) for
118-
auto-starting the PulseAudio server, but it's not recommended keep the PipeWire
119-
configuration file unmodified for smoother future upgrades.
117+
autostart it from the same place where you start PipeWire. Alternatively, the
118+
`pipewire` configuration can be modified to launch `pipewire-pulse` directly:
119+
120+
```
121+
# mkdir -p /etc/pipewire/pipewire.conf.d
122+
# echo 'context.exec = [ { path = "/usr/bin/pipewire" args = "-c pipewire-pulse.conf" } ]' \
123+
> /etc/pipewire/pipewire.conf.d/20-pipewire-pulse.conf
124+
```
125+
126+
for system configurations, or
127+
128+
```
129+
$ true "${XDG_CONFIG_HOME:=${HOME}/.config}"
130+
$ mkdir -p "${XDG_CONFIG_HOME}/pipewire/pipewire.conf.d"
131+
$ echo 'context.exec = [ { path = "/usr/bin/pipewire" args = "-c pipewire-pulse.conf" } ]' \
132+
> ${XDG_CONFIG_HOME}/pipewire/pipewire.conf.d/20-pipewire-pulse.conf
133+
```
134+
135+
for per-user configurations.
120136

121137
## Bluetooth audio
122138

@@ -155,6 +171,6 @@ on glibc-based systems:
155171

156172
## Troubleshooting
157173

158-
The Pulseaudio replacement requires the
174+
The PulseAudio replacement requires the
159175
[`XDG_RUNTIME_DIR`](../session-management.html#xdg_runtime_dir) environment
160176
variable to work correctly.

0 commit comments

Comments
 (0)