Skip to content

fix(quickemu): select correct sound card for macOS guests#1826

Merged
flexiondotorg merged 1 commit intomasterfrom
macos-audio
Jan 25, 2026
Merged

fix(quickemu): select correct sound card for macOS guests#1826
flexiondotorg merged 1 commit intomasterfrom
macos-audio

Conversation

@flexiondotorg
Copy link
Member

  • Split macOS sound card logic by OS version:
    • Use virtio-sound-pci for macOS 12+ (Monterey and newer)
    • Use ich9-intel-hda for Big Sur
    • Keep intel-hda for earlier macOS releases
  • Add virtio-sound-pci case to configure_audio() to pair the device with existing audiodev backends (PulseAudio, PipeWire, ALSA, CoreAudio)
  • Update help text to include virtio-sound-pci as an allowed sound card option
  • Add virtio-sound-pci to allowed sound cards in sound_card_param_check()

VoodooHDA injected via OpenCore stopped working from macOS 11.3+ onwards and usb-audio proved unreliable for Big Sur+. virtio-sound-pci works natively on macOS 12+ without kexts and fixes guest audio for affected versions.

Fixes #1642

Type of change

  • Bug fix (non-breaking change which fixes an issue)
  • Documentation (updates the documentation)

Checklist:

  • I have performed a self-review of my code
  • I have made corresponding changes to the documentation (remove if no documentation changes were required)

- Split macOS sound card logic by OS version:
  - Use virtio-sound-pci for macOS 12+ (Monterey and newer)
  - Use ich9-intel-hda for Big Sur
  - Keep intel-hda for earlier macOS releases
- Add virtio-sound-pci case to configure_audio() to pair the device with
  existing audiodev backends (PulseAudio, PipeWire, ALSA, CoreAudio)
- Update help text to include virtio-sound-pci as an allowed sound card
option
- Add virtio-sound-pci to allowed sound cards in
sound_card_param_check()

VoodooHDA injected via OpenCore stopped working from macOS 11.3+
onwards and usb-audio proved unreliable for Big Sur+. virtio-sound-pci
works natively on macOS 12+ without kexts and fixes guest audio for
affected versions.

Fixes #1642

Signed-off-by: Martin Wimpress <martin@wimpress.org>
Copy link
Contributor

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 1 file

Confidence score: 5/5

  • Automated review surfaced no issues in the provided summaries.
  • No files require special attention.

@flexiondotorg
Copy link
Member Author

I've updated the wiki to document the audio support changes. You can find the new section here: https://github.com/quickemu-project/quickemu/wiki/03-Create-macOS-virtual-machines#audio-support

@flexiondotorg flexiondotorg merged commit eb54549 into master Jan 25, 2026
4 of 5 checks passed
@flexiondotorg flexiondotorg deleted the macos-audio branch January 25, 2026 11:55
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.

feat: Audio for macOS (12.0+) guests using Virtio Sound device.

1 participant