Getting started

What is BlurBox?

BlurBox is a tiny macOS app that lets you place soft, draggable blur overlays on top of your screen. Use them to cover sensitive information — emails, license keys, customer data, financial figures — while you record tutorials, stream, screen-share, or take screenshots.

Once a BlurBox is glued to a window, it follows that window automatically as you move or resize it. No manual repositioning, no fiddling.

1. Install

1. Download the DMGOpen the BlurBox installer you downloaded.
2. Drag BlurBox into ApplicationsThe installer window has the BlurBox icon on the left and an Applications shortcut on the right. Drag the icon onto Applications.
3. Eject the installerDrag the BlurBox installer disk to the Trash, or right-click it in Finder and choose Eject.

2. First launch

1. Open BlurBox from ApplicationsDouble-click BlurBox.app in your Applications folder.
2. Look for the icon in your menu barBlurBox lives in the menu bar at the top of your screen, not the Dock. The icon looks like a small frosted square. Click it to open the menu.

3. Grant Accessibility permission

BlurBox needs permission to read window positions so it can keep overlays attached to the windows you choose. It does not see what's inside any window — only positions and sizes.

1. Open System SettingsThe first time you create a BlurBox and try to glue it, macOS prompts you. Click Open System Settings. You can also open it manually: Apple menu → System Settings.
2. Go to Privacy & Security → AccessibilityYou'll see a list of apps that have requested accessibility access.
3. Toggle BlurBox onIf BlurBox isn't in the list, click the + button and add it from your Applications folder. Then flip its switch to the on position.

4. Create your first BlurBox

You can create an overlay three ways. Try the first one now:

1. Click the menu bar icon and choose “New BlurBox”A blur overlay appears in the lower-left of your screen.
2. Drag it where you wantClick and drag the overlay onto the area you want to hide.
3. Resize itHover near any edge — the cursor changes to a resize cursor. Drag to make the overlay larger or smaller.

5. Glue it to a window

A free-floating overlay sits at a fixed position on your screen. To make it follow a specific window, glue it to that window:

1. Position the overlay over the area you want to hideFor example, place it over an email address inside Mail.
2. Right-click the overlayA context menu appears.
3. Choose “Glue to Window Underneath”The overlay locks in place and now follows the window when you drag, resize, or rearrange it.

What's next?

You've got the basics. Here's where to go from here:

• Keyboard shortcuts — make BlurBox feel native with the global hotkeys.
• FAQ — answers to common questions about privacy, multi-monitor setups, and what shows up in screen recordings.
• Send feedback— tell us what's working, what isn't, and what you'd like to see.