Keybindings
Master Keybindings Guide
This document provides a comprehensive overview of the keyboard-driven workflows designed for this system. Our philosophy prioritizes speed, consistency across environments (Hyprland, Niri, Tmux), and minimal hand movement.
πͺ Window Management (Hyprland & Niri)
The Super (Windows/Command) key is your primary modifier (Mod).
Both Hyprland and Niri share a highly unified set of core navigation and window management bindings.
| Action | Keybinding |
|---|---|
| Launch Terminal (Foot) | Mod + Return |
| Launch Clone Terminal (Same CWD) | Mod + Alt + Return |
| App Launcher (Rofi) | Mod + Space |
| Interactive Cheat Sheet | Mod + Shift + ? |
| Translate Selection/Text | Mod + Alt + T |
| Close Window | Mod + Q |
| Toggle Floating | Mod + Shift + T (Niri) / Mod + F (Hyprland) |
| Fullscreen | Mod + Shift + F |
| Move Focus (Vim-style) | Mod + H/J/K/L or Arrow Keys |
| Move Window (Vim-style) | Mod + Shift + H/J/K/L or Shift + Arrow Keys |
| Move Focus to Monitor | Mod + Ctrl + H/J/K/L or Ctrl + Arrow Keys |
| Move Window to Monitor | Mod + Shift + Ctrl + H/J/K/L or Shift+Ctrl+Arrow Keys |
π Workspaces
| Action | Keybinding |
|---|---|
| Switch Workspace | Mod + 1-9 |
| Move Window to Workspace | Mod + Shift + 1-9 |
| Scroll Workspaces | Mod + Mouse Wheel |
| Overview / Toggle Workspace View | Mod + Tab |
| Swap with Master (Hyprland) | Mod + Shift + Tab |
| Add / Remove Master (Hyprland) | Mod + Ctrl (+ Shift) + Tab |
π§ Scratchpads & Overlays (Hyprland)
| Action | Keybinding |
|---|---|
| Terminal Scratchpad | `Mod + β (Grave) |
| Pad Scratchpad | Mod + S |
| Send to Pad (Silent) | Mod + Alt + S |
πΈ Media & Capture (Screencast, Screenshot, Draw)
We have removed legacy Print Screen bindings. All capture tools use universally recognized combinations that work identically in both Niri and Hyprland.
| Action | Keybinding | Tool Used |
|---|---|---|
| Screen Draw (Annotate) | Mod + D | gromit-mpx |
| Screenshot (Region) | Mod + Shift + S | grim + slurp |
| Screenshot + Annotate | Mod + Shift + A | grim + swappy |
| Screencast (Toggle) | Mod + Alt + R | wf-recorder |
| Scan QR Code on Screen | Mod + Alt + Q | zbarimg |
- Screendraw: A toggle. Once active, use your mouse to draw on the screen. Left-click for red, Shift+Left for blue, Ctrl+Left for yellow, Right-click to erase.
- Screencast: A toggle. Recordings are saved to
~/videos/screencasts/with a timestamp and automatically copied to your clipboard as a URI. - Screenshots: Saved to
~/pictures/screenshots/hey/and copied to the clipboard as an image.
π Hyprland Advanced Capture Submap
For more granular control in Hyprland, press Mod + X to enter the Capture Submap. Your prompt will change.
While in the submap, press:
S(Region),W(Window),M(Monitor) to Screenshot.Shift + S/W/Mto Screenshot + Annotate (Swappy).Alt + S/W/Mto Record Screencast.Qto Scan QR Code. (Press Escape to exit the submap).
π Tmux & Terminal Multiplexing
The Tmux Prefix is Ctrl + C (Press twice to send a literal Ctrl+C).
Tmux is configured to act like a native tiling window manager. We use βAltβ (Option on Mac keyboards) as a direct bridge, meaning you do not need to press the Prefix for common navigation!
β‘ No-Prefix Navigation (Instant)
| Action | Keybinding |
|---|---|
| Move Pane Focus (Vim-style) | Alt + H/J/K/L |
| Switch to Window 1-9 | Alt + 1-9 |
π οΈ Prefix Commands (Requires Ctrl + C first)
| Action | Keybinding |
|---|---|
| Vertical Split (Same Path) | v or % |
| Horizontal Split (Same Path) | s or " |
| New Window (Same Path) | c |
| Toggle Zoom (Fullscreen Pane) | o |
| Kill Pane / Window | x / X |
π Interactive FZF Popups (Requires Ctrl + C first)
These commands render beautiful, rounded floating windows in the center of your terminal.
| Action | Keybinding | Tool Used |
|---|---|---|
| Workmux (Branch/Worktree) | w | workmux |
| Session Switcher | S or / | sessionmenu.janet |
| File Picker (Paste Path) | f | filepicker.janet |
π Zsh & FZF Shell Navigation
Optimized for high-speed terminal interaction.
| Action | Keybinding | Description |
|---|---|---|
| Fuzzy File Search | Alt + F | Searches files and pastes the path at your cursor. |
| Fuzzy Directory Jump | Alt + C | Instantly cd into any subdirectory. |
| Fuzzy History Search | Ctrl + R or Alt + H | Search past commands with fzf. |
| Toggle Background Job | Ctrl + Z | Instantly suspend a process (like nvim) or bring it back. |
| History Substring Search | Up / Down Arrows | Type git, press Up, see only past git commands. |
π Zsh Vim-Style Editing (Insert Mode)
| Action | Keybinding |
|---|---|
| Beginning/End of Line | Ctrl + A / Ctrl + E |
| Forward/Backward Word | Ctrl + F / Ctrl + B |
| Kill Line (Forward/Backward) | Ctrl + K / Ctrl + U |
| Kill Word (Backward) | Ctrl + W |
βοΈ System Controls (Hardware/Media)
These bindings work globally across all environments and even when the screen is locked.
| Action | Keybinding | Tool Used |
|---|---|---|
| Volume Up / Down | Volume Keys | pamixer + OSD |
| Mute Audio | Mute Key | pamixer + OSD |
| Brightness Up / Down | Brightness Keys | brightnessctl + OSD |
| Toggle Notifications | Mod + Escape | dms or makoctl |
| Screen Zoom (Accessibility) | Mod + Z (Hyprland) | Hyprland internal |
π€ AI & Utilities (Ollama Backend)
These tools leverage your local AI models for a smarter workflow.
| Action | Keybinding / Command | Description |
|---|---|---|
| Translate Selection | Mod + Alt + T | Interactive translation menu. |
| AI Commit Gen | hey .commit-gen | Generates a commit message from your staged diff. |
| Funny AI Commit | hey .commit-gen --funny | Sarcastic commit message generator. |
| AI Fortune | hey .fortune | A witty developer fortune with ASCII art. |
| System Roast | hey .roast | AI brutally roasts your system stats. |