Snap Wheel
Custom Actions
A Custom Action is one reusable action you create and assign to a Snap Wheel slot. BetterStage currently supports exactly four action types; it does not provide a native multi-step action builder.
The four action types
Open Application
Open one chosen .app. BetterStage verifies the saved path and bundle identity before launch.
Open File
Open one chosen file with its default macOS application.
Run Command
Run a saved zsh script in the background, or hand it to Terminal for visible output.
Run Shortcut
Run one macOS Shortcut by its exact name through the built-in Shortcuts command-line runner.
Create and assign one
- Open Settings > Snap Wheel.
- Choose Custom Actions (Experimental).
- Name the action, choose its type and target, then save it.
- Assign it to an inner, outer, More Actions, or custom-submenu slot.
Open Application uses the app's native icon. File, Command, and Shortcut actions can use a custom SF Symbol. Custom submenus themselves can be placed only on the outer ring.
Command safety and confirmation
Commands run with your macOS user permissions. Choose confirmation on the first run and after command edits, or on every run. Editing the command invalidates its previous first-run trust decision.
Background commands use /bin/zsh -f, do not load shell startup files, receive no stdin or terminal, and discard output. Their foreground deadline is 1–60 seconds. BetterStage makes a bounded stop attempt, but detached processes or work delegated to another app or service may continue.
Show a command in Terminal
Enable Show Terminal window while running to see the command and its output. macOS may ask you to allow BetterStage to automate Terminal. Once Terminal accepts the command, Terminal owns the process: the foreground deadline is disabled, and BetterStage cannot stop that command when BetterStage quits. Interrupt or close it in Terminal when needed. BetterStage does not log command text or output.
Backups and compatibility
Custom Action definitions and command files stay on this Mac and are not included in a Settings backup. A transferred Snap Wheel layout keeps only safe built-in actions; assign local Custom Actions again after import. Reset Layout and Reset All Settings preserve the action library, while Factory Reset removes it.
Back to
Snap Wheel →