Skip to content

Quake Terminal

OmniWM ships a true quake/sticky terminal you can summon over any workspace. It is a real embedded terminal built on Ghostty’s libghostty — not a wrapper around another terminal app — and it supports multiple tabs and splits within tabs.

Toggle it with Option + ` (backtick) by default; the binding is configurable in Settings under Keyboard Shortcuts, alongside the rest of the keyboard shortcuts.

Configure the terminal in Settings → Quake Terminal:

  • Position — Top, Bottom, Left, Right, or Center. The default is Center, which fades the terminal in place; the four edge positions slide it in from that screen edge.
  • Show On — which monitor the terminal appears on: Mouse Cursor's Monitor, Focused Window's Monitor (the default), or Main Monitor. Main Monitor follows the Monitor Roles ranking in Settings → Displays when one is set, so you can pin the terminal to a preferred display with a fallback when it is disconnected; without a ranking it is the display with the macOS menu bar. See Multi-Monitor Setup.
  • Width / Height — each 10–100% of the monitor’s available screen area in 5% steps; both default to 50%.

You can also adjust the terminal directly with the mouse: drag its edges to resize, and hold Option and drag to move it. OmniWM remembers one custom size and position. It reuses that frame when it fits the selected monitor; otherwise it uses the configured position and percentages. A Reset to Default Position button appears in Settings once a custom frame is in use.

Quake Terminal loads Ghostty’s normal configuration files and their included files, so your font, theme, and other terminal preferences can be shared. OmniWM applies its Quake background opacity and background effect afterward; configure those controls in Settings → Quake Terminal.

  • Background Effect — choose Standard Blur, Regular Glass, or Clear Glass. Standard Blur comes with an adjustable blur radius; the native glass effects do not, but switching effects preserves the saved Standard Blur radius so it becomes active again when you return to it.
  • Quake Background Opacity — 10–100%.

Command-click an OSC 8 web or email hyperlink printed by a terminal application to open it in the default browser or mail app. Supported schemes are http, https, and mailto; file links and custom application schemes remain blocked. Plain URL detection continues to follow Ghostty’s link-url setting.

  • Animation Duration — 0 to 1 second, default 0.2s. Ignored while global animations are disabled.
  • Auto-hide on Focus Loss — optionally hide the terminal whenever it loses focus.

Customize tab and pane shortcuts with Ghostty keybind entries in ~/.config/ghostty/config.ghostty (or your existing Ghostty config). User bindings override the defaults below; unbind removes a binding. Reload inside Quake with Cmd + Shift + ,, or relaunch OmniWM. The global toggle stays in Settings → Keyboard Shortcuts and OmniWM’s settings.toml.

keybind = cmd+t=unbind
keybind = ctrl+shift+t=new_tab
keybind = cmd+enter=new_split:right
keybind = cmd+shift+enter=close_surface

See Ghostty’s keybinding syntax. Quake supports new_tab, close_tab, goto_tab, next_tab, previous_tab, last_tab, new_split, goto_split, close_surface, and equalize_splits, alongside Ghostty’s terminal actions such as copy, paste, and font sizing.

Action Default Shortcut
New Tab Cmd + T
Close Tab Cmd + W
Next Tab Cmd + Shift + ]
Previous Tab Cmd + Shift + [
Next Tab (Alt) Ctrl + Tab
Previous Tab (Alt) Ctrl + Shift + Tab
Select Tab 1-9 Cmd + 1-9
Split Pane (Horizontal) Cmd + D
Split Pane (Vertical) Cmd + Shift + D
Close Pane Cmd + Shift + W
Equalize Splits Cmd + Shift + =
Navigate Pane Cmd + Option + Arrow Keys