Debugging Audio Issues

Debugging Audio Issues

A set of steps that users can run to gather technical details which may make it easier and faster for volunteers to debug their issues.

Target issues

  • Audio not working at all
  • Previously audio used to work but no longer does
  • Quality of audio playback is poor

Guidelines

This is a troubleshooting plan to gather relevant diagnostic information about your audio issues. The steps go from basic to more detailed information gathering.

  1. Search for existing threads in the support and help category category, perhaps refine that to audio-and-video tagged threads.
  2. Start a new topic in another tab.
  3. Open the collapsed “⯈Details” switch below.
  4. Run the commands, then paste the results of these commands separately, in your new topic.

Surround the text with three backticks “````” to format it for best readibility.

```
like this
```

Note: For many reasons, we prefer plain text over photographs of the screen, but appreciate that sometimes a system is so broken that it’s the only option. If that’s the case, please make effort to take clear, un-blurry, readable images.


Debugging sound issues

There’s a lot here. Feel free to put each response inside its own set of backticks, to keep them apart.

First, basic system information:

uname -a
lspci -v | grep -A7 -i "audio"
aplay -l
pactl info

Next, check for recent system updates that might have affected audio:

grep "install" /var/log/dpkg.log | tail -n 50

Check if PipeWire / PulseAudio is actually running:

systemctl --user status pipewire pipewire-pulse wireplumber

For real-time audio diagnostics:

pactl info
pactl list short sinks
pactl list | grep -A2 'State\|Name\|Volume\|Mute'

To check for audio-related errors:

journalctl -p 3 -xb | grep -i "pulse\|audio\|alsa"
sudo dmesg | grep -i "audio\|sound\|pulse\|alsa"

Let’s also check current audio settings and devices:

pw-cli ls
pacmd list-sinks

For system load that might affect audio:

top -b -n 1 | head -n 20
6 Likes

@popey More excellent tips. Would it be possible to make this into a sticky thread along the lines of what we had on UF?

That way we can direct users with audio issues directly to the relevant spot.

Just a thought.

We could, or we could have a sub-category called “Support Resources” or something, that we can direct people to? @ian-weisser had some ideas around this in the linked staff thread /t/support-snippets.

2 Likes

@popey I have revised the “start here” welcome page to separate audio and video into separate links.

Perhaps this page can grow into a child page of that welcome, replacing the current audio support link.

@rubi1200 The intent is for such child pages to be somewhat equivalent to those UF stickies. But editable, and found by new users in perhaps a different way.

2 Likes

Seems like it would bridge a gap between a higher level abstraction (templated solutions that are geared more towards being universal than standing as a particular example of an implementation). I think its possible to template a specific implementation too so that others can use it and get the same result.