HazeOver Help & Productivity Tips

HazeOver runs in the background and adds a translucent dark layer behind the window you’re using. When you switch to a different window, HazeOver automatically shades the previous window. You can choose between instant switch or a smooth animation. The app is energy-efficient and does not get in your way.

You can improve your experience by allowing HazeOver to use your Mac’s Accessibility features. HazeOver will react instantly when you switch between windows and detect the focused window even more reliably.

You only need to follow these steps once, when the corresponding option shows up:

Choose “Improve Dimming Accuracy…” in the HazeOver menu or click the “Allow…” button at the bottom of the HazeOver Settings window.

When System Settings opens, turn on the HazeOver switch in the app list.

Use a trackpad gesture or mouse scroll to turn the brightness of your distractions down. Place the mouse pointer over the HazeOver menu bar icon and scroll to adjust dimming intensity. Scrolling down to the minimum will turn HazeOver off.

Toggle HazeOver dimming by double-clicking its menu bar icon. Or press ^⌥⌘H (Control-Option-Command-H) to turn HazeOver on or off. You can customize keyboard shortcuts in the Shortcuts tab of the HazeOver Settings.

HazeOver can either highlight the front window on each connected screen or dim all secondary displays (those without keyboard focus). The latter helps you easily tell which display you’re typing in. You can disable dimming completely on a specific display via the “Secondary Displays” menu.

Dimming settings can be set to change automatically when using Auto Appearance (System Settings > Appearance). For example, dimming can turn on along with Dark Mode. Or have different dimming intensity and color when using the light appearance.

Those settings will be saved and applied independently for Dark and Light appearance. See HazeOver Settings > Advanced > Dark Mode Settings.

Press the Fn (Function) key when dragging a file to temporarily turn off dimming. Clicking the desktop also turns off dimming.

When you close or minimize all windows of an app, macOS does not switch to the next app. Check the app name in the top-left corner of the screen. HazeOver dims everything because the front app has no focused window. Highlighting a window from a different app would be misleading.

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.

Check out the comprehensive HazeOver Automation Guide →