RomanNum3ral
/
quickemu
mirror of https://github.com/quickemu-project/quickemu.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

docs(wiki): add Sequoia/Tahoe and audio support to macOS guide 

- Add Sequoia and Tahoe to supported releases list

- Add 'Audio support' section documenting sound card mapping and guidance
Martin Wimpress 2026-01-25 11:52:51 +00:00
parent 159a5dbbe5
commit 8efaca6494
No known key found for this signature in database
1 changed files with 22 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
03-Create-macOS-virtual-machines.md

@ -11,7 +11,7 @@ quickget macos big-sur
quickemu --vm macos-big-sur.conf
```
macOS `mojave`, `catalina`, `big-sur`, `monterey`, `ventura` and `sonoma` are supported.
macOS `mojave`, `catalina`, `big-sur`, `monterey`, `ventura`, `sonoma`, `sequoia` and `tahoe` are supported.
# OpenCore bootloader
@ -137,6 +137,8 @@ There are some considerations when running macOS via Quickemu.
- Monterey
- Ventura
- Sonoma
- Sequoia
- Tahoe
- `quickget` creates macOS VMs with integrated OpenCore by default (requires `mtools` and `gptfdisk`)
- `quickemu` will automatically download the required [OpenCore](https://github.com/acidanthera/OpenCorePkg) bootloader and OVMF firmware from [OSX-KVM](https://github.com/kholia/OSX-KVM) when using the legacy method.
- Optimised by default, but no GPU acceleration is available.
@ -149,12 +151,27 @@ There are some considerations when running macOS via Quickemu.
- UHCI (USB 2.0) on macOS Catalina and earlier.
- XHCI (USB 3.0) on macOS Big Sur and newer.
- Display resolution can be changed via `quickemu` using `--width` and `--height` command line arguments.
- **Full Duplex audio requires [VoodooHDA OC](https://github.com/chris1111/VoodooHDA-OC) or pass-through a USB audio-device to the macOS guest VM**.
- NOTE! [Gatekeeper](https://disable-gatekeeper.github.io/) and [System Integrity Protection (SIP)](https://developer.apple.com/documentation/security/disabling_and_enabling_system_integrity_protection) need to be disabled to install VoodooHDA OC
- File sharing between guest and host is available via [virtio-9p](https://wiki.qemu.org/Documentation/9psetup) and [SPICE
webdavd](https://gitlab.gnome.org/GNOME/phodav/-/merge_requests/24).
- File sharing between guest and host is available via [virtio-9p](https://wiki.qemu.org/Documentation/9psetup) and [SPICE webdavd](https://gitlab.gnome.org/GNOME/phodav/-/merge_requests/24).
- Copy/paste via SPICE agent is **not available on macOS**.
## Audio support
Quickemu automatically selects the correct sound card based on macOS version:
| macOS Version | Sound Card | Notes |
|---------------|------------|-------|
| Monterey, Ventura, Sonoma, Sequoia, Tahoe | `virtio-sound-pci` | Native VirtIO driver, works out-of-the-box |
| Big Sur | `ich9-intel-hda` | Requires VoodooHDA kext; unreliable from 11.3+ |
| Catalina and earlier | `intel-hda` | Requires VoodooHDA kext |
**Key points:**
- macOS 12 (Monterey) and later include a native VirtIO sound driver, so audio works without additional software.
- VoodooHDA stopped working reliably from macOS 11.3 onwards when injected via OpenCore.
- Big Sur audio remains problematic as a transitional version between the old HDA approach and native VirtIO support.
- For Big Sur and earlier, install [VoodooHDA OC](https://github.com/chris1111/VoodooHDA-OC) for audio support. Note that [Gatekeeper](https://disable-gatekeeper.github.io/) and [System Integrity Protection (SIP)](https://developer.apple.com/documentation/security/disabling_and_enabling_system_integrity_protection) must be disabled to install it.
- Alternatively, pass through a USB audio device to the macOS guest VM for reliable audio on any version.
## TSC instability on AMD Ryzen mobile CPUs
macOS Ventura (13), Sonoma (14), and Sequoia (15) have stricter TSC (Time Stamp Counter) requirements than earlier versions. On certain AMD Ryzen mobile CPUs, the TSC is marked as unstable during boot calibration, causing these newer macOS versions to freeze or fail to boot with "Non-monotonic time" errors.