Core Features

Shortcuts & Settings

GridLion can be quiet and keyboard-first, visual and mouse-friendly, or both. Most behavior can be tuned globally or per display.

Global shortcuts

Use global shortcuts for common actions that should work from any app:

  • Move left, right, up, or down in the grid.
  • Open the manual OSD space picker.
  • Jump directly to Spaces 1 through 10.
  • Return to the last-used Space.

Per-display shortcuts

Per-display shortcuts target a specific display identifier. They are useful when your cursor is on one screen but you want to switch Spaces on another.

When the OSD is shown for a per-display shortcut, GridLion places it on the target display.

OSD picker behavior

The picker supports keyboard selection, mouse selection, and drag reordering. You can configure whether mouse-up on a non-active real cell switches immediately.

Manual picker mode uses Return to switch and Escape to dismiss. Placeholder targets can be highlighted but will not switch.

Appearance

Display OSD settings control placement, backdrop opacity, preview tint, appearance mode, and the active Space highlight color. The active highlight can use a fixed color or the current macOS system highlight color.

The persistent overlay uses the same active color and renders a compact grid for the display.

Preview snapshots

Snapshot settings control timing and method. Screen mode uses active-screen captures. Window mode uses synthetic window composition for all screenshot cells when enough window data is available.

  • Performant waits for event-driven refreshes.
  • Optimised adds periodic refreshes at a moderate cadence.
  • Power refreshes more aggressively.