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

Shell Functions

Omarchy comes with a set of shell functions to simplify common tasks and encapsulate convoluted parameter calls.

Compression

  • compress [file/dir]: Create a tar.gz archive from the file/dir.
  • decompress [file.tar.gz]: Expand a tar.gz file.

Drives

  • iso2sd [image.iso]: Create a bootable drive on an SD card using the referenced iso file and picking the drive interactively.
  • format-drive [device] [name]: Format an entire disk with a single exFAT partition (which works on Windows and macOS too). Run it without arguments to see the available drives. Be careful!

Dev layouts

Instant multi-pane development layouts for tmux:

  • tdl [ai]: Create a Tmux Dev Layout with your editor, an AI agent, and a terminal. Use the agent aliases, like tdl c for opencode or tdl cx for Claude Code, or pass a second agent to run both, like tdl c cx.
  • tds: Create a Tmux Dev Square with editor, diff watching (via hunk diff --watch), terminal, and opencode.
  • tdlm [ai]: Create a tdl window for every subdirectory in the current directory.
  • tsl [count] [command]: Create a swarm of panes tiled in a grid, all running the same command (great for AI agents).

The same layouts are available for Herdr as hdl, hds, hdlm, and hsl.

Git worktrees

  • ga [branch]: Create a new worktree and branch next to the current repository and jump into it.
  • gd: Remove the current worktree and its branch (asks for confirmation first).

Rsync watchers

  • rsw [source] [destination]: Start a background watcher that rsyncs source to destination whenever anything changes. The destination can be a remote host, like rsw ~/Work/app nyc-dev:Work/app.
  • lsw: List all active watchers.
  • dsw: Stop all active watchers.

SSH Portforwarding

Ideal for doing web development with localhost secure-context privileges against a remote box.

  • fip: Forward one or more ports from a remote host to localhost via SSH.
  • dip: Disconnect one or more forwarded ports.
  • lip: List all active SSH port forwards.

Say you start a dev server on port 3000 on a machine accessible as nyc-dev, then you can run fip nyc-dev 3000 to forward that port, so localhost:3000 actually reaches nyc-dev:3000, but without the need for SSL certificates to establish the secure context needed for testing web sockets or the like.

SSH reconnection

ssh itself is wrapped in a function that cleans up the terminal if a connection dies while a remote tmux, Herdr, or editor has claimed it, and then automatically reconnects when an interactive session drops (Ctrl-C stops the retry loop).