BetterStage Documentation

Everything you need to set up and master BetterStage — from your first stage to advanced auto-tiling and AI-powered workspace organization.

Getting Started

Install BetterStage, grant Accessibility permission, and create your first stage.

Stages

Named workspaces that span all monitors with instant keyboard switching.

Stages Bar

Visual overview panel showing all stages with live window thumbnails.

Window Modes

Per-monitor modes: macOS Native, Bento Box auto-tiling, or saved Tabbed Layouts.

Tabbed Layout Mode

Saved layouts where each pane can hold multiple windows you switch between with tabs. Pro.

Layout Presets

Built-in presets like Split View, Top / Bottom, Focus + Stack, and Four Corners. Save your own. Pro.

Window Management

Move windows between stages using shortcuts, the snap wheel, or multi-window grab.

AI Staging

Let AI analyze your open windows and organize them into project-focused stages.

Snap Zones

Snap windows to halves, quarters, thirds, and more with shortcuts or edge dragging.

Snap Wheel

Radial menu for snapping windows, switching stages, retiling, and quick actions.

Bento Box

Automatic tiling with drag handles, drop-to-swap, drop-on-edge insert, and live resize previews.

Keyboard Shortcuts

Complete shortcut reference for stage switching, window snapping, tiling, and navigation.

Monitor Management

Multi-monitor setups, pinned monitors, display ID persistence, and hot-plugging.

License Keys

Activate, redeem, and manage BetterStage license keys for Pro features.

Settings Reference

Every BetterStage setting grouped by pane, including Window Modes, AI Staging, Screen Layout, Pinned Displays, and Shortcuts.

Troubleshooting

Solutions to common issues: permissions, shortcuts, window detection, and crash recovery.