[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-70835":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":16,"stars30d":17,"stars90d":16,"forks30d":16,"starsTrendScore":16,"compositeScore":18,"rankGlobal":10,"rankLanguage":10,"license":10,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":21,"hasPages":19,"topics":22,"createdAt":10,"pushedAt":10,"updatedAt":33,"readmeContent":34,"aiSummary":35,"trendingCount":16,"starSnapshotCount":16,"syncStatus":36,"lastSyncTime":37,"discoverSource":38},70835,"macOS-Simple-KVM","foxlet\u002FmacOS-Simple-KVM","foxlet","Tools to set up a quick macOS VM in QEMU, accelerated by KVM.","",null,"Shell",13911,1142,237,328,0,6,44.17,false,"master",true,[23,24,25,26,27,28,29,30,31,32],"bigsur","catalina","hackintosh","high-sierra","kvm","linux","macos","mojave","qemu","virtual-machine","2026-06-12 02:02:44","# macOS-Simple-KVM\nDocumentation to set up a simple macOS VM in QEMU, accelerated by KVM.\n\nBy [@FoxletFox](https:\u002F\u002Ftwitter.com\u002Ffoxletfox), and the help of many others. Find this useful? You can donate [on Coinbase](https:\u002F\u002Fcommerce.coinbase.com\u002Fcheckout\u002F96dc5777-0abf-437d-a9b5-a78ae2c4c227) or [Paypal!](https:\u002F\u002Fwww.paypal.com\u002Fcgi-bin\u002Fwebscr?cmd=_donations&business=QFXXKKAB2B9MA&item_name=macOS-Simple-KVM).\n\nNew to macOS and KVM? Check [the FAQs.](docs\u002FFAQs.md)\n\n## Getting Started\nYou'll need a Linux system with `qemu` (3.1 or later), `python3`, `pip` and the KVM modules enabled. A Mac is **not** required. Some examples for different distributions:\n\n```\nsudo apt-get install qemu-system qemu-utils python3 python3-pip  # for Ubuntu, Debian, Mint, and PopOS.\nsudo pacman -S qemu python python-pip python-wheel  # for Arch.\nsudo xbps-install -Su qemu python3 python3-pip   # for Void Linux.\nsudo zypper in qemu-tools qemu-kvm qemu-x86 qemu-audio-pa python3-pip  # for openSUSE Tumbleweed\nsudo dnf install qemu qemu-img python3 python3-pip # for Fedora\nsudo emerge -a qemu python:3.4 pip # for Gentoo\n```\n\n## Step 1\nRun `jumpstart.sh` to download installation media for macOS (internet required). The default installation uses Catalina, but you can choose which version to get by adding either `--high-sierra`, `--mojave`, or `--catalina`. For example:\n```\n.\u002Fjumpstart.sh --mojave\n```\n> Note: You can skip this if you already have `BaseSystem.img` downloaded. If you have `BaseSystem.dmg`, you will need to convert it with the `dmg2img` tool.\n\n## Step 2\nCreate an empty hard disk using `qemu-img`, changing the name and size to preference:\n```\nqemu-img create -f qcow2 MyDisk.qcow2 64G\n```\n\nand add it to the end of `basic.sh`:\n```\n    -drive id=SystemDisk,if=none,file=MyDisk.qcow2 \\\n    -device ide-hd,bus=sata.4,drive=SystemDisk \\\n```\n> Note: If you're running on a headless system (such as on Cloud providers), you will need `-nographic` and `-vnc :0 -k en-us` for VNC support.\n\nThen run `basic.sh` to start the machine and install macOS. Remember to partition in Disk Utility first!\n\n## Step 2a (Virtual Machine Manager)\n1. If instead of QEMU, you'd like to import the setup into Virt-Manager for further configuration, just run `sudo .\u002Fmake.sh --add`.\n2. After running the above command, add `MyDisk.qcow2` as storage in the properties of the newly added entry for VM.\n\n## Step 2b (Headless Systems)\nIf you're using a cloud-based\u002Fheadless system, you can use `headless.sh` to set up a quick VNC instance. Settings are defined through variables as seen in the following example. VNC will start on port `5900` by default.\n```\nHEADLESS=1 MEM=1G CPUS=2 SYSTEM_DISK=MyDisk.qcow2 .\u002Fheadless.sh\n```\n\n## Step 3\n\nYou're done!\n\nTo fine-tune the system and improve performance, look in the `docs` folder for more information on [adding memory](docs\u002Fguide-performance.md), setting up [bridged networking](docs\u002Fguide-networking.md), adding [passthrough hardware (for GPUs)](docs\u002Fguide-passthrough.md), tweaking [screen resolution](docs\u002Fguide-screen-resolution.md), and enabling sound features.\n","macOS-Simple-KVM 是一个用于在 QEMU 中快速搭建 macOS 虚拟机并利用 KVM 加速的工具集。其核心功能包括通过脚本自动下载 macOS 安装镜像、创建虚拟磁盘以及启动虚拟机，支持从 High Sierra 到 Catalina 多个版本的 macOS。该项目采用 Shell 语言编写，具有良好的跨平台兼容性，适用于 Ubuntu、Arch Linux 等多种 Linux 发行版。macOS-Simple-KVM 特别适合于开发者或研究人员在非 Mac 平台上测试和运行 macOS 应用程序，同时也为对 Hackintosh 感兴趣的技术爱好者提供了一个便捷的实验环境。",2,"2026-06-11 03:34:27","high_star"]