Unofficial community reference. Not affiliated with 37signals or the Omacom Foundation. Download Omarchy only from omarchy.org.
omarchylinux.org Unofficial field manual

Omarchy v3.1.2

Released 2025-10-24. Official notes on GitHub · ISO SHA-256 f428fa1bc6656b8a576ab6c05d52be91f3d71bebac1bb2713f70dc7b035eab40 (how to verify).

Release notes

What changed?

Update existing installations using Update > Omarchy from Omarchy menu (Super + Alt + Space).

Install on new machines with the ISO:

New Additions

  • Add dynamic resolution, sound, microphone, AVC444 graphics, and tiling compatibility to Windows VM by @ATeal + @boozlbork + @garovu + @dhh
  • Add Super + Alt + Mouse scrolling to move between windows in a tile group by @mythz
  • Add omarchy-debug for obtaining debug logs more easily by @ryanrhughes
  • Add omarchy-refresh-limine to reset limine configs by @ryanrhughes
  • Add omarchy-reinstall to reset all Omarchy configs by @dhh + @ryanrhughes
  • Add Super + Ctrl + T to show time in a notification by @dhh
  • Add Super + Ctrl + B to show battery level in a notification by @dhh
  • Add Update > Time via Omarchy menu to update time with latest sync by @dhh
  • Add omarchy-launch-terminal with fallback in case envs become unset by @ryanrhughes
  • Add terminal launch on right click of the Omarchy menu icon in case keybinds are unavailable by @ryanrhughes

Fixes

  • Remove branch from Omarchy menu by @dhh
  • Fix VSCode self-update disable check by @sgruendel
  • Fix that Update > Extra Themes should only update git themes, not Aether by @dhh
  • Fix bashrc inclusion should bail when not interactive by @ryanrhughes
  • Fix omarchy update breaking when waybar was not running by @dhh
  • Fix limine bootloader screen to be default for all new installs by @ryanrhughes
  • Fix catch errors during updates more consistently by @ryanrhughes
  • Fix nvim syntax highlighting error after setup by @ryanrhughes

Migrations this upgrade ran (0)

Each is a script that ran once on your machine during omarchy update. Descriptions are the scripts' own messages.

No new migrations recorded for this tag.

Unofficial mirror of public release data. Notes © the Omarchy authors (MIT repository). Bare #numbers are linked to the upstream issue tracker.