Prerelease: the notarized app, the Try Omarchy kit that Omarchy Installer pins, and the Omarchy image. It becomes the latest release when Omarchy Installer ships Try.

This release brings a new native macOS launcher, browser swipe navigation, and input source switching for Korean, Chinese and Japanese Macs 💻

You can upgrade by replacing the app with the new TryOmarchy.dmg. Your VM and its files are kept, and Omarchy inside the VM keeps updating with omarchy update.

Features

• New native launcher that follows Light and Dark mode, laid out like System Settings with a sidebar by @themartiano in #364
• Two-finger swipes go back and forward in browsers, like on the Mac by @sscarduzio, @themartiano in #401, #412
• Caps Lock is the 한/영 key on Korean Macs by @AI-Dico, @themartiano in #404, #410
• Omarchy's input method follows the Mac's input source for Chinese and Japanese, and Globe switches it while the VM is focused by @themartiano in #411
• The launcher shows each step while preparing the Omarchy image, with a progress bar in place of the Launch button by @themartiano in #398, #413

Fixes

• The keyboard works in Limine's boot menu by @themartiano in #409
• ⌘C, ⌘V and ⌘W no longer type a plain key while the keyboard is captured by @stevederico in #279
• The guest clock recovers as soon as the Mac wakes, and the top bar clock redraws right away instead of up to a minute later by @themartiano in #391
• Bring back the battery percentage toggle in the Omarchy menu, after Omarchy split it into two rows by @themartiano in #408

Dev

• Fix a QEMU crash when the Cocoa display starts a VM with no console by @charles-hood in #312
• Rewrite the docs around the shell principles, with a user manual, contributor docs and agent instructions by @themartiano in #395
• Improve the README by @themartiano

Full changelog: v1.1.0...v1.2.0

Just download TryOmarchy.dmg, the rest of the installation will be handled automatically 👇

This release brings full macOS Notch support and fixes for Italian keyboards, M4 Macs and clock time recovery after Mac sleep 💻

You can upgrade existing VMs by replacing the app with the new TryOmarchy.dmg. The M4 SIGILL fix applies after the next kernel update from omarchy update, or manually with sudo limine-update followed by a reboot.

Features

• Full screen now uses the whole display on MacBooks with a notch, and topbar items are repositioned to accommodate it. Can be turned on / off in the launcher. by @themartiano in #361

Fixes

• Fix apps dying with SIGILL on M4 Macs, such as Slack's camera and other Chromium/Electron apps, by hiding SME from the guest by @ln-bodicherla in #374
• Type Italian on Apple's current QWERTY layout instead of the old QZERTY one (M typing ,, W and Z swapped) by @simoz in #371
• Fix the guest clock staying behind after Mac sleep, which also made Touch ID sudo approvals fail until the clock caught up by @themartiano in #390

Dev

• Pin libslirp, VirGL and the virglrenderer tap to commits instead of moving tags, so runtime builds stop failing on checksum mismatches by @stevederico, @themartiano in #381, #388

Full changelog: v1.0.1...v1.1.0

Just download TryOmarchy.dmg, the rest of the installation will be handled automatically 👇

v1.0.1

This version temporarily turns nested virtualization off by default, to avoid issues on M3+ Macs (#369)

You can turn it on again by setting OMARCHY_QEMU_GPU_NESTED_VIRT to 1

open --env OMARCHY_QEMU_GPU_NESTED_VIRT=1 "/Applications/Try Omarchy.app"

Full release notes for v1.0.0

Try Omarchy One

Try Omarchy now uses the official Omarchy M image and package mirror, so now it works much, much better.
This puts us closer to having a matching experience with native Omarchy installations. On any Apple Silicon Mac.

Updates are also solved. Moving to new app versions is now butter smooth, and you can update Omarchy from inside the VM, just like a native installation. Worrying about VM resets is a thing of the past now.

VMs from previous versions have a migration path that will copy your files and optionally install packages that were added by hand.

All existing features remain available.

The complete Omarchy is now used, which includes some packages that were missing, such as Omawrite.

Omarchy dev is used, so all the newest features are available, but since it is not the stable channel, some bugs or glitches could exist.
stable will be available on omarchy-mac is officially released.

The OS image is now downloaded on first launch instead of being bundled with the app, because of GitHub's 2GB limit per file.

To migrate your existing VM to the new version, update the app, Launch the VM and once booted, search for "Import previous VM". Packages can be reinstalled with try-omarchy-import-previous --packages.

For contributors, the "pinned packages issue" is gone, now make fetches Omarchy and packages from official sources and will let you know if your local cache is getting old, which can then be updated by running make refresh.

Full changelog

Just download TryOmarchy.dmg, the rest will be handled automatically 👇

v0.6.0 adds VM management, Japanese and Korean input, a better migration system, and fixes. ⛩️

Features

• Manage VMs: move, create and boot from different disks, plus move to Trash. Reset still erases permanently (#350)
• JIS and Japanese support with Mozc. New VMs on Japanese Macs default to Japanese (#341, #354)
• Korean support. New VMs on Korean Macs default to Korean (#320)
• Show only new, revised, or unfinished VM migrations in the update review. Existing VMs without revision history receive a one-time check in a disposable overlay; later launches use per-VM revision history without repeating completed repairs (#355)
• Use the Omarchy login-screen theme in new factory images (#337)
• Put the quickstart near the top of the README (#344)

Fixes

• Avoid partial package upgrades during Japanese setup: use existing repository data without refreshing it or running a system upgrade. If installed packages need updating first, keep setup pending and explain how to run omarchy update inside the VM, shut down, reopen the app, and retry Update and Launch. Failed downloads and deferred setup remain retryable; guest language, kernel, and saved boot files are retained (setup and recovery)
• Keep the shell bar, Omarchy menu, and Super+K themed after omarchy-update brings Qt 6.12, instead of losing colors or opening a black screen. New VMs include the fix, and Update and Launch repairs existing VMs while preserving edited shell files (#347)
• Fix microphone switching in localized guest sessions (#331)
• Keep the guest audio bridge running when pactl times out, with bounded retries and systemd restart recovery (#342)
• Prevent reboots in small VM windows from starting with a display too small for setup by advertising at least 800×600 to the guest (#325)
• Remove stale Mac battery reporting when the host battery bridge disconnects (#339)
• Fix Ghostty crashes when fonts are installed or the font cache is rebuilt by using the guest's system Fontconfig. Apply the VM update and reinstall Ghostty through the Terminal menu to rebuild an existing installation (#334)
• Handle the default VM path and native folder-picker metadata correctly during VM selection and relocation (#350)
• Avoid intermittent startup failures caused by the runtime capability probe (#345)
• Seed About and screensaver branding the way upstream Omarchy does, so new VMs show the icon in About and the wordmark in the screensaver (#348)
• Verify the packaged app version matches its release tag (#330)
• Keep the installer filename stable as TryOmarchy.dmg for older update checkers and existing download links

Dev

• Refresh the ARM64 package lock and pinned build inputs for the current factory, including the Japanese input stack and validated Hyprland build (#341, #350, #355)

New Contributors 🎉

• @RussellBradley
• @rofrol
• @bzumik1
• @TerenceHinrichsen
• @afurm
• @gaboe
• @nekomario28

New language defaults, Korean input setup, the login-screen theme, and About/screensaver branding require a new or reset VM. See Japanese input setup and recovery for preserved personal settings or deferred installation.

Compatible with Apple Silicon Macs running macOS 15 or newer.

Full changelog

v0.5.1

This release patches .dmg naming so tryomarchy.com website downloads work.

Check out the full release notes for v0.5.0.

v0.5.0 brings a more stable and reliable experience, better performance, less resource usage and many relevant features for everyone using Try Omarchy.

Features

• Update Omarchy to 4.0.4 (#289)
• Omarchy's battery widget, in sync with the Mac's live charging state, AC power, charge limits, and "Managed by macOS" power profile (#220, #252, #298, #300, #315)
• Smoother trackpad scrolling, including small movements, horizontal scrolling, and momentum (#239)
• Add experimental passthrough for one USB device, subject to macOS device-access restrictions (#236)
• Add Ghostty installation on ARM64 through the Terminal menu (#240, #303)
• Browser GPU acceleration by default (video playback still CPU, but better) (#305)
• Let Omarchy follow the Mac's time zone through Same as macOS in setup and the time-zone menu, or keep a fixed zone (#290, #299)
• Configure maximum disk size alongside CPU and RAM, with a 64 GiB default for new settings. Mac storage used only as needed (#246, #296)
• Skip the launcher and start straight into Omarchy, then reopen Try Omarchy Settings from inside Omarchy. Pause automatic startup for the first VM-update review (#152, #296, #309, #310, #317)
• Review supported updates before an old VM's first launch with the new app, then choose to update or skip. Preserve your files while applying compatible updates. Still not a full migration path (#193, #308, #317)
• Show the correct installed Mac app version and add Check for Updates…. Daily startup checks are enabled by default, can be turned off in the settings (#234, #223, #309)
• Improve the launcher with standard Mac menus and behavior, fixed Launch button, and more reliable window behavior (#187, #296)
• Return unused VM memory to macOS while keeping the configured RAM available to Omarchy (#243)
• Improve update notification to be explicit about only updating packages (#304)
• Unlock 1Password and its connected browser extension with Mac Touch ID after opting in (#182)
• Restore Chinese, Japanese, and Korean fonts and input-method support, including Traditional Chinese input (#188)
• Initialize new VMs with the Mac's supported language, while preserving the chosen language in existing VMs (#295)
• Add a US international keyboard option for typing Portuguese accents on ANSI keyboards (#195)
• Faster factory resets, with visible progress and clearer confirmation. Fresh VM preparation happens on the next launch and uses less duplicate factory-image storage (#247, #307)
• Hardware-accelerated Alacritty while retaining macOS 15 support (#176, #242)
• Improve graphics responsiveness and frame pacing (#197)

Fixes

• Fix older VMs failing to start after an app upgrade during one-time boot-file preparation (#237)
• Fix intermittent first-launch failures reporting that safe Mac sleep could not be enabled, with clearer recovery actions and easier retries (#229, #296)
• Fix a VM startup crash reported on M4 Macs running macOS 26.3 (#277)
• Reduce audio dropouts during graphics-heavy activity (#254)
• Address audio playing too fast with some Mac audio devices. Device or sample-rate changes during a session may still require a VM restart (#283)
• Protect shared Mac folders from a write-caching issue that could corrupt files, including on older VM disks (#287)
• Fix Command-Space unexpectedly opening Spotlight or Siri instead of reaching Omarchy (#226)
• Fix misplaced keys on Mac ISO keyboards (#190)
• Fix supported text-injection tools typing repeated A characters instead of the intended text (#273)
• Fix clicks landing away from visible controls after resizing and reloading the desktop configuration, while preserving the chosen zoom (#179)
• Fix the guest clock falling behind after Mac sleep, which could also cause Touch ID authentication to fail (#184)
• Fix the lock-screen action doing nothing (#272)
• Fix 1Password installation failing with newer application releases, and repair older stock installers through the VM-update flow (#233, #317)
• Remove the stale iconless Alacritty entry left in Apps after uninstalling it (#248)
• Fix Omarchy updates failing because of incompatible graphics packages (#185, #268)
• Remove incorrect kernel-reboot prompts after updates (#219)
• Fix restarting with forwarded TCP ports being incorrectly reported as already in use (#269)
• Preserve the VM's bridged network address across upgrades and disk changes, keeping router reservations working. Add controls to copy or deliberately change the address (#209)
• Fix browser-detection crashes caused by missing manual-page support (#225)
• Fix large clipboard selections blocking clipboard sharing (#302)
• Keep the screensaver working in small VM windows (#301)
• Retain VM-update results in the selected workspace, show completion or failure in a dialog, and keep manual retries available (#317)

Dev

• Faster tests and PR checks, with full test and build coverage on macOS 15 and 26 (#282)
• More reliable builds on memory-constrained systems (#271)
• Make new releases with build and tags in a single make release command (#318)
• Refresh compatible package versions and fix runtime build issues (#286, #236, #292)
• Reuse cached Omarchy source across builds (#297)
• Add optional startup-crash diagnostics (#278)
• Add performance profiling and documented measurements (#306)
• Clarify contribution guidance and templates (#241, #245)
• Keep development privacy permissions across rebuilds (#297)
• Clean up obsolete development disks (#307)
• Include the release version in DMG filenames, while accepting the legacy filename in app update checks (#316)
• Use one validated migration catalog for the app update review and guest repair list (#317)

New Contributors 🎉

• @MatthewFeroz
• @stevederico
• @NimbleAINinja
• @jean-humann
• @dyl-joseph
• @k5953837
• @Mahognes
• @drdator
• @xavierforge
• @jooray
• @vcanuel
• @seunghan91

Update and Launch applies supported repairs to compatible existing disks, while keeping customized changes. Back up anything you need before resetting. It does not upgrade Linux packages, replace the kernel, enable Touch ID, or reproduce every change in the bundled image. The bundled Omarchy 4.0.4 image and other factory-only changes require a new or reset disk.

Compatible with Apple Silicon Macs running macOS 15 or newer.

Full changelog

Fixes

• Fix launch crash on macOS 15 (#215)
• Fix theme and DNS provide switch password dialog (#216)

v0.4.0 brings official Omarchy branding, more freedom to customize your VM, useful new features and many fixes.

Features

• Official Omarchy branding, app icon, and new launcher UI (#98, #103, #135, #153, #204)
• Configurable RAM and CPU allocation. 8GB default for systems with 16GB or more, up to total - 4GB (#82, #156, #204)
• Nested virtualization (#84)
• Touch ID support for sudo commands (#143, #204)
• Enable guest time synchronization (#143)
• Update Omarchy to 4.0.3 (#203)
• Pause VM on macOS sleep (#101, #204)
• Better trackpad support, pinching works (#158)
• Add bridged networking with offline startup and automatic adapter reconnection (#198, #202)
• Fix mismatched ping replies and incorrect UDP reply translation in NAT networking (#201)
• Safe VM disk growth if needed (#154)
• Launcher natural app lifecycle and window behavior (#95)
• Required typed confirmation on reset VM (#96)
• Explicit message on missing ARM64 compatibility on package install (#138)
• Persistent host-side logs from guest console (#166)
• Support for ARM Vivaldi installation (#80, #139, #204)
• Improve no-free-space error message (#107)
• Hide development builds from macOS's Spotlight (#94)

Fixes

• Honor Omarchy configured terminal preference (#172)
• Fix updates failing because of imcompatible aquamarine version (#136)
• Fix builds because of incompatible aquamarine version (#142)
• Fix Voxtype install (#79)
• Fix missing application icons (#105)
• Fix Kitty rendering (#173)
• Fix Alacritty rendering (#149)
• Guard missing services (#106)

New Contributors 🎉

• @Fail-Safe
• @jamesyork-prog
• @tcballard
• @obrr-hhx
• @eluhr
• @rdtiv
• @nocell
• @jtavin-smp

You can use old VM disks with new Try Omarchy versions. Some updates and features, such as new Omarchy versions and system patches require a new disk to work.