Keyboard Shortcuts

Tabularis ships with a set of keyboard shortcuts for common actions across navigation, the editor, and the data grid. All shortcuts use Cmd on macOS and Ctrl on Windows/Linux.

Navigation

Editor

Notebook

Data Grid

Cell navigation is bound to the grid you last interacted with, so a notebook with one grid per SQL cell does not move them all at once. Keys are left alone inside text inputs, open cell editors, the foreign-key and BLOB buttons, and the sort buttons in column headers. See Data Grid → Keyboard Navigation.

Since v0.22.0 the selection shortcuts (Shift+Arrow, Ctrl/Cmd+Arrow, Shift+Space, Ctrl/Cmd+Space) are relative to the focused cell and are not overridable. Ctrl/Cmd+Shift+Space is offered as an alternative for column selection because plain Ctrl+Space is often captured by an input method (ibus, fcitx) on Linux or by Spotlight on macOS. Note that with a focused cell, Ctrl/Cmd+← / → jumps to the grid edge; the Next page / Previous page shortcuts still apply when no cell is focused and from the pagination buttons.

Customizing Shortcuts

Most shortcuts can be reassigned from Settings → Keyboard Shortcuts. Each row in the table shows:

• A lock icon for built-in shortcuts that cannot be changed (Monaco editor bindings, browser-level shortcuts).
• An Edit button for customizable shortcuts.

Click Edit on any customizable row, then press the key combination you want to assign. The recorder captures modifier keys (Cmd/Ctrl, Shift, Alt) plus the final key. Press Escape to cancel. Changes are saved immediately to keybindings.json in your config directory.

Since v0.26.0 the editor validates the combination before saving it. A combination without a modifier is refused with "Add a modifier key, such as Ctrl or Alt.", and one already used by another shortcut names it ("This shortcut conflicts with “Toggle sidebar”.") instead of silently replacing it.

Shortcuts also record the physical key (code) next to the character (key), so they keep working on non-US layouts such as AZERTY or QWERTZ. An override matches either one, which means that on some layouts a shortcut has two triggers: on AZERTY, Open settings fires on both Ctrl+, and Ctrl+;. This is intended.

To revert a customized shortcut to its default, click the ↺ (reset) button on its row.

keybindings.json

Tabularis stores your overrides in a JSON file in the OS config directory:

The file is only created when you first customize a shortcut. Its format is a map from shortcut ID to platform-specific KeyMatch objects:

{
  "toggle_sidebar": {
    "mac": { "metaKey": true, "key": "e", "code": "KeyE" },
    "win": { "ctrlKey": true, "key": "e", "code": "KeyE" }
  },
  "new_tab": {
    "mac": { "metaKey": true, "key": "n" },
    "win": { "ctrlKey": true, "key": "n" }
  }
}

Each KeyMatch supports the following fields:

You can edit this file manually if you prefer. Tabularis reads it at startup; changes while the app is running take effect after a restart.