Chapters
  1. Welcome to Omarchy!
  2. Getting Started
  3. Coming From Mac or Windows
  4. Navigation
  5. The Top Bar
  6. Themes
  7. Hotkeys
  8. Unified Clipboard & History
  9. Reminders
  10. Notices
  11. Text Extraction & Dictation
  12. Screenshots & Recording
  13. Toggles, Idle & the Screensaver
  14. Omarchy CLI
  15. Terminal
  16. Neovim
  17. AI
  18. Development Tools
  19. Shell Tools
  20. Shell Functions
  21. TUIs
  22. GUIs
  23. Browsers
  24. Commercial apps/services
  25. Web Apps
  26. Gaming
  27. Filling out PDFs
  28. Windows VM
  29. Other Packages
  30. Updates
  31. Dotfiles
  32. Shell Plugins
  33. Monitors
  34. Keyboard, Mouse, Trackpad
  35. Networking
  36. System sleep
  37. Hardware authentication
  38. Fonts
  39. Backgrounds
  40. Prompt
  41. Branding
  42. Common tweaks
  43. Making your own theme
  44. Mac support
  45. Troubleshooting
  46. FAQ
  47. System snapshots
  48. Security
  49. Omarchy on...
  50. Dual Boot Install
  51. Unattended Installs

Mac support

Omarchy has built-in support for Intel Macs. There are a couple of known limitations at the moment, but as long as you’re aware and OK with those; you can breathe some new life into your old Macs by loading Omarchy.

Please note that installing on an M-series Mac is not directly supported at this time. You can find out more about the state of this in #omarchy-on-other in our Discord.

In a simple test, we were able to achieve 36% performance gains on a 2019 MacBook Pro just by installing Omarchy.

macbook-omarchy

Installing Omarchy on Mac

Omarchy only supports being the only OS installed at the moment. During the installation, the drive will be wiped and MacOS will no longer be bootable.

You can still restore it later via Internet Recovery if you’d like.

For the sake of this part, we’ll assume you’ve already reviewed Getting Started and have your USB drive ready. If you don’t go ahead and do that now.

Disable Secure Boot #

It is necessary to disable Apple’s Secure Boot in order to boot the bootable USB, as well as the OS. To disable it, perform the following:

  1. Turn off your Mac
  2. Turn it on and immediately press and hold Command-R until you see the loading screen appear
  3. Select your user and enter your password if prompted
  4. Once in the recovery screen, choose Utilities > Startup Security Utility from the menubar
  5. Enter your password when prompted to authenticate
  6. Choose “No Security” from the Secure Boot options
  7. Choose “Allow booting from external or removable media” from the External Boot options

Start the Installation #

  1. Insert the USB drive
  2. Restart your Mac and immediately press and hold Option until you see a screen of boot devices
  3. Select the orange EFI Boot device
  4. Proceed with the install as normal

The installer detects Mac hardware and applies the needed fixes automatically: Broadcom Wi-Fi drivers and firmware, the SPI keyboard driver on the MacBook models that need it, and an NVMe suspend fix for those same models.

Known Limitations

Members of the community are constantly working on solutions to these challenges so if these are problematic for you, join #omarchy-on-other in our Discord and see if there’s any up-to-date methods for resolving these.

Devices with T1 Chip #

The Apple T1 chip was introduced in late 2016 and used exclusively in the first-generation MacBook Pro models with Touch Bar.

  • MacBook Pro 13-inch (2016, two Thunderbolt 3 ports) – Model: A1706
  • MacBook Pro 13-inch (2016, four Thunderbolt 3 ports) – Model: A1708
  • MacBook Pro 15-inch (2016) – Model: A1707

Known Issues #

  • Touch Bar is non-functional
  • Sound is not functioning

Devices with T2 Chip #

The Apple T2 Security Chip was introduced in 2017. The T2 chip was discontinued with the transition to Apple silicon (M-series chips) starting in 2020.

  • iMac Pro (2017) – Model: A1862
  • MacBook Pro 13-inch (2018, four Thunderbolt 3 ports) – Model: A1989
  • MacBook Pro 15-inch (2018) – Model: A1990
  • MacBook Air (Retina, 13-inch, 2018) – Model: A1932
  • Mac mini (2018) – Model: A1998
  • MacBook Pro 13-inch (2019, two Thunderbolt 3 ports) – Model: A2159
  • MacBook Pro 13-inch (2019, four Thunderbolt 3 ports) – Model: A2178
  • MacBook Pro 15-inch (2019) – Model: A1990
  • MacBook Pro 13-inch (2020, two Thunderbolt 3 ports) – Model: A2265
  • MacBook Pro 15-inch (2020) – Model: A1990

On these models, the installer automatically sets up the patched linux-t2 kernel, the T2 audio configuration, Apple’s Broadcom Wi-Fi/Bluetooth firmware, and fan control via t2fanrd. The Touch Bar runs on the kernel’s built-in Boot Camp-style support.