Skip to content
New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

config/media/pipewire: rewrite for clarity #772

Merged
merged 3 commits into from
Oct 27, 2023

Conversation

classabbyamp
Copy link
Member

@classabbyamp classabbyamp commented Sep 5, 2023

it seems a lot of people have trouble with this guide, and there's a lot of forks/options at each step. This rewrites the guide to streamline it into "basic setup" (wireplumber and optionally pw-pulse) and "optional setup" (everything else).

Also, this only documents the conf.d method as it's the most straightforward (IMO) and provides consistent results (wrt launch order and ensuring things are launched). I don't think we need to document every single option and overwhelm users, this guide is already very verbose.

closes #672

Still TODO:

  • improve Troubleshooting section with common errors and spurious errors
  • is the video group needed for video streams (like webcams) without elogind?
  • should the guide also have something about wayland screensharing with pipewire?

@classabbyamp classabbyamp marked this pull request as ready for review October 27, 2023 15:17
for xinitrc "starting arbitrary programs". starting pipewire in the
xinitrc isn't practical unless using a user dbus service.
@classabbyamp
Copy link
Member Author

tested in a freshly-installed VM to ensure things work and collect common error messages.

src/config/media/pipewire.md Outdated Show resolved Hide resolved
Copy link
Member

@ahesford ahesford left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks good to me.

src/config/media/pipewire.md Outdated Show resolved Hide resolved
src/config/media/pipewire.md Outdated Show resolved Hide resolved
@classabbyamp classabbyamp force-pushed the pw-rewrite branch 3 times, most recently from 4cf9fa2 to 2b74fb3 Compare October 27, 2023 15:55
it seems a lot of people have trouble with this guide, and there's a lot
of forks/options at each step. This rewrites the guide to streamline it
into "basic setup" (wireplumber and optionally pw-pulse) and "optional
setup" (everything else).

Also, this only documents the conf.d method as it's the most
straightforward (IMO) and provides consistent results (wrt launch order
and ensuring things are launched). I don't think we need to document
every single option and overwhelm users, this guide is already very verbose.
@classabbyamp classabbyamp merged commit 47787d2 into void-linux:master Oct 27, 2023
4 checks passed
@classabbyamp classabbyamp deleted the pw-rewrite branch October 27, 2023 20:29
# for free to join this conversation on GitHub. Already have an account? # to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Pipewire documentation is unclear to many users
4 participants