Skip to main content

keymap

The single reference for every keyboard chord in the session: shell chords drive the panel, dock, popups, and overview; the compositor owns window chords. The two sets never overlap — shell chords stay off Super+{tap,PgUp,PgDn,arrows,R,T} and Alt+{Tab,F4}, pinned by collision tests on both crates.

Shell: focus movement​

The shell keeps one keyboard cursor on a region: the panel strip (clock, three tiles, hosted indicator cells), the dock slots, an open popup's rows, or the overview's result list. The focused stop paints an accent ring.

ChordEffect
Tab / Shift+TabNext / previous stop or row, wrapping
Left / RightPrevious / next stop or row
Up / DownPanel to dock and back; rows inside a popup or the overview
F6Cycle panel and dock regions (skips an empty dock)
Super+DFocus the dock
Alt+F1Focus the panel

While the overview is open, movement keys walk the result list; the region keys still jump the shell underneath.

Shell: activation and Escape​

ChordEffect
Enter, overview openActivate the focused result row (top hit from any other region)
Enter, overview closedActivate the focused stop: strip stops toggle their popups, dock slots take a left press (launch, switch, stack), popup rows fire
Typing, overview openSearch query (restarts the result cursor)
Backspace, overview openErase a query character
Escape, popup openClose the popup, restore the parked shell focus
Escape, overview open, no popupDismiss the overview onto the previously focused window
Escape, all closedNo-op

Opening a popup or the overview parks the live cursor on a return stack; closing settles back through it, so focus never sticks on a closed surface. No chord here is rebindable yet; there is no AT-SPI bridge yet.

Compositor: windows and session​

ChordEffect
Super tapToggle the overview
Super+PgUp / Super+PgDnSwitch workspace (plus Shift: move the focused window and follow)
Alt+Tab / Shift+Alt+TabStep the window switcher; Alt release commits, Escape cancels
Super+Up / Super+DownMaximize / restore the focused window
Super+Left / Super+RightTile the focused window left / right half
Alt+F4Ask the focused window to close
Super+Shift+TFlip floating / strip session mode
Super+R / Super+Shift+RStep the focused column through width presets (strip mode)
Super+Left / Super+RightStrip mode: focus the column left / right (plus Shift: move the column)
Super+Up / Super+DownStrip mode, in a shared column: focus the window above / below (plus Shift: move it); a lone window keeps the gnome meaning above
Super+[ / Super+]Strip mode: a lone window joins the bottom of the column on that side; a window sharing a column leaves it for a new column on that side (niri consume-or-expel-window-left/right)
Super+, / Super+.Strip mode: take the next column's top window into the focused column / send its bottom window out to a new column on the right (niri consume-window-into-column / expel-window-from-column)
Super+left-dragMove a window; in strip mode drop it at the nearest column gap, or into a column at the nearest window edge. The modifier follows mouse-button-modifier
Super+middle-dragResize from the edges of the window third under the pointer; its middle third is a plain click. Strip mode: the column width, or the window's height inside a shared column. Right instead of middle with resize-with-right-button
Super+right-clickGNOME's window menu, in both modes. Middle instead of right with resize-with-right-button

GTK shell: top bar, menus, overview​

The GTK shell follows GNOME 51's chords, every one rebindable through its settings key (org.gnome.shell.keybindings, org.gnome.desktop.wm.keybindings, org.gnome.mutter.keybindings, org.gnome.settings-daemon.plugins.media-keys):

ChordEffect
Ctrl+Alt+Tab / Ctrl+Alt+Shift+TabFocus the top bar: first / last control (switch-panels)
Tab / Shift+Tab, bar focusedWalk every panel control: Activities, clock, tray icons, accessibility, system
Left / Right, bar focused, no menuWalk the bar's controls (an open menu owns the arrows)
Down, panel menu button focusedOpen its menu with the first item focused (popupMenu.js _onKeyPress)
Left / Right, panel menu openMove inside the menu; at its edge, close it and open the neighbouring panel menu (panelMenu.js _onMenuKeyPress, PopupMenuManager _changeMenu)
Enter / Space, bar focusedActivate the focused control; on Activities, toggle the overview
Escape, panel menu openClose the menu; focus stays on its button
Escape, bar focused, no menuReturn focus to the client
Super+S / Super+VQuick settings / date menu; Tab, arrows and Enter operate them, Escape closes
Shift+F10 / Menu, quick settingsOn a toggle with a menu (or its arrow), the volume slider, or Power Off: open that menu (St popup-menu)
Delete / BackSpace, notification focusedClose it: a banner as dismissed, a list message or collapsed group from the list (messageList.js)
Enter / Escape, date menu message listEnter on a collapsed group expands it (focus moves into it); Escape collapses it back onto the group before the menu closes (calendar.js)
Super+AApp grid: Tab or Down from the search entry focuses the first tile, arrows and Tab walk the tiles across pages, PgUp/PgDn turn pages, Enter launches, Escape leaves
Tab / Down, overview entry, no searchInto the window previews (the app grid on Super+A), named by window title; arrows and Tab move between them, Enter activates the window, Up from the top row or Shift+Tab from the first returns to the entry, typing returns to it with the text (overviewControls.js focus chain)
Super+1..9 / Super+Ctrl+1..9Dash app: switch-or-launch / open a new window
Super+NFocus the notification banner itself (Enter activates it, Tab reaches its buttons); Escape releases the keyboard and expires the banner (messageTray.js)
Super+Alt+SScreen reader on/off (gsd's screenreader key)
Print / Shift+Print / Alt+PrintScreenshot UI / fullscreen shot / window shot (S/C/W pick, Enter, Space or Ctrl+C captures, Escape closes)

While the bar holds keyboard focus, NORMAL/OVERVIEW chords pause (the compositor's exclusive-popup mode); volume, brightness and input-source keys keep working. Opening the overview hands the keyboard over; closing it releases a hold the bar never won.

P-A11Y-02 audit: every pointer action's keyboard route​

Enumerated from crates/shell-gtk/src (every connect_clicked, GestureClick, drag/drop and long-press handler) against gnome-shell 51.0 (js/ui, src/st). "GNOME route" cites where GNOME 51 binds the key; where GNOME has no keyboard route the row is parity, not a gap. Proof gates are in scripts/tuna-gtk-shell-proof (the P-A11Y-02 ones in scripts/lib/tuna-keyboard-routes-proof.sh, also run alone with --keyboard-routes-only); each drives real X11 keys through the nested session and reads the AT-SPI tree or the bus back. Banner-focus gates wait up to five seconds for the exact banner's showing/focused state after one chord; they do not repeat the key or accept another focused control.

SurfacePointer actionTuna keyboard routeGNOME 51 routeEvidenceState
Top barActivities clickSuper tap; Ctrl+Alt+Tab then Enter on Activitiestoggle-overview; panel.js Top Bar group (ctrlAltTab.js)G-PANEL-FOCUS, G-OVERVIEW-STATE-KEYSDone
Top barClock / System / Accessibility / input-source clickCtrl+Alt+Tab, Tab/arrows, Enter; Down opens with focus inside; Super+V / Super+SpopupMenu.js _onKeyPress (Space/Return toggle, Down opens and focuses)G-PANEL-FOCUS, G-PANEL-MENU-KEYS, G-KEYBINDINGSDone
Top barHover another panel button while a menu is open (switch menus)Left/Right at the open menu's edgepanelMenu.js _onMenuKeyPress, popupMenu.js PopupMenuManager key-focus _changeMenuG-PANEL-MENU-KEYSDone (keyboard); pointer hover-switch itself is not implemented
Top barTray icon click / menu rowsCtrl+Alt+Tab, Tab to the icon, Enter, rows by Tab + Enterpanel.js / StatusNotifier extension behaviour— (no items in the proof env)Owned by ShellFeatureGaps (tray.rs); Left/Right menu switching does not leave tray menus
Top barScreencast indicator StopCtrl+Alt+Tab, Tab, Enterpanel indicator button— (no recorder in the proof env)Implemented, unproven
Quick settingsToggles, sliders, round buttons, menu rowsSuper+S, Tab/arrows, Enter/Space; sliders take arrowsSt focus managerG-KEYBINDINGS, A11Y-QSDone
Quick settingsArrow of a toggle with a menu; volume menu arrow; Power OffAlso Shift+F10 / Menu on the toggle, the slider or Power Offst-widget.c popup-menu keys; quickSettings.js QuickMenuToggle/QuickSlider, status/system.js ShutdownItemG-QS-MENU-KEYDone
Quick settingsPower rows (Suspend, Restart…, Power Off…, Log Out…)Tab + Enter; the dialog focuses Cancel, Escape cancelsendSessionDialog.jsG-POWER-ESCAPEDone
Date menuCalendar days, month arrows, Today, events card, Clear, DNDSuper+V, Tab/arrows + Entercalendar.js / dateMenu.js can_focus buttonsG-KEYBINDINGS (menu), A11Y goldenDone
Date menuWorld Clocks card, Weather card (open Clocks, open Weather)Super+V, Tab/arrows + EnterdateMenu.js WorldClocksSection / WeatherSection can_focus buttonsG-DATEMENU-WORLD-CLOCKS (activated through the accessible action), G-DATEMENU-WEATHER (also Shift+Tab to the card, which scrolls into view, and Enter)Done
Date menuNotification close buttonDelete/BackSpace on the focused message, or Tab to Close + EntermessageList.js Message bindings (_closeIfAllowed)G-NOTIFICATION-KEYSDone
Date menuCollapsed group click (expand), Collapse buttonEnter expands with focus inside; Escape collapses back onto the group before the menu closesmessageList.js group clicked; calendar.js _keyController EscapeG-NOTIFICATION-KEYSDone
Date menuMessage body click (activate)—Message vfunc_clicked (Enter)—Pointer action itself absent from Tuna's list cards (P-NT row)
BannerBanner click (default action), action buttons, CloseSuper+N focuses the banner itself (Enter activates it); Tab + Enter its buttons; Delete closes; Escape releases and expires itfocus-active-notification; messageTray.js Escape close binding; messageList.js DeleteG-NOTIFICATION-FOCUS-KEY, G-NOTIFICATION-KEYS, G-ORCA-SPEECH-NOTIFYDone
OverviewSearch entry, result clickTyping, Enter (top hit), Tab/Down to a row + EntersearchController.js _onKeyPressG-OV-LAUNCH, G-SEARCH-ACTIVATEDone
OverviewWindow preview clickSuper, Tab/Down from the search entry, arrows/Tab + Enter (Up or Shift+Tab back to the entry); or Alt+TabwindowPreview.js Return activate, focus chain overviewControls.js vfunc_navigate_focusG-ORCA-SPEECH-PREVIEWS, G-WINDOW-SWITCHER, G-SWITCHERDone
OverviewWindow preview close buttonAlt+Tab to the window, Alt+F4none: the close St.Button is not can_focus (windowPreview.js)G-WM-KEYSParity
OverviewDrag a preview to another workspaceSuper+Shift+PgUp/PgDnnone (drag only, dnd.js)G-WM-KEYSParity
OverviewWorkspace thumbnail clickSuper+PgUp/PgDn, Ctrl+Alt+arrowsnone: thumbnails are not focusable (workspaceThumbnail.js)G-WS-POPUP, J-WS-NEXTParity
OverviewDash item click / Show AppsSuper+1..9 / Super+Ctrl+1..9, Super+ADash Ctrl+Alt+Tab group (dash.js); toggle-application-viewG-KEYBINDINGSDash focus group: open (Ctrl+Alt+Tab group popup)
App gridIcon click, page arrows/dotsSuper+A, Tab/Down from the search entry, arrows/Tab across pages, PgUp/PgDn turn pages, Enter launches, Escape leavesarrows/Tab (St focus), PgUp/PgDn/Home/End (appDisplay.js AppDisplay bindings)G-ORCA-SPEECH-GRIDDone; Home/End (first/last page) not bound
App gridIcon right-click / long press (context menu)—Shift+F10 / Menu (appDisplay.js AppIcon popup-menu)—Pointer action absent: Tuna has no app-icon context menu yet
App gridFolder click, rename, remove; drag to reorder, into/out of foldersEnter on the folder icon opens the dialog (Rename focused); Escape unwinds without saving; reorder: nonefolder: Enter on the icon; reorder: none (dnd only)Verified in sourceFolder: done; reorder: parity
BackgroundRight-click / long press background menu—none (backgroundMenu.js gestures only)—Parity (Tuna has no background menu)
Window menuRows (Alt+Space or Super+right-click)Alt+Space, Up/Down, Enter, EscapewindowMenu.js PopupMenu; St focus Up/DownG-WM-KEYS, G-WINDOW-MENU-KEYSDone
Alt+TabClick an itemAlt+Tab / arrows / Q / W, F4; release commitsswitcherPopup.js, altTab.js _keyPressHandlerG-WINDOW-SWITCHER, G-SWITCHER-GROUPDone
Ctrl+Alt+TabGroup popup (Windows, Top Bar, Dash, Search, Apps)Ctrl+Alt+Tab focuses the bar directly. GNOME's ctrlAltTab.js does the same for a quick press in a session whose only group is the bar, but with Ctrl+Alt held it shows CtrlAltTabPopup, a switcher of the focus groups, Tab stepping while held and release focusing the selectionctrlAltTab.js CtrlAltTabPopupG-PANEL-FOCUSOpen: no held-modifier group popup and no overview groups
Screenshot UIMode buttons, selection drag, window pick, Capture, closeS/C/W/V/P, arrows (+Alt/Shift/Ctrl), R, Enter/Space/Ctrl+C, Escapescreenshot.js binding poolG-SCREENSHOT-UI, G-SCREENSHOT-KEYS, G-SCREENSHOT-CTRL-CDone
LockCurtain click/drag; prompt; CancelAny key but Shift/Caps lifts, Enter submits, Escape lowersunlockDialog.js _onKeyPressG-LOCK-CURTAIN-CLOCK, G-LOCK-FIRST-PRINTABLEDone; lock-screen panel (switch-panels) open, #352
DialogsPolkit, network secrets, end-session, run, consent, display change, audio selection, location, kbd-a11y confirm, folderExclusive keyboard, first control focused, Tab/Enter, Escape cancelsModalDialog keysG-POLKIT, G-POWER-ESCAPE, G-LOCKDOWN-COMMAND-LINE, G-SCREENSHOT-UIDone
OSKKey taps, long press, swipeNot applicable: the physical keyboardnone: OSK keys are not can_focus (keyboard.js)—Parity
IBus candidatesCandidate / page clickThe engine's keys through the focused fieldcandidatePopup.js (no focus)G-IME-CANDIDATESParity
Pointer a11yDwell click-type chooserCtrl+Alt+Tab to its panel buttondwellClick.js panel menu—Implemented, unproven