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

Document PulseAudio crash + workarounds #1900

Closed
pushfoo opened this issue Sep 13, 2023 · 2 comments · Fixed by #1922
Closed

Document PulseAudio crash + workarounds #1900

pushfoo opened this issue Sep 13, 2023 · 2 comments · Fixed by #1922

Comments

@pushfoo
Copy link
Member

pushfoo commented Sep 13, 2023

Documentation request:

tl;dr pyglet's PulseAudio backend can crash but using libopenal fixes it

Where should it be located?

The Linux install instructions

What needs to be added

  1. A brief summary of Pulse Audio Exception - Hard to Reproduce pyglet/pyglet#952
  2. An explanation of what packages to install

I've never experienced the bug mentioned, and today I found out it's because I've been using the openal backend the whole time.

@pushfoo
Copy link
Member Author

pushfoo commented Sep 23, 2023

Update:

  1. The pyglet instructions have a doc PR awaiting further review Warn about PulseAudio in the doc and rework related sections pyglet/pyglet#957
  2. Fixing the PulseAudio back-end is somewhat understood according to one pyglet contributor, but may take time since it's still an IPC issue
  3. We may be able to use the :external: directive with intersphinx to link a specific link target to make more durable links which don't 404

@pushfoo
Copy link
Member Author

pushfoo commented Sep 26, 2023

Update:

  1. The pyglet-side PR is merged: Warn about PulseAudio in the doc and rework related sections pyglet/pyglet#957
  2. Exploring the doc reveals there's currently no clear place to add this
  3. There are related pre-existing tickets regarding audio:
    1. Documentation Reorganization #1194
    2. Documentation: Sound compatibility recommendations #1274

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 a pull request may close this issue.

1 participant