Skip to content
New issue

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

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

Already on GitHub? Sign in 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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in 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