Window Management

Bento Box Auto-Tiling

Pro Feature

Bento Box is a BSP (binary space partitioning) auto-tiling engine that automatically arranges windows into a non-overlapping grid layout. Every window gets its own space — no manual positioning required.

Per-Stage Toggle

Auto-tiling is a per-stage setting. Press Opt+B to toggle Bento Box on or off for the current stage. New stages inherit the default from Settings > Tiling > Auto-tiling enabled by default.

When Bento Box is active for a stage, snap zones are automatically disabled for that stage to prevent conflicts between manual snapping and auto-tiling.

You can also toggle Bento Box from the Snap Wheel's Extras submenu, or exclude individual apps from tiling via the Ignore action.

Grid Settings

Configure the grid dimensions and spacing in Settings > Tiling.

Grid Dimensions

Set the number of columns and rows for the tiling grid. Only even numbers are allowed (2, 4, 6, 8, 10, 12, 14, 16). The default is 16 columns by 10 rows.

Gap Size

Set the pixel gap between tiled windows. A gap of 0 means windows sit edge-to-edge. Increase the gap for visual separation between tiles.

Ignored Apps

Some apps don't work well with auto-tiling. Add them to the ignore list in Settings > Tiling > Ignored Apps and Bento Box will leave them untouched. Ignored apps float freely above the tiled layout.

BetterStage automatically detects small and utility windows — such as preference dialogs, color pickers, and popovers — and excludes them from the tiling layout. These popup windows float freely without disrupting the grid.

Window Overflow

When more windows are added than the grid can comfortably fit, Bento Box continues to subdivide the BSP tree. Windows progressively share smaller tiles. You can manually retile the layout at any time with Opt+Down to rebalance the tree.

Pin Windows

Pin a window to lock its position and size within the Bento Box grid. Pinned windows hold their place during retile, maximize, and stage switches.

  • Press Ctrl+Opt+P to toggle pin on the focused window, or use the Snap Wheel's Pin slice.
  • A small pin badge appears on the window's top edge to indicate it's pinned.
  • Pinned windows are excluded from retile and maximize — other windows flow around them.
  • Move or resize a pinned window and the pin updates to the new position automatically.
  • Pin state is persisted across app restarts. All pins are cleared when Bento Box is disabled for the stage.

Live Resize & Drag

Resize a tiled window by dragging its edge — the adjacent tile resizes proportionally to fill the gap. Drag a window within the grid to swap its position with another tile. The layout updates in real time.

Drag a window to a different monitor and the destination monitor's grid retiles automatically to accommodate it.

Next

Keyboard Shortcuts