Settings Reference

Start BetterStage automatically when you log in to macOS. Uses the native SMAppService launch-at-login mechanism.

Automatically switch to a stage when one of its windows gains focus. For example, if you click a window that belongs to Stage 2 while Stage 1 is active, BetterStage switches to Stage 2 automatically.

Choose between multi-square indicators that show all stages as small squares in the menu bar, or classic text that displays the active stage name.

Enable Bento Box auto-tiling for new stages. When enabled, windows added to a stage are automatically placed into the tiling grid. This is a default for new stages — each stage can override it individually. When auto-tiling is active on a stage, snap zones are disabled for that stage.

Number of columns in the tiling grid. Must be an even number between 2 and 16. Even numbers ensure windows can be split symmetrically.

Number of rows in the tiling grid. Must be an even number between 2 and 16.

Pixel gap between tiled windows. Set to 0 for edge-to-edge tiling, or increase for visible spacing between windows.

Configure one or more triggers to activate the snap wheel. All active triggers work simultaneously. Click Add Trigger to choose from presets or record a custom combo. Each trigger can be set to hold or toggle mode independently.

Default trigger: middle-click anywhere (toggle). Presets include Ctrl+Opt hold, middle-click hold, left-click drag on title bar, and Opt+drag near title bar.

Enable keyboard and edge-drag snap zones. When active, dragging a window to the edge of a screen or using keyboard shortcuts snaps it to predefined zones (halves, quarters, thirds, etc.).