Automate HazeOver to Create
Your Perfect Focused Workflow

HazeOver dimming state and settings can be read, controlled, and automated with Shortcuts app, Automations, Focus Filters, third-party tools, and AppleScript. Combine that with other apps, conditions, and system settings to set up your perfect environment.

For example, a keyboard shortcut or some automated event can turn on HazeOver dimming, Dark Mode, and Do Not Disturb for you.

Other ideas: hide the Dock and menu bar, set HazeOver intensity or color, and open your productivity app, all in one step after a bit of initial setup.

Try in Shortcuts App →

How to Use Shortcuts App

The Shortcuts app lets you combine multiple steps across apps into a single action. HazeOver’s dedicated actions let you control dimming, intensity, and display modes as part of any workflow. Run them from a keyboard shortcut, Siri, Spotlight, the menu bar, Control Center, or automate them. Spotlight actions, Control Center controls, and automations need macOS Tahoe 26 or later.

To create a shortcut:

  1. Open the Shortcuts app and click All Shortcuts in the sidebar
  2. Click + in the toolbar (or choose File > New Shortcut)
  3. In the Action Library on the right, click HazeOver under Apps to reveal its actions
    You can also type to search for HazeOver or a specific action name
  4. Double-click or drag actions into the shortcut editor

Click ▶ Run to try it out, or set up one of the following:

HazeOver actions also work directly in Spotlight, no shortcut required:

  1. Open Spotlight and search for HazeOver or an action name like Set Dimming Intensity
    Press Command-3 to narrow your search to just actions
  2. Click Add quick keys next to the action, type a short code like hzo, and press Return
  3. Run the action by typing the quick key in Spotlight and pressing Return

You can also run shortcuts from Control Center or the menu bar:

  1. Click Control Center in the menu bar, then click Edit Controls
  2. Click Shortcuts on the left
  3. Click Run Shortcut and choose Add to Control Center or Add to Menu Bar, or drag it where you want it
  4. Click Choose, pick a shortcut, then click Done
  5. Click Done at the bottom of the gallery

Add multiple controls for different intensities or modes.

Actions Supported by HazeOver

How to Use Automations

Shortcuts can run automatically in response to events, such as an app opening or a set time of day. To add a trigger to a shortcut:

  1. Double-click a shortcut with HazeOver actions, or create a new one
  2. In the Action Library on the right, click Automation, then double-click a trigger such as App or Time of Day
  3. Configure the trigger at the top of the shortcut, for example choose which app
  4. To get a notification each time it runs, click › next to the trigger, then select Notify

Click Automation in the sidebar to see all your automations and turn them on or off.

In macOS Tahoe 26, automations are set up separately from shortcuts:

  1. Open the Shortcuts app and click Automation in the sidebar
  2. Click + (or choose File > New Automation)
  3. Choose a trigger and click Next
  4. Configure its options, select Run Immediately, then click Next
  5. Pick an existing shortcut, or click New Shortcut to build one with HazeOver actions, then click Done


HazeOver actions pair naturally with automation triggers, for example:

For a dedicated Focus integration with automatic revert, see Focus filters.

How to Use Focus Filters

Focus filters apply custom HazeOver settings when a Focus is turned on, and revert them automatically when it’s turned off (unless you changed them manually in the meantime). A Focus can turn on automatically during set hours, when a certain app is open, or when you’re at a certain location. For example, enable dimming while at work and have it revert when you’re done.

  1. Open System Settings and click Focus in the sidebar
  2. Click an existing Focus (like Do Not Disturb), or click Add Focus… to add a new one
  3. Click Add Filter… in the Focus Filters section
  4. Select HazeOver in the app list
  5. Choose a Dimming option for this Focus:
    • Set Intensity to set a specific level with a slider
    • Turn On or Turn Off dimming
  6. Optionally turn on Set Color to use a custom color
  7. Click Add, then turn on the Focus to see it in action

To turn this Focus on automatically at set times, at a location, or while an app is open, click Add Schedule…. Use automations for events unrelated to a Focus, such as Wi-Fi changes, battery level, or sunset.

How to Use With Third-Party Tools

HazeOver works with Raycast via the HazeOver Controls extension. Install it from the Raycast Store to get instant access to these commands:

Other tools like Alfred, BetterTouchTool, and Keyboard Maestro can control HazeOver through AppleScript and wire up its properties as macro actions.

ActionShortcuts is built for running AppleScript files from the menu bar or with keyboard shortcuts, and includes sample scripts to get you started.

How to Use AppleScript

  1. Open Script Editor (in Applications > Utilities)
  2. Draw the rest of the owl
  3. Write a script based on the examples below
  4. Choose Script > Run

To explore available HazeOver properties and commands, open its scripting dictionary:

  1. Locate HazeOver in your Applications folder
  2. Drag the HazeOver app onto the Script Editor Dock icon

You’ll find available scripting properties in the HazeOver Suite > application section. To keep HazeOver at hand, choose Window > Library, click +, and choose HazeOver. Then double-click it in the list whenever you need the dictionary.

Supported Properties and Commands

tell application "HazeOver" to set enabled to not enabled

tell application "HazeOver" to set intensity to 75

tell application "HazeOver" to set color to "5EA1Ed"

tell application "HazeOver" to set duration to 0.5

tell application "HazeOver" to set multiFocus to true

tell application "HazeOver" to set multiScreen to false

tell application "HazeOver" to updateDimming

Contact me if you need help coming up with or setting up HazeOver automation.