Skip to content
gillesgoetschPublic

About

Omarchy VM for Apple Silicon (OmacVM.app, UTM, VMware or Parallels), feeling native: Full notch rendering, trackpad gestures, macOS-like scrolling, GPU acceleration, synced Wi-Fi, audio and key controls AND TouchID 💥

Topics

Resources

Contributing

Stars

235 stars

Watchers

1 watching

Forks

Repository files navigation

OmacVM

Omarchy on your Mac, in its own app, feeling native

One command builds the VM in OmacVM.app. Then your Mac's Wi-Fi, Bluetooth, sound, keys, trackpad, displays, Night Shift and wallpaper all work in Omarchy.

With Omanotch: Omarchy's real bar beside the MacBook's notch, where the VM leaves a black strip.

curl -fsSL https://raw.githubusercontent.com/gillesgoetsch/omacvm/main/install.sh | bash

Using a coding agent? Copy the prompt for it.

Animated overview. A MacBook runs Omarchy full screen; the VM leaves a black strip beside the notch. The VM's invisible notch monitor appears above, Omanotch streams Omarchy's real bar into the strip piece by piece, the windows grow to full height, the pointer glides into the strip and a click on the clock opens Omarchy's calendar. Then, with the macOS host shown above the VM and OmacVM Bridge between them: the Mac's Wi-Fi and volume arrive in Omarchy's bar; volume and brightness keys drive the Mac while Omarchy shows the popup; three- and four-finger swipes and pinch arrive through OmacVM Gestures while macOS's Spaces swipe is off; the Omarchy menu's Nightlight (and Super+Ctrl+N on Omarchy 4.0) switches the Mac's Night Shift; an external display joins in the macOS arrangement.

What you get in Omarchy
🔳 Omanotch
Omarchy's real bar beside the MacBook's notch, where the VM leaves a black strip. On by default on a Mac with a notch.
🖥️ Every display, full screen
Your macOS arrangement, external monitors included, each in a Space of its own. ⌃⌥ Esc goes one Space over to macOS; twice opens Mission Control.
🎮 Real GPU performance
Keeps up with your display's refresh, up to 120 Hz. Graphics: OpenGL, Vulkan (KosmicKrisp on macOS 26+) or Automatic. Vulkan adds WebGPU in Chromium. Graphics memory grows with what the Mac can spare.
🎬 Hardware video decoding
YouTube 4K on the Mac's media engine, not the CPU, Omarchy's Chromium too. The sound stays in step with the picture.
👆 Mac trackpad and Magic Mouse gestures
2, 3 and 4 finger swipes and pinch zoom, optional macOS-like momentum scrolling. Magic Mouse swipes count as 3 or 4 fingers, your pick. Optional Mission Control: four fingers up spread out the windows (plugin by @gillesgoetsch).
⌨️ Mac keys, fully Omarchy
Cmd works as Super, ⌘ F10–F12 take Omarchy's screenshots, macOS shortcuts stay out of the way. The globe (fn) key opens Omarchy's emoji picker.
📶 Wi-Fi, audio and battery from the Mac
The bar shows your real networks, sound devices and battery. Sound holds on a busy Mac.
🔊 Native volume and brightness
The Mac's keys with Omarchy's own popups, in finer steps (32, Option: 64), for external displays too. Shift+F1/F2 dims and brightens the keyboard light.
🔑 Touch ID for sudo and 1Password
Off until you turn it on: sudo, polkit and 1Password ask the Mac's Touch ID in an Omarchy-styled panel. Your password keeps working; only for the VM in front.
☀️ HDR and Extra brightness on XDR displays
HDR and 10-bit colour, and Extra brightness up to twice the Mac's normal white, live from Omarchy's Display panel. Experimental and off until you turn them on; they use more battery.
📷 Camera and microphone
Video calls in the VM.
📋 Copy and paste, both ways
Plus a Mac folder at ~/Mac (off by default), Night Shift, True Tone and the Mac's clock format.
🎨 Theme, wallpaper and boot splash
Your Omarchy theme and wallpaper carry over to macOS; Omarchy's logo shows from the first frame.
🔋 Optimized for battery
Measured power draw; an idle VM wakes the Mac half as often.
🎛️ Control centre in Omarchy
omacvm in the VM opens a floating window: features on or off, updates, report a problem. From the Mac too: Features… in OmacVM.app.
🔄 Updates in one step
u in the control centre updates the Mac and the VM, OmacVM.app included. Checked once a week, signed with OmacVM's release key, with a way back.
⏱️ Ready in 5 minutes
Download a prebuilt VM, or build it yourself. Pick CPUs, memory, disk, keyboard, user and every feature; change them later in the app's window.
💾 Your VMs where you want them
OmacVM.app's Storage moves them to another folder or drive and shows their sizes.
🧪 Experiments, off until you turn them on
x86 Linux apps through box64, USB devices, a fast network (VPN included), GPU compute (OpenCL, WebGPU in Firefox) and the Mac's input methods for Chinese, Japanese and Korean.
🩺 One check for everything
omacvm check tells you what works and what to fix. Only your own VM can talk to the Mac side, proven with a secret token.

Runs on every Apple Silicon Mac, M1 and newer, and adapts to notch, ProMotion, HDR and missing hardware on its own. Every feature in detail.

Filmed on a MacBook Pro: a swipe from macOS into the full-screen Omarchy VM, Omarchy's bar beside the notch, and the Mac's Wi-Fi, sound and battery in Omarchy's bar, then a swipe to the next workspace.

The control centre

Type omacvm in Omarchy (or pick it in the Omarchy menu): every feature with its live status, on or off with space, plus updates and "report a problem".

The OmacVM control centre, a floating terminal window in Omarchy's Tokyo Night colours, titled OmacVM and its version. A list of features with green ticks: OmacVM Bridge, wallpaper, trackpad gestures, scroll momentum, Omanotch, the Mac's clock, camera and battery, external display brightness, Chromium video, screensaver and lock disabled, the control centre and the fast network. Autologin, the memory-optimized kernel and WebGPU are off. Graphics says Automatic: OpenGL; Graphics memory says 1.1 GB, peak 1.6 GB. At the bottom: OmacVM.app, Mac linked, and the keys space on/off, r repair, u update, enter details, U updates, ! report, esc quit.

Speed and battery

Bar chart: OmacVM.app as a share of the Mac itself, macOS = 100 percent, higher is better. CPU, all cores (Geekbench 7): 99 percent. Web apps (Speedometer 3.1): 69 percent. Browser graphics (WebGL Aquarium, 30,000 fish): 39 percent. Browser overall (Basemark Web 3.0): 77 percent. GPU compute (Geekbench 7 GPU, OpenCL): 45 percent. MacBook Pro M4 Max; browser tests 2026-10-09, median of 3 runs; Geekbench from 2026-10-03 and 2026-10-04.

Bar chart of the whole Mac's power draw in watts, lower is better, with hours on a full 52.6 Wh battery. MacBook Air M2 8 GB, macOS 26.6.2, 2026-10-07, the VM 4 CPUs and 4 GB, median of 3, OmacVM.app 3.0.3 first, then macOS. Idle: 6.13 W (8.6 h), 5.20 W (10.1 h). Reading, Chrome scrolling a text page: 6.11 W (8.6 h), 5.48 W (9.6 h). YouTube 4K at 60 fps, both on the Mac's media engine, in Omarchy's Chromium and in Google Chrome: 10.10 W (5.2 h), 6.07 W (8.7 h). Every core busy, the VM's 4 cores or the Mac's 8: 21.01 W (2.5 h), 19.69 W (2.7 h). WebGL Aquarium with 30,000 fish, OmacVM.app at 19 fps, macOS at 60 fps, the display's limit: 17.11 W (3.1 h), 17.34 W (3.0 h).

Speed: OmacVM.app against the Mac itself on a MacBook Pro M4 Max. Power: the whole Mac on a MacBook Air M2, video on the Mac's media engine. How we measured, and every number: docs/benchmarks.

Get started

The command at the top puts OmacVM in ~/.omacvm (it follows the releases: omacvm update takes it to the newest), adds the omacvm command and starts it. With no VM yet it builds one; otherwise it asks what you want to do (build another VM, switch features, update, check). Prefer git? git clone https://github.com/gillesgoetsch/omacvm and run ./install.sh in it. Already have OmacVM.app? Its window's "omacvm in Terminal" Install adds the command.

omacvm            # or: omacvm build

It asks a few questions (build or download, CPUs and memory, features, your user and password), shows a summary and builds: 10 to 30 minutes, or a few minutes after a 3.5 to 6 GB download for a prebuilt VM. omacvm downloads OmacVM.app when it is missing. For scripts: --prebuilt, --FEATURE or --no-FEATURE, --yes; omacvm build --help lists them all, every step is in docs/guide.md.

When it is done, allow the macOS prompts for OmacVM Bridge and OmacVM Gestures (which ones).

Requirements: an Apple Silicon Mac, M1 or newer, with macOS 15 or newer, and about 30 GB free on the drive the VM goes to. Nothing else: OmacVM.app brings what it runs on the Mac (install.sh asks for Xcode's Command Line Tools once, for git). (On an M1 or M2, Asahi Linux can also run Omarchy natively.)

Everyday use

omacvm features                 # switch features on or off
omacvm update                   # the newest OmacVM, on the Mac and in every running VM
omacvm check                    # what works and what to fix; it changes nothing
omacvm vms                      # your VMs and their OmacVM version
omacvm report                   # report a problem: shows what goes into the GitHub issue first
omacvm resources --vm NAME      # change its CPUs and memory
omacvm graphics --vm NAME       # OpenGL, Vulkan or Automatic

In Omarchy, omacvm (also in the Omarchy menu and the bar; from the Mac, OmacVM.app's Features… or omacvm features --in-vm) opens the control centre. u there updates everything: OmacVM.app on the Mac first (the VM restarts once, after one confirm), then the VM. OmacVM.app also looks for a new version once a week (Check Now in its window; Go Back in its menu).

A VM from before OmacVM 3.4.0 (Omarchy 4.0, omarchy-mac) shows Move to Omarchy 4.5 at the top of its settings in OmacVM.app: only when you click it, with a backup of the disk first, Undo, and the backup deleted only when you say so (how). Until then nothing changes and Update VM works as before.

Add --vm NAME for a VM other than the default. ⌃⌥ Esc moves the monitor you work on one Space over to macOS; press it there again to go back into the VM; twice quickly opens Mission Control (more).

Coming from Parallels, UTM or VMware Fusion?

OmacVM 3.4.0 retired those three routes: OmacVM.app is the only one now. Your VM keeps running as it is, with its OmacVM 3.3.x; nothing in it is changed or deleted, but it gets no more OmacVM updates. Once the Mac has 3.4.0 (omacvm update, or u in the old VM's control centre), its helpers no longer serve it: no Mac Wi-Fi, Bluetooth or audio in its bar, no media keys, wallpaper or time zone from the Mac, no gestures, no Omanotch, no camera and battery (UTM, VMware Fusion); Touch ID asks for the password, and its control centre shows how to move. The VM app's own features keep working. To move: omacvm build makes a new VM in OmacVM.app, then copy your files over (from the old VM through its app's shared folder or scp to the Mac; in the new VM turn on the Mac folder and find them in ~/Mac). The routes may come back if people ask for them, only with the maintainer's consent.

How it works

OmacVM installs Omarchy 4.5 from Omarchy's official aarch64 repositories (pkgs.omarchy.org stable and its Arch Linux ARM snapshot, arm-stable-mirror.omarchy.org), always the latest stable release, onto the VM's own disk: a full Omarchy with omarchy update, not a demo. OmacVM.app runs it on its own QEMU with the Mac's GPU. Small helpers on the Mac pass its hardware to the VM over the VM's private network, with a secret token: OmacVM Bridge, OmacVM Gestures and Omanotch. More: docs/how-it-works.md, the whole build in AGENTS.md, everything else in docs/.

Troubleshooting

Start with omacvm check: it names what is wrong and what to do. Still stuck? omacvm report (or ! in the control centre) collects the checks, versions and logs without your names, addresses, Wi-Fi names or tokens, shows you the text, then opens a pre-filled GitHub issue. Common problems and their fixes: docs/troubleshooting.md.

Uninstall

omacvm uninstall            # --purge also removes the bridge token and settings

Then remove the OmacVM apps from System Settings › Privacy & Security › Location Services if still listed. The omacvm command itself stays: rm -rf ~/.omacvm "$(command -v omacvm)" removes it. OmacVM.app stays too: drag it to the Bin (its VMs stay in ~/OmacVM, older ones in ~/Library/Application Support/OmacVM/VMs, until you delete them).

OmacVM 2.7.0 and older: don't use --purge if you have OmacVM.app VMs. It deletes them with the settings. Fixed in 2.7.1: run omacvm update first.

Credits

Omarchy (MIT) and DHH for making this!

Omarchy's aarch64 packages, omarchy-mac (OmacVM's VMs before 3.4.0) and try-omarchy by the Omarchy team. try-omarchy (MIT) gives the camera bridge, the Mac's battery in the VM and OmacVM.app's pieces. Also Arch Linux ARM, QEMU, and UTM, whose approach OmacVM.app's full screen beside the notch follows. The bar widgets are clones of Omarchy's own.

OmacVM is a community project, not affiliated with the Omarchy team or Apple.

Want to help? Start with CONTRIBUTING.md.

License

MIT, see LICENSE. Code reused from others: THIRD_PARTY_NOTICES.md.

About

Omarchy VM for Apple Silicon (OmacVM.app, UTM, VMware or Parallels), feeling native: Full notch rendering, trackpad gestures, macOS-like scrolling, GPU acceleration, synced Wi-Fi, audio and key controls AND TouchID 💥

Topics

Resources

Contributing

Stars

235 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages