Documentation Index
Fetch the complete documentation index at: https://mintlify.com/shawal-mbalire/dotfiles/llms.txt
Use this file to discover all available pages before exploring further.
Overview
This configuration uses Super (Windows/Command key) as the main modifier key. Fish shell is configured with VI mode keybindings for command-line editing.
Hyprland Keybindings
Application Launchers
| Keybinding | Action | Application |
|---|
Super + Shift + Return | Launch terminal | Kitty |
Super + P | Application launcher | Rofi |
Super + E | File manager | Nautilus |
Super + Shift + N | Code editor | VS Code Insiders |
Super + Shift + O | Note taker | Obsidian |
Super + Shift + P | Web browser | Zen Browser |
Window Management
| Keybinding | Action |
|---|
Super + Shift + C | Kill active window |
Super + Shift + Q | Exit Hyprland |
Super + Alt + F | Toggle floating mode |
Super + Shift + T | Toggle split direction |
Super + R | Pseudo tile mode |
Alt + Tab | Focus current or last window |
Window Focus (VI-style)
| Keybinding | Direction |
|---|
Super + H | Focus up |
Super + J | Focus right |
Super + G | Focus down |
Super + F | Focus left |
Window Movement
| Keybinding | Direction |
|---|
Super + Shift + H | Move window up |
Super + Shift + J | Move window right |
Super + Shift + G | Move window down |
Super + Shift + F | Move window left |
Window Resizing
| Keybinding | Action |
|---|
Super + Ctrl + H | Resize left (-20px) |
Super + Ctrl + L | Resize right (+20px) |
Super + Ctrl + K | Resize up (-20px) |
Super + Ctrl + J | Resize down (+20px) |
Workspaces
Switch to workspace:
Super + [1-9,0] - Switch to workspace 1-10
Move window to workspace:
Super + Shift + [1-9,0] - Move active window to workspace 1-10
Special workspace (scratchpad):
Super + S - Toggle scratchpad visibilitySuper + Shift + S - Move window to scratchpad
Navigate workspaces:
Super + Mouse Wheel Up - Next workspaceSuper + Mouse Wheel Down - Previous workspace
Multi-Monitor
| Keybinding | Action |
|---|
Super + Alt + F | Move workspace to left monitor |
Super + Alt + J | Move workspace to right monitor |
Super + Alt + H | Move workspace to monitor above |
Super + Alt + G | Move workspace to monitor below |
System Controls
| Keybinding | Action |
|---|
Super + V | Clipboard history (Rofi) |
Super + Shift + V | Volume control (pavucontrol) |
Super + B | Toggle Waybar visibility |
Print | Screenshot (area select) |
| Key | Action |
|---|
XF86AudioRaiseVolume | Volume up 5% |
XF86AudioLowerVolume | Volume down 5% |
XF86AudioMute | Toggle mute |
XF86AudioMicMute | Toggle mic mute |
XF86MonBrightnessUp | Brightness up 10% |
XF86MonBrightnessDown | Brightness down 10% |
XF86AudioNext | Next track |
XF86AudioPrev | Previous track |
XF86AudioPlay/Pause | Play/pause |
Mouse Bindings
| Binding | Action |
|---|
Super + Left Click + Drag | Move window |
Super + Right Click + Drag | Resize window |
Customizing Hyprland Keybindings
Location
~/.config/hypr/modules/keybindings.conf
Syntax
bind = MODIFIERS, KEY, ACTION, PARAMETERS
bindm = MODIFIERS, MOUSE_BUTTON, ACTION # Mouse bindings
bindel = KEY, ACTION, PARAMETERS # Repeat on hold
bindl = KEY, ACTION, PARAMETERS # Works when locked
Examples
Launch an application:
bind = $mainMod SHIFT, RETURN, exec, kitty
bind = $mainMod, B, exec, firefox
bind = $mainMod, F, fullscreen,
bind = $mainMod SHIFT, C, killactive,
bind = $mainMod, SPACE, togglefloating,
# Resize by 50px instead of 20px
bind = $mainMod CTRL, H, resizeactive, -50 0
bind = $mainMod CTRL, L, resizeactive, 50 0
# In hyprland.conf
$mainMod = ALT # Use Alt instead of Super
Available Modifiers
SUPER / SUPER_L / SUPER_R - Windows/Command keyALT / ALT_L / ALT_R - Alt keyCTRL / CONTROL - Control keySHIFT - Shift key
Combine with spaces: SUPER SHIFT, CTRL ALT
Disabling Keybindings
Comment out lines with #:
# bind = $mainMod, E, exec, $fileManager
Fish Shell Keybindings
VI Mode
The configuration uses VI keybindings in insert mode:
# In ~/.config/fish/config.fish
fish_vi_key_bindings insert
VI Mode Keys
Normal mode (press Esc in command line):
| Key | Action |
|---|
h | Move cursor left |
l | Move cursor right |
b | Move word backward |
w | Move word forward |
0 | Move to line start |
$ | Move to line end |
dd | Delete line |
d$ | Delete to end of line |
dw | Delete word |
i | Enter insert mode |
a | Enter insert mode (after cursor) |
A | Enter insert mode (end of line) |
v | Visual mode |
/ | Search command history |
- Type normally
- Press
Esc to enter normal mode
Ctrl + C - Cancel current lineCtrl + D - Exit shell
Switching to Emacs Mode
For traditional bash-style keybindings:
# In ~/.config/fish/config.fish
# Replace this line:
fish_vi_key_bindings insert
# With this:
fish_default_key_bindings
Custom Fish Keybindings
Create custom bindings in config.fish:
# Insert mode binding
bind -M insert \cf forward-word # Ctrl+F to jump forward
# Normal mode binding
bind -M default \cg end-of-line # Ctrl+G to end of line
Fish Cursor Style
Customize cursor appearance:
# In config.fish
set fish_cursor_default block # Normal mode: block
set fish_cursor_insert line # Insert mode: line
set fish_cursor_visual underscore # Visual mode: underscore
set fish_cursor_replace_one underscore
Tmux
If using tmux with this configuration, you may want to coordinate prefix keys:
# Check current tmux prefix
tmux show-options -g prefix
Neovim
Neovim keybindings are separate and configured in ~/.config/nvim/. VI mode in Fish provides consistent muscle memory.
Quick Reference Card
Most Used Keybindings
Super + Shift + Return → Terminal
Super + P → App Launcher
Super + Shift + C → Close Window
Super + [1-9] → Switch Workspace
Super + H/J/G/F → Navigate Windows (VI-style)
Alt + Tab → Last Window
Print → Screenshot
Adding to Your Setup
- Edit keybindings:
~/.config/hypr/modules/keybindings.conf
- Reload Hyprland:
Super + Shift + Q (logout) then log back in, or reload config
- Test binding: Try your new keybinding
- Check conflicts: Make sure your new binding doesn’t conflict with existing ones
Troubleshooting
Keybinding Not Working
- Check for conflicts with other bindings
- Verify the application is installed:
which kitty # Or whatever app you're launching
- Test the command directly:
kitty # Should launch the terminal
- Check Hyprland logs:
Finding Key Names
Run wev or xev to see key names as you press them:
wev # Wayland event viewer