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

Web Apps

You can add your own web apps using Install > Web App in the Omarchy menu (Super + Space). It’ll ask you for the app name, app URL, and the icon URL, if it can’t retrieve it via favicon. You can get great PNG icons for many popular web apps on Dashboard Icons.

They’ll then be accessible through the app launcher (Super + Space), and use the beautiful frameless web-app window.

If you wish to remove a web app, just go to Remove > Web App in the Omarchy menu.

It’s best if you log into all your accounts using a regular browser before using the web app shortcuts. The thin wrapper frame doesn’t work well with 1password, so just easier to be logged in directly first.

All the keyboard hotkeys for these web apps can be changed in ~/.config/hypr/bindings.lua.

When you’re in a web app, you can copy the current URL to the clipboard using Shift + Alt + L.

By default, Omarchy already ships with an assortment of default apps:

HEY

HEY is an email and calendar service that serves as a great alternative to people tired of Gmail, Outlook, or Apple Mail. It’s made by 37signals where Omarchy originated.

You can start HEY Email using Super + Shift + E, jump straight to composing a new email using Super + Shift + Alt + E, and start HEY Calendar using Super + Shift + C.

Basecamp

Basecamp is a project management service that helps small teams move faster and make more progress. Instead of patching together a mishmash of Trello, Slack, Asana, Notion, or whatever, you can have it all in one place with Basecamp. It’s made by 37signals where Omarchy originated.

You can start Basecamp using the application launcher (Super + Space)

ChatGPT

ChatGPT is the most popular AI chat bot in the world.

You can start ChatGPT using Super + Shift + A.

Grok

Grok is xAI’s chat bot.

You can start Grok using Super + Shift + Alt + A.

WhatsApp

WhatsApp is one of the most popular messaging services in the world, and the web version is a great option for Linux.

You can start WhatsApp using Super + Shift + Alt + G.

Google apps

Google Messages, Google Photos, Google Maps, and Google Contacts are all included as web apps too.

You can start Google Messages using Super + Shift + Ctrl + G, Google Photos using Super + Shift + P, and Google Maps using Super + Shift + S. Google Contacts is available through the app launcher (Super + Space).

X

X is where news break.

You can start X using Super + Shift + X and go straight to writing a new post with Super + Shift + Alt + X.

YouTube

YouTube is the most popular video platform in the world.

You can start YouTube using Super + Shift + Y.

Zoom

Zoom is the most popular video chat system used in the US. Great connections across the world. And 40-minute meetings can be held without a paying account. Omarchy wraps Zoom’s web client, and zoom meeting links will open straight into it.

You start Zoom using the application launcher (Super + Space).

Discord

Discord is where most gaming and open source communities hang out, including Omarchy’s own.

You start Discord using the application launcher (Super + Space).