Keybindings & Navigation

The Marchyo desktop is keyboard-driven. Enabling marchyo.desktop.enable ships Hyprland with the keybindings below, plus the Marchyo shell (bar, launcher, notifications, OSD, and lock), cliphist clipboard history, and grimblast/satty/tesseract screenshots. With marchyo.shell.enable = false, waybar, vicinae, mako, SwayOSD, and hyprlock take those roles instead. Super is the primary modifier (the Windows/Command key).

Note

These binds are declared across several Home Manager modules — the bulk in modules/home/hyprland.nix, with the rest contributed by screenshot.nix, omarchy-binds.nix, menus.nix, utilities.nix, window-toggles.nix, keybindings-cheatsheet.nix, and webapps.nix — which together are the source of truth. To change one, override the Home Manager wayland.windowManager.hyprland.settings in your own config rather than editing a dotfile at runtime.

Launching apps

Keys	Action
Super + Return	Terminal (Ghostty)
Super + B	Web browser
Super + F	File manager
Super + R	App launcher (in-shell; vicinae with the shell off)
Super + M	Music player
Super + E	Editor
Super + O	Obsidian
Super + G	Messenger
Super + /	Password manager (focuses 1Password if open)
Super + .	Emoji picker (in-shell; vicinae with the shell off)
Super + Shift + I	Input-method config (fcitx5)

Web apps

With marchyo.webapps.enable (on by default with the desktop), a set of sites opens as standalone browser app windows on Super + Shift chords:

Keys	Action
Super + Shift + A	ChatGPT
Super + Shift + G	GitHub
Super + Shift + Y	YouTube
Super + Shift + W	WhatsApp
Super + Shift + Z	Zoom
Super + Shift + X	X
Super + Shift + P	Google Photos

Discord, Google Calendar, and Gmail are registered as launchers but ship no default key — start them from the app launcher, or give them one via marchyo.webapps.apps.

Window management

Keys	Action
Super + W	Close active window
Super + J	Toggle split direction
Super + T	Toggle floating
Super + P	Toggle pseudo-tile
Super + ←/→/↑/↓	Move focus
Super + Shift + ←/→/↑/↓	Swap window in a direction
Alt + Tab	Cycle windows on the workspace
Super + minus / Super + equal	Resize active window horizontally
Super + Shift + minus / Super + Shift + equal	Resize active window vertically
Super + Page_Up	Full screen
Super + Ctrl + F	Tiled full screen
Super + Alt + F	Full width
Super + Left-drag	Move window (mouse)
Super + Right-drag	Resize window (mouse)

Universal clipboard

Keys	Action
Super + C	Copy (sends Ctrl + Insert to the active window — terminal-safe)
Super + V	Paste (sends Shift + Insert)
Super + X	Cut (sends Ctrl + X)

Menus & utilities

Keys	Action
Super + Escape	Power/session menu (lock, suspend, hibernate, relaunch, reboot, shutdown)
Super + Alt + Space	Central system menu (Trigger / Setup / Style / System / Learn)
Super + K	Keybindings cheat sheet (searchable, from the live config)
Super + Ctrl + comma	Toggle notification do-not-disturb (was: dismiss all)
Super + Ctrl + Shift + comma	Dismiss all notifications
Super + N	Notification centre / history (shell only)
Super + Ctrl + R	Set a reminder
Super + Ctrl + Alt + R	Show pending reminders
Super + Ctrl + Shift + R	Clear reminders
Super + Ctrl + Alt + T	Notify date/time
Super + Ctrl + Alt + B	Notify battery status
Super + Ctrl + period	Transcode media file
Super + backslash	Cycle focused monitor scale
Super + Ctrl + Delete	Toggle laptop display
Super + Ctrl + A	Audio mixer (wiremix)
Super + Ctrl + B	Bluetooth (bluetui)
Super + Ctrl + W	Wi-Fi (nmtui)
Super + Alt + Return	tmux “Work” session
Super + Alt + D	lazydocker (needs marchyo.development.enable)
Super + Alt + Shift + F	File manager at the focused terminal’s cwd

Window grouping (tabbed/stacked)

Keys	Action
Super + Alt + G	Toggle window grouping
Super + Alt + Shift + G	Move window out of the group
Super + Alt + ←/→/↑/↓	Move window into a group in that direction
Super + Alt + Tab / Super + Alt + Shift + Tab	Next / previous window in group

Workspaces & scratchpad

Keys	Action
Super + 1…5	Switch to workspace (on the current monitor)
Super + Shift + 1…0	Move active window to workspace 1–10
Super + Shift + Alt + 1…0	Move window there silently (don’t follow)
Super + Tab / Super + Shift + Tab	Next / previous workspace
Super + Ctrl + Tab	Former workspace
Super + scroll	Scroll through workspaces
Super + D	Toggle the Drawer (scratchpad workspace)
Super + Shift + D	Send active window to the Drawer

Multi-monitor

Keys	Action
Ctrl + Alt + Tab / Ctrl + Alt + Shift + Tab	Focus next / previous monitor
Super + Shift + , / Super + Shift + .	Move active window to the adjacent monitor
Super + Shift + Alt + ←/→/↑/↓	Move the whole workspace to an adjacent monitor

Screenshots, clipboard & OCR

Keys	Action
Super + S (or Print)	Screenshot a region/window (copy + save)
Super + Shift + S (or Super + Shift + Print)	Screenshot a region and annotate (satty)
Super + Ctrl + S (or Shift + Print)	Screenshot the active window
Super + Alt + S (or Ctrl + Print)	Screenshot the current screen
Super + Ctrl + Alt + S (or Alt + Print)	Screenshot all screens
Super + Shift + O (or Super + Ctrl + Shift + S)	OCR a region → text to clipboard (tesseract)
Super + Ctrl + V	Clipboard history (in-shell from cliphist; vicinae with the shell off)
Super + Shift + C	Pick a color (hex to clipboard)

Screenshots land in ~/Pictures/Screenshots. Annotation and OCR can be turned off with marchyo.screenshot.enableAnnotation / enableOcr.

Dictation

Requires marchyo.dictation.enable. See the Dictation page for setup.

Keys	Action
F9 (hold)	Push-to-talk dictation
Super + Ctrl + X	Toggle recording on/off
Super + Shift + H	Floating dictation status window

Waybar mouse actions (shell off)

With marchyo.shell.enable = false, Waybar is the top bar. Segments that open a tool launch it as a centered floating popup — never as a tile in the workspace. Scrolling and right-clicks act in place.

Segment	Action
Workspace numbers	Click to switch workspace
Clock	Click to toggle the date/week-number format
· (left of the tray)	Hover to expand the system tray
Bell	Click to toggle notification do-not-disturb
Mic/dictation (if enabled)	Left-click toggles recording; right-click opens the floating status window
Layout code (en, fi, …)	Click to cycle keyboard layouts
bt	Click for the Bluetooth manager (bluetui, floating)
Wi-Fi / eth	Click for the Wi-Fi manager (nmtui, floating)
vol	Click for the audio mixer (wiremix, floating); right-click mutes; scroll changes volume
cpu	Click for the system monitor (btop, floating)
eco/bal/perf	Click to cycle the power profile (built into Waybar)
bat/chg/pwr	Click for the power/session menu (floating)

System & session

Keys	Action
Super + L	Lock the screen (the shell lock; hyprlock with the shell off)
Ctrl + Alt + Delete	Power off
Super + Shift + Space	Toggle the top bar
Super + ,	Dismiss last notification (Super + Ctrl + Shift + , dismisses all)
Super + Ctrl + I	Toggle idle lock (keep-awake)
Super + Ctrl + N	Toggle night light
Super + Alt + Print	Toggle screen recording
Super + Ctrl + Z / Super + Ctrl + Shift + Z / Super + Ctrl + Alt + Z	Zoom in / out / reset (magnifier)
Volume / brightness / media keys	XF86 laptop keys (volume, mic mute, brightness, play/pause/next/prev)

Shell panels

With the shell on (the desktop default), these binds summon the shell’s panels through marchyo shell toggle <panel>, and the window overview through marchyo shell overview:

Keys	Action
Super + Shift + Q	Control Center (volume and mic sliders, quick-toggle tiles)
Super + Shift + V	Audio panel
Super + Shift + N	Network panel
Super + Shift + B	Power panel
Super + Shift + M	Monitor panel
Super + `	Window overview: every workspace with live window previews; type to filter by title or class, arrows / Tab to move, Enter to focus, Escape to close