BetterStage Documentation
Everything you need to set up and master BetterStage — from your first stage to advanced auto-tiling and AI-powered workspace organization. Prefer task-based, step-by-step guides? Browse the tutorials.
Getting Started
Install BetterStage, grant Accessibility permission, and create your first stage.
Stages
Named workspaces that span all monitors with instant keyboard switching.
Workspaces & Continuity
Automatic restart, wake, and display recovery plus named Saved Workspaces. New in v1.3.0.
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
Describe your workspace in a chat panel and AI proposes a stage plan you can review, refine, apply, or undo. Works with your own API key or managed BetterStage AI (no key).
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, Displays, and Shortcuts.
Troubleshooting
Solutions to common issues: permissions, shortcuts, window detection, and crash recovery.