Keybindings & Navigation

The Marchyo desktop is keyboard-driven. Enabling marchyo.desktop.enable ships Hyprland with the keybindings below, plus the mako notification daemon, the vicinae launcher, cliphist clipboard history, and grimblast/satty/tesseract screenshots. Super is the primary modifier (the Windows/Command key).

Launching apps

Keys	Action
`Super + Return`	Terminal (Ghostty)
`Super + B`	Web browser
`Super + F`	File manager
`Super + R`	App launcher (vicinae)
`Super + M`	Music player
`Super + E`	Editor
`Super + O`	Obsidian
`Super + G`	Messenger
`Super + /`	Password manager (focuses 1Password if open)
`Super + A`	AI chat (only when `marchyo.ai.enable` is on and `marchyo.ai.tooling.enable` — the default — isn’t turned off)
`Super + .`	Emoji picker (vicinae)
`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 + 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 (vicinae/cliphist)
`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

Top bar (Waybar) mouse actions

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 (hyprlock)
`Ctrl + Alt + Delete`	Power off
`Super + Shift + Space`	Toggle the top bar (Waybar)
`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)