Update on Audio Troubleshooting Guide #1336

marwinpinlac-web · 2025-11-12T19:59:24Z

Updated the file: audio.md

Added new images and removed unnecessary command line images.

…nd removed images that are not in use.

Socialhappiness

Suggested re-ordering and a few corrections, but this is a great update, good job!

Socialhappiness · 2025-11-12T20:19:43Z

content/audio.md

+
+Below are set of commands that can be used to detect various information about your audio device.
+
+To list all detected audio devices:


Remove 'To' and just start with 'List' throughout article

Socialhappiness · 2025-11-12T20:21:52Z

content/audio.md

+
+If not, this may be a driver issue.
+
+## Verify if the Correct Device is Selected


Can "Verify the correct device is selected" be the first section of the article? It might be a new user visiting the article.

Socialhappiness · 2025-11-12T20:23:33Z

content/audio.md

+
+## Restart the Audio Services

 If the system is not playing audio, first try restarting the audio daemon:


Restart the audio daemon

Socialhappiness

Changes with reordering look good!

jacobgkau · 2025-11-26T23:16:44Z

content/audio.md

+
+## Verify Audio Devices Detected by the System
+
+Below are set of commands that can be used to detect various information about your audio device.


Below are set of commands isn't correct grammar. It should be Below is a set of commands.

I would simplify can be used to detect various information about to something like to display information about.

jacobgkau · 2025-11-26T23:17:29Z

content/audio.md

-| `systemctl --user restart pulseaudio` | `systemctl --user restart wireplumber pipewire pipewire-pulse` |
-| `rm -r ~/.config/pulse` |  `rm -r ~/.config/pulse` |
-| `pulseaudio -k` | |
+Go to <u>Launcher</u> and search for Sound:


We don't need to do the underline thing for the Launcher-- it doesn't really serve a purpose. It might be good to say how to open the Launcher.

jacobgkau · 2025-11-26T23:19:48Z

content/audio.md

+
+Below are set of commands that can be used to detect various information about your audio device.
+
+List all detected audio devices:


This command's only for output devices (as the next one's only for input devices).

jacobgkau · 2025-11-26T23:22:48Z

content/audio.md

+cat /proc/asound/cards
+```
+
+List kernel modules related to audio:


The output shows something like this:

01:00.1 Audio device: NVIDIA Corporation Device 2f80 (rev a1) Subsystem: NVIDIA Corporation Device 0000 Kernel driver in use: snd_hda_intel Kernel modules: snd_hda_intel

I'd go into a bit more detail and say List loaded drivers and available kernel modules for each PCI audio device:

jacobgkau · 2025-11-26T23:23:11Z

content/audio.md

+
+Your audio devices should appear in these lists.
+
+If not, this may be a driver issue.


Please combine this sentence with the line above it so it's a single paragraph.

I'd slightly rephrase the last sentence to If not, there may be a driver issue.

jacobgkau · 2025-11-26T23:38:07Z

content/audio.md

-If the output from that command is blank, then your system isn't detecting any sound cards (which could indicate a hardware issue.)
+![audio_10](images/audio/audio_10.png)

 ## Other Useful Commands


Let's take this opportunity to make the usage of apt install --reinstall vs apt reinstall consistent. They do the same thing, so I'd just go with apt reinstall.

jacobgkau · 2025-11-26T23:39:30Z

content/audio.md

+## Installing Sound Open Firmware Binaries

-### Audio crackling or hardware clicking
+This firmware is essential for proper audio functionality on systems using Intel audio hardware that relies on Sound Open Firmware.


Please mention that this package is installed by default. The only reason it'd need to be manually installed is if it somehow got removed. (It's a recommends of linux-firmware, which is a dependency of our kernel package.)

jacobgkau · 2025-11-26T23:40:19Z

content/audio.md

+This firmware is essential for proper audio functionality on systems using Intel audio hardware that relies on Sound Open Firmware.

-If you hear audio crackling (especially when you start or stop playing audio), your audio card may be going to sleep too often. This is known to happen on some versions of the [Serval WS](/articles/serval-dac/) and some [Thunderbolt docks](https://github.com/system76/docs/issues/491).
+To install, run the command:


commands should be plural if you're going to include the update/upgrade commands first. (The upgrade command isn't strictly on-topic for these code blocks.)

jacobgkau · 2025-11-26T23:40:46Z

content/audio.md

 ```

-#### Prevent Crackling with PulseAudio
+## Installing Alsa Firmware Loaders


ALSA should always be all-caps.

jacobgkau · 2025-11-26T23:42:17Z

content/audio.md

 When the script is finished gathering information, type <kbd>y</kbd> and press Enter to upload your output to the ALSA website, then send the link to Support.

-![alsa-info](/images/audio/alsa-info.png)
+![audio_11](images/audio/audio_11.png)


Why are these screenshots so low-resolution? You should be able to include normal-resolution screenshots without shrinking them. Convert them to JPG if the default PNGs are too large.

marwinpinlac-web added 2 commits November 13, 2025 03:39

Add audio screenshots

d2fa1ea

Applied changes in audio.md, added images necessarry for the update a…

17eba07

…nd removed images that are not in use.

Socialhappiness requested changes Nov 12, 2025

View reviewed changes

fixed lint error, reordered and made updates on audio.md

da1f753

Socialhappiness approved these changes Nov 13, 2025

View reviewed changes

Socialhappiness requested a review from thomas-zimmerman November 13, 2025 17:59

Socialhappiness requested a review from a team November 24, 2025 18:47

jacobgkau requested changes Nov 26, 2025

View reviewed changes


		Below are set of commands that can be used to detect various information about your audio device.

		To list all detected audio devices:


		If not, this may be a driver issue.

		## Verify if the Correct Device is Selected


		## Restart the Audio Services

		If the system is not playing audio, first try restarting the audio daemon:


		## Verify Audio Devices Detected by the System

		Below are set of commands that can be used to detect various information about your audio device.


		Below are set of commands that can be used to detect various information about your audio device.

		List all detected audio devices:


		Your audio devices should appear in these lists.

		If not, this may be a driver issue.

Update on Audio Troubleshooting Guide #1336

Are you sure you want to change the base?

Update on Audio Troubleshooting Guide #1336

Conversation

marwinpinlac-web commented Nov 12, 2025

Uh oh!

Socialhappiness left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Socialhappiness left a comment

Choose a reason for hiding this comment

Uh oh!

jacobgkau Nov 26, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

jacobgkau Nov 26, 2025 •

edited

Loading