gentoo auto-resync : 29:07:2022 - 09:06:52

5 files changed, 147 insertions, 17 deletions

diff --git a/metadata/news/2022-07-29-pipewire-sound-server/2022-07-29-pipewire-sound-server.en.txt b/metadata/news/2022-07-29-pipewire-sound-server/2022-07-29-pipewire-sound-server.en.txt
new file mode 100644
index 000000000000..0cb4a2d73ddf
--- /dev/null
+++ b/metadata/news/2022-07-29-pipewire-sound-server/2022-07-29-pipewire-sound-server.en.txt
@@ -0,0 +1,130 @@
+Title: PipeWire sound server migration
+Author: Sam James <sam@gentoo.org>
+Posted: 2022-07-29
+Revision: 1
+News-Item-Format: 2.0
+Display-If-Installed: media-video/pipewire
+Display-If-Installed: media-sound/pulseaudio
+Display-If-Installed: media-sound/pulseaudio-daemon
+Display-If-Installed: media-libs/libpulse
+
+PipeWire has gained a new USE flag "sound-server" for enabling/disabling its
+sound server capabilities.
+
+This change is needed to avoid PipeWire and PulseAudio conflicting over control
+of audio devices. Before this change, OpenRC users were in some cases
+accidentally migrated to PipeWire which was difficult to override without
+manually editing launcher files.
+
+For non-audio purposes, PipeWire is installed in many configurations as more
+and more software depends on it for e.g. screensharing, sandboxing,
+and window previews, so users will need to act based on their preferred
+setup rather than simply avoiding installing PipeWire, as it is
+increasingly required as a dependency.
+
+Packages needing PulseAudio's APIs will be migrated from the now-meta package
+media-sound/pulseaudio to depending on media-libs/libpulse. The runtime
+PulseAudio server can be provided by either PipeWire (media-video/pipewire)
+or the original PulseAudio (media-sound/pulseaudio-daemon).
+
+The new sound-server USE flag for PipeWire allows easily controlling
+this behavior.
+
+There are several options available:
+
+1. To use PipeWire for sound, users should enable USE=sound-server for PipeWire:
+
+  Place the following entries in /etc/portage/package.use:
+  ```
+  media-video/pipewire sound-server
+  media-sound/pulseaudio -daemon
+  ```
+
+  First, sync:
+  # emerge --sync
+
+  Deselect media-sound/pulseaudio-daemon:
+  # emerge --deselect media-sound/pulseaudio-daemon
+
+  Then perform a world upgrade:
+  # emerge --ask --update --changed-use --deep @world
+
+  Then depclean:
+  # emerge --ask --depclean
+
+  OpenRC users on an XDG-compliant desktop which respects autostart files
+  will not need to take any further action.
+
+  OpenRC users using a minimal desktop which does not respect autostart
+  files will need to run `gentoo-pipewire-launcher &` in e.g.
+  `~/.xprofile`.
+
+  systemd users will also need to run the following commands:
+  $ systemctl --user --now disable pulseaudio.service pulseaudio.socket
+  $ systemctl --user --now enable pipewire.socket pipewire-pulse.socket
+  $ systemctl --user --now disable pipewire-media-session.service
+  $ systemctl --user --force enable wireplumber.service
+
+2. To use PulseAudio's daemon for sound, users should disable USE=sound-server
+  for PipeWire, enable USE=daemon on media-sound/pulseaudio, and add
+  media-sound/pulseaudio-daemon to their world file:
+
+  Place the following entries in /etc/portage/package.use:
+  ```
+  media-video/pipewire -sound-server
+  media-sound/pulseaudio daemon
+  ```
+
+  Add media-sound/pulseaudio-daemon to @world:
+  # emerge --noreplace media-sound/pulseaudio-daemon
+
+  Then perform a world upgrade:
+  # emerge --ask --update --changed-use --deep @world
+
+  Then depclean:
+  # emerge --ask --depclean
+
+  OpenRC users on an XDG-compliant desktop which respects autostart files
+  will not need to take any further action.
+
+  OpenRC users using a minimal desktop which does not respect autostart
+  files should consider adding `gentoo-pipewire-launcher &` in e.g.
+  `~/.xprofile` but it's not strictly required in terms of audio
+  handling. It may be required in future for the non-audio usecases
+  described above.
+
+  systemd users will also need to run the following commands:
+  $ systemctl --user --now enable pulseaudio.service pulseaudio.socket
+  $ systemctl --user --now disable pipewire.socket pipewire-pulse.socket
+
+3. For users without sound on their system, those using JACK without
+   PipeWire, or those using pure ALSA without PipeWire, the following steps
+   are recommended:
+
+   Place the following entries in /etc/portage/package.use:
+   ```
+   media-video/pipewire -sound-server
+   media-sound/pulseaudio -daemon
+   ```
+
+   Then perform a world upgrade:
+   # emerge --ask --update --changed-use --deep @world
+
+   Then depclean:
+   # emerge --ask --depclean
+
+   OpenRC users on an XDG-compliant desktop which respects autostart files
+   will not need to take any further action.
+
+   OpenRC users using a minimal desktop which does not respect autostart
+   files will need to run `gentoo-pipewire-launcher &` in e.g.
+   `~/.xprofile`.
+
+   systemd users will also likely want to run the following commands, again
+   for the purposes of non-audio PipeWire use:
+   $ systemctl --user --now enable pipewire.socket
+   $ systemctl --user --now --force enable wireplumber.service
+
+
+Further resources:
+* https://wiki.gentoo.org/wiki/PipeWire
diff --git a/metadata/news/Manifest b/metadata/news/Manifest
index 4d7e5f04f8f4..1458c6e7ef7f 100644
--- a/metadata/news/Manifest
+++ b/metadata/news/Manifest
@@ -1,23 +1,23 @@
 -----BEGIN PGP SIGNED MESSAGE-----
 Hash: SHA512
 
-MANIFEST Manifest.files.gz 13864 BLAKE2B 373887a06bb63946485d0b9e08e52b3b3c3fbeda530b58fbe19569ccedfd0a8f7c63f073261fcef68edcbf9331108cf543382117b2f60c464926fff49fff9e18 SHA512 b3adafe44390700af75c3b98d6b21ba11902c1f2033fb07a8064382a68a6b6c023b73b318e0a8159e5911175172732771aae9261f870aee90bb5b6e69de3f24d
-TIMESTAMP 2022-07-29T00:40:03Z
+MANIFEST Manifest.files.gz 14055 BLAKE2B cc8989d376b82bcdb8980643cfd55acab354a49641b1b95506a263a9406db16da70c2af5a10755e35d180167a8123cedb0da0411496add38143d06cd2295da30 SHA512 4c08ccde16f1dafbb970968ef0ea2bc4a0d1775c0b6a687dc12042e322b948a5c4a0b48efd1d01d039c0971c8836c30c44f1f4fad1679d7fa254072281c88eff
+TIMESTAMP 2022-07-29T06:39:36Z
 -----BEGIN PGP SIGNATURE-----
 
-iQKTBAEBCgB9FiEE4dartjv8+0ugL98c7FkO6skYklAFAmLjLGNfFIAAAAAALgAo
+iQKTBAEBCgB9FiEE4dartjv8+0ugL98c7FkO6skYklAFAmLjgKhfFIAAAAAALgAo
 aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldEUx
 RDZBQkI2M0JGQ0ZCNEJBMDJGREYxQ0VDNTkwRUVBQzkxODkyNTAACgkQ7FkO6skY
-klBnVRAAjH6NCBLISFIGypzk9pG82/p0c08LUiYDbjfdQm15EQQnJXViQt3KA1lH
-KcuIKt48aU5svgd1giM65c3HDLeAb98uGegV5Ym06OYLDQY1la4eIBUfr6O+AyXz
-l7yv9gyfE0VLO22n6YFKSo/y+hq8QhpG0IIk7TbR4IbODMoXKcPY7ED6RiqfDF2I
-ou6P/+PCuwRzIGc0KmkZ/c6Xk84hPPldgFZVl2EW/bmvCJKl/izfhsMY7GgfYMs4
-VMM0Qs4q+PigF+3gXlmGcvCWAE/1+MTzT/gCGbYV+ttwi7yRKkFLe952Hntepi1d
-n6iun8lDk5EX+q/H01Hc71tke98e0b+PjLBMPgGtFLg1peZWfXpiH1YfbvZQtJxs
-taWBbjVlFAz5NJ3PTALnpCO+/4gN86gUP9XkQ57auRdy6LRwgUlFfWmlMv0csNW4
-ih2+TiMU/waD9ZUlIhLq0GH6NHZBz0YaRTADOrwJp/0NCWbXKFSxRGGgs7HLyFSF
-ZRxG+UbyUhmrzSmDu6NsXAB+D95IDW5i5OT9KJaOa0irs0qLpLUgxB/QL6lnVDuk
-qNO2IxjVO8VJjszwviiqiBdb1wMeskmx/peGrTzYxpaY9Bikel2lFm7RjcM8IKHK
-ANnpstdwfIpaLwplL7NLu1T20fWPuJJxx8vb4b+1IwISEnvuxIY=
-=OjJm
+klC8Dw//UxNmsapKe+hSujpcp5TrfloYSPd2B3Ybr3cAKC0XSIzHO8qnyFTXxgaV
+iJ7V+z2xDTIFrT5a9wA5A7JYwvfUFu+jYBabxf6Tw20YgGAzF/bQH9SdeVthej3F
+t069crZQK8c/LaU/NjuMjCjrx6PS1z1QpX8HJnwOnzzVnP/bK1CvpUiBZo+7nqn2
+1WsvE2chDvNbp/uGh8KNmn6IgB8wym3dX2qqOrDx3MTRyGs5AvYWPxs4nmBARPtM
+eExMVoXTUSd9y3qe8m6QDhbj+znt3G9xSKjej/CK2IZ1g2p00ornmLFbLXauepdj
+juD/UuWRAKBSnyHUGN6Liu+Lj4+mDe20VdrdazFDYNM+7vt3g9XIhMUEaTz6bvTh
+E0JUyfwnurB2W5uEO7Sf/mC0ec9Rll6spJmdiRpQIqosa5ompYIVSNxvAH/XsKvL
+5lrMMvGUVt5jxCIbMhPgZYy2sIsKzx/e+peTgZk7eNDrEIKTYOTNAouJkfNDieRb
+iDGyhclcjO9wJhMPOJ8RwsCPk7xy2N0YkxDCotNuJytcILSZZX8VjasPXUTR3Szb
+0QasivdCtZx6eUVvMrYvCPaVHhfbUnU8cjZRymM0wvFWbSAk8bPQ8dBs6Qfwfvhe
+VpvBrDvNErgcOwixlY+CzBL7ISeGSaxmBZgs14oVKxJt4N5NSYI=
+=pJBU
 -----END PGP SIGNATURE-----
diff --git a/metadata/news/Manifest.files.gz b/metadata/news/Manifest.files.gz
index cd92c07505d9..5842e1145792 100644
--- a/metadata/news/Manifest.files.gz
+++ b/metadata/news/Manifest.files.gz
diff --git a/metadata/news/timestamp.chk b/metadata/news/timestamp.chk
index 21ef0f0cad48..3a92001c120f 100644
--- a/metadata/news/timestamp.chk
+++ b/metadata/news/timestamp.chk
@@ -1 +1 @@
-Fri, 29 Jul 2022 00:40:00 +0000
+Fri, 29 Jul 2022 06:39:33 +0000
diff --git a/metadata/news/timestamp.commit b/metadata/news/timestamp.commit
index c869f5e6214f..b5c37d17557d 100644
--- a/metadata/news/timestamp.commit
+++ b/metadata/news/timestamp.commit
@@ -1 +1 @@
-8c8dc9f31a085eedd1fc8b96bba8d883f3239310 1658765725 2022-07-25T16:15:25+00:00
+1d217ffd5deca9d20b61acd2a7832272d036a0e0 1659059087 2022-07-29T01:44:47+00:00