StageHero.app Icon

URL Scheme

Control StageHero with URL commands. Perfect for automation and scripting.

Basics

StageHero responds to URL commands in two formats:

# Single command
stagehero://command=action

# Multiple commands
stagehero://stage/command=action&command=action

Examples using Terminal:

# Hide Dock
open "stagehero://dock=hide"

# Focus Mode
open "stagehero://stage/appearance=dark&desktopicons=hide&stagemanager=on&dock=hide&widgets=hide&menubar=hide&quickcontroller=hide&windows=hideall&activate=lastapp"

Commands

Stage

Run multiple commands at once to set your perfect stage.

stagehero://stage/appearance=dark&dock=hide  # Add more commands as needed

Appearance

Control system appearance mode.

stagehero://appearance=toggle
stagehero://appearance=light
stagehero://appearance=dark

Dock

Control Dock visibility state.

stagehero://dock=toggle
stagehero://dock=show
stagehero://dock=hide

Menu Bar

Control Menu Bar visibility state.

stagehero://menubar=toggle
stagehero://menubar=show
stagehero://menubar=hide

Desktop Icons

Control Desktop Icons visibility state.

stagehero://desktopicons=toggle
stagehero://desktopicons=show
stagehero://desktopicons=hide

Stage Manager

Control Stage Manager visibility state.

stagehero://stagemanager=toggle
stagehero://stagemanager=on
stagehero://stagemanager=off

Widgets

Control macOS Desktop Widgets visibility.

stagehero://widgets=toggle
stagehero://widgets=show
stagehero://widgets=hide

Quick Controller

Control the Quick Controller HUD visibility and state.

stagehero://quickcontroller=show
stagehero://quickcontroller=hide
stagehero://quickcontroller=toggle
stagehero://quickcontroller=refresh

Windows

Hide all visible application windows.

stagehero://windows=hideall

Activate

Return focus to the previously active application.

stagehero://activate=lastapp

Code Examples

Launcher

Create instant workflows using Spotlight, Raycast, or Alfred. Just paste these URLs:


Focus Mode

stagehero://stage/appearance=dark&desktopicons=hide&stagemanager=on&dock=hide&widgets=hide&menubar=hide&quickcontroller=hide&windows=hideall&activate=lastapp

Reset Mode

stagehero://stage/appearance=light&dock=show&menubar=show&widgets=show&desktopicons=show&stagemanager=off&quickcontroller=hide&activate=lastapp

Shell

#!/bin/bash
open "stagehero://stagemanager=on"
open "stagehero://desktopicons=hide"
# Add more commands

Python

import subprocess
import time

def stagehero(command):
    subprocess.run(['open', f'stagehero://{command}'])

stagehero('dock=hide')
stagehero('menubar=hide')
# Add more commands

AppleScript

-- Focus mode
tell application "StageHero"
    open location "stagehero://appearance=dark"
    open location "stagehero://dock=hide"
    open location "stagehero://menubar=hide"
    open location "stagehero://desktopicons=hide"
    open location "stagehero://stagemanager=on"
    open location "stagehero://widgets=hide"
    open location "stagehero://quickcontroller=hide"
    open location "stagehero://windows=hideall"
    open location "stagehero://activate=lastapp"
end tell

-- Reset mode
tell application "StageHero"
    open location "stagehero://appearance=light"
    open location "stagehero://dock=show"
    open location "stagehero://menubar=show"
    open location "stagehero://desktopicons=show"
    open location "stagehero://stagemanager=off"
    open location "stagehero://widgets=show"
    open location "stagehero://quickcontroller=hide"
    open location "stagehero://activate=lastapp"
end tell
Download StageHero.app

macOS 14.4+