Skip to content

Document T1 CS8409 speaker workaround on Mac support page - #15776

Open
Alkarth2010 wants to merge 2 commits into
omacom:quattrofrom
Alkarth2010:docs/t1-cs8409-speakers
Open

Alkarth2010 wants to merge 2 commits into
omacom:quattrofrom
Alkarth2010:docs/t1-cs8409-speakers

Conversation

@Alkarth2010

Copy link
Copy Markdown

The Mac support page currently says T1 sound is not functioning. On MacBookPro13,2 (2016 13-inch with Touch Bar) running Omarchy 4.0.4 / kernel 7.2.5-3-omarchy, internal speakers work after installing davidjo/snd_hda_macbookpro via DKMS.

Stock snd_hda_codec_cs8409 loads and PipeWire shows Built-in Audio Analog Stereo, but the mainline codec never powers the speaker amps. This PR documents that workaround on the T1 known-issues list: packages via omarchy pkg add, ./install.cirrus.driver.sh -i, reboot (or unload snd_hda_intel first if reloading without reboot), and the success checks.

This does not ship the module in the ISO. Same CS8409 stack exists on other 2016–2017 Intel Macs; the write-up only claims MacBookPro13,2.

Discussion with the full recipe: #15775

Stock snd_hda_codec_cs8409 leaves 2016 Touch Bar Mac speakers silent.
Record the davidjo DKMS install that restored sound on MacBookPro13,2.
@greptile-apps

greptile-apps Bot commented Oct 17, 2026 •

Copy link
Copy Markdown
Contributor

RetriggerView in GreptileConfidence Score: 5/5

[Low impact] The documentation changes appear safe to merge.

Summary

Documents an optional speaker workaround for MacBookPro13,2.

  • MacBookPro13,2 owners can follow a documented speaker workaround.

Reviews (2) · Last reviewed commit: "Keep the driver clone, and reboot rather..." · Reviewed by Greptile

@omarchybot omarchybot added the documentation Improvements or additions to documentation label Oct 18, 2026
The installer links /usr/src/snd_hda_macbookpro-0.1 to the clone instead of copying it, so a user who deletes the clone after installing loses the DKMS rebuild on the next kernel update. The no-reboot reload named no codecs and left PipeWire holding the device, so it would fail with "in use"; reboot is the procedure the commands already end on.

Co-Authored-By: Codex Medium <noreply@openai.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@omarchybot omarchybot added verified Omarchy Triage has verified that this issue is ready for final review ready Good to merge labels Oct 18, 2026
@omarchybot

Copy link
Copy Markdown
Collaborator

Thanks for writing this up. I checked the new section against Omarchy at this head and against the upstream davidjo/snd_hda_macbookpro sources: omarchy pkg add installs the packages without a system upgrade, linux-omarchy-headers matches the kernel T1 Macs run, install.cirrus.driver.sh -i does a DKMS install, the script fetches kernel source from cdn.kernel.org with wget, and the success checks (dkms status name, the updates/dkms path, the trying APPLE message) all match what the driver does. Nothing was run, since it is a Markdown-only change; I could not confirm playback, which needs the hardware.

Codex Medium reviewed it as a second opinion and found two things, both confirmed against the upstream scripts, and I pushed one commit to your branch (f36927a) to fix them:

  • The installer's dkms.sh links /usr/src/snd_hda_macbookpro-0.1 to the cloned directory rather than copying it, so deleting the clone after installing breaks the automatic rebuild on the next kernel update. The page now says to keep the clone, and that the rebuild downloads the new kernel's source again.
  • The no-reboot reload did not name the codec modules, and PipeWire holds the device open, so modprobe -r would fail with "in use". I removed it; the reboot your commands already end on is the procedure.

A second round from Codex Medium on the fix found nothing open. CI is green.

Related: #8285, #11064, #12689 and #12968 propose installing a CS8409 driver automatically. If one of those lands, this section will need updating to match. Whether the manual should point users at an out-of-tree driver is the maintainer's call, so this now waits on them.

@heymaaz

heymaaz commented Nov 2, 2026

Copy link
Copy Markdown

Independent confirmation on MacBookPro13,2 (2016 13-inch, four Thunderbolt 3 ports):

  • Stock driver: on 7.2.8-9-omarchy with the in-tree snd_hda_codec_cs8409, PipeWire showed the Built-in Audio speaker output, unmuted, but playback was silent. That is the state this PR describes.

  • With this driver: rebuilding and loading davidjo/snd_hda_macbookpro for the running kernel restored audible speaker playback. It had also fixed the speakers and internal microphone on 7.2.5. I haven't retested the microphone on 7.2.8-9.

  • Alternative install: I used the AUR package instead of cloning and running the script:

    omarchy pkg aur add snd-hda-macbookpro-dkms-git

One failure mode may be worth a line on the page. After a kernel update, the DKMS rebuild stopped while downloading kernel source (repeated IPv6 timeouts on my network). No module was built for the new kernel, so the in-tree module loaded and the speakers went silent, with nothing obviously wrong in PipeWire.

Your success checks (dkms status, the updates/dkms path) catch this, so it may help to say to re-run them after each kernel update. If the rebuild failed, the DKMS make.log under /var/lib/dkms/snd-hda-macbookpro/<version>/build/ shows why. On my network, retrying the download with wget forced to IPv4 fixed it.

My setup notes, including the recovery and post-reboot checks, are in this gist.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation verified Omarchy Triage has verified that this issue is ready for final review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants