Mastering Niri Navigation: Shortcuts That Preserve Muscle Memory

The Consistency Principle

When I switched from Hyprland to Niri, I refused to relearn shortcuts. Instead, I designed a system that:

1. Preserves existing muscle memory — Same keys do similar things
2. Follows logical modifier patterns — The modifier tells you the action type
3. Works across compositors — Can port back to Hyprland if needed

The Modifier System

Every shortcut follows a pattern:

The insight: The modifier tells you “what kind of operation” before you press the key. This reduces cognitive load.

Application Launchers: Matching Expectations

Desktop users expect certain shortcuts. I matched them where possible:

The compromise: Super+Q for terminal differs from most setups (Super+Enter). I chose ergonomics over convention—Q is easier to hit than Enter.

binds {
    Mod+Q hotkey-overlay-title="Terminal" { spawn "kitty"; }
    F12 { spawn "dropdown-toggle"; }  // Quake-style dropdown
    Mod+R hotkey-overlay-title="Apps" { spawn "rofi" "-show" "drun"; }
    Mod+E hotkey-overlay-title="Files" { spawn "kitty" "-e" "yazi"; }
    Mod+W { toggle-overview; }
    Mod+N { spawn-sh "swaync-client -t -sw"; }
    Mod+X { spawn-sh "dms ipc call powermenu toggle"; }
    Super+Alt+L { spawn "swaylock"; }
}

Window Management: The Close/Float/Fullscreen Trio

Three operations I use constantly:

The migration: Hyprland used Q for close, but I wanted Q for terminal. C for Close is mnemonic and available.

binds {
    Mod+C repeat=false { close-window; }
    Mod+V { toggle-window-floating; }
    Mod+F { fullscreen-window; }
}

The repeat=false prevents accidentally closing multiple windows when holding the key.

Navigation: Column-Aware HJKL

Niri’s column model requires adapting vim-style navigation:

Traditional tiling: HJKL moves between windows in 4 directions Niri: H/L moves between columns, J/K moves within columns

flowchart TB
  subgraph col1["Column 1"]
    direction TB
    winA["Win A"]
    winB["Win B"]
    winA <-->|"Super+K / Super+J"| winB
  end
  subgraph col2["Column 2"]
    winC["Win C"]
  end
  col1 <-->|"Super+H / Super+L"| col2

The insight: This actually matches the mental model better. H/L is “switch context” (different column). J/K is “switch within context” (same column).

binds {
    // Vim-style
    Mod+H { focus-column-left; }
    Mod+L { focus-column-right; }
    Mod+K { focus-window-up; }
    Mod+J { focus-window-down; }

    // Arrow keys (same behavior)
    Mod+Left { focus-column-left; }
    Mod+Right { focus-column-right; }
    Mod+Up { focus-window-up; }
    Mod+Down { focus-window-down; }

    // Move windows (add Shift)
    Mod+Shift+H { move-column-left; }
    Mod+Shift+L { move-column-right; }
    Mod+Shift+K { move-window-up; }
    Mod+Shift+J { move-window-down; }
}

Workspaces: The Hardest Migration

Workspace shortcuts must be identical across compositors. Any change breaks muscle memory built over years.

Kept identical:

• Super+1-9,0 → Focus workspace 1-10
• Super+Tab → Previous workspace
• Super+Shift+1-9 → Move window to workspace

The Niri difference: Niri’s move-column-to-workspace always makes you follow the window. Hyprland has movetoworkspacesilent for “send without following.”

My compromise: I bound both Super+Shift+N and Super+Alt+N to the same action. The distinction is lost, but the muscle memory works.

binds {
    // Workspace focus (identical to Hyprland)
    Mod+1 { focus-workspace 1; }
    Mod+2 { focus-workspace 2; }
    // ... etc
    Mod+Tab { focus-workspace-previous; }

    // Move to workspace (both patterns do the same thing in Niri)
    Mod+Shift+1 { move-column-to-workspace 1; }
    Mod+Alt+1 { move-column-to-workspace 1; }
    // ... etc
}

Niri-Specific Features

Some features exist only in Niri. I chose shortcuts that don’t conflict:

binds {
    Mod+Shift+C { center-column; }
    Mod+Ctrl+R { switch-preset-column-width; }
    Mod+T { toggle-column-tabbed-display; }
    Mod+Comma { consume-window-into-column; }
    Mod+Period { expel-window-from-column; }
    Mod+BracketLeft { consume-or-expel-window-left; }
    Mod+BracketRight { consume-or-expel-window-right; }
}

Media Keys: Consistent Everywhere

Media keys should work the same regardless of compositor:

binds {
    XF86AudioRaiseVolume allow-when-locked=true {
        spawn-sh "wpctl set-volume @DEFAULT_AUDIO_SINK@ 0.05+ -l 1.0";
    }
    XF86AudioLowerVolume allow-when-locked=true {
        spawn-sh "wpctl set-volume @DEFAULT_AUDIO_SINK@ 0.05-";
    }
    XF86AudioMute allow-when-locked=true {
        spawn-sh "wpctl set-mute @DEFAULT_AUDIO_SINK@ toggle";
    }
    XF86MonBrightnessUp allow-when-locked=true {
        spawn "brightnessctl" "set" "+5%";
    }
    XF86MonBrightnessDown allow-when-locked=true {
        spawn "brightnessctl" "set" "5%-";
    }
}

The allow-when-locked=true ensures they work on the lock screen. This matches expected behavior.

binds {
    Print { screenshot; }                    // Full screen
    Ctrl+Print { screenshot-screen; }        // Current output
    Alt+Print { screenshot-window; }         // Current window
    Shift+Print {                            // Area (grim + slurp)
        spawn-sh "grim -g \"$(slurp)\" ~/Pictures/Screenshots/$(date +%Y%m%d_%H%M%S).png";
    }
    Ctrl+Shift+Print {                       // Area to clipboard
        spawn-sh "grim -g \"$(slurp)\" - | wl-copy";
    }
}

Migration Cheatsheet

If coming from Hyprland:

Design Summary

The result: 80% of my shortcuts are identical to Hyprland. 20% adapted to Niri’s model. The mental overhead of switching is minimal.

Next in this series: Desktop Polish: DankMaterialShell and the Perfect Rofi Launcher