BlurBox
Help · Troubleshooting

Lost my BlurBoxes after restarting

When persisted state goes missing — and how to recover.

Last updated: April 2026

What should happen

When you create or modify a BlurBox, the app saves the state to disk almost immediately. After a quit-and-reopen, every overlay should reappear at the same position, with the same size and style, and re-glue itself to its target window automatically (if the target app is still running).

If they didn't come back

1. The target app isn't running

A glued BlurBox needs its target window to exist. If the underlying app is closed, BlurBox doesn't recreate the overlay. Reopen the target app first, then BlurBox should restore the overlay on its next tick (within a second).

2. The target window has a different identity now

Some apps create new window IDs on every launch. After a system reboot, the old IDs are gone forever, and BlurBox can't match the saved overlay to the new window. The overlay falls back to its last known on-screen position (free-floating, no longer glued). Just unglue and re-glue to the new window.

3. macOS killed BlurBox before it could save

If you force-quit BlurBox (or macOS shut it down during system shutdown), the most recent state changes might not have hit disk. We've hardened the persistence layer in recent versions — saves now happen synchronously after every state change — but in older versions or unusual conditions, this can still happen.

4. macOS sandbox or preferences corruption

Very rare, but if your UserDefaults for com.blurbox.BlurBoxgot corrupted, BlurBox starts fresh on next launch. There's no fix for the lost data, but the app will work normally going forward.

Reset BlurBox to a clean state

If the app feels stuck and you'd rather start over, here's the nuclear reset:

  1. Quit BlurBoxClick the menu bar icon and choose Quit BlurBox.
  2. Open TerminalApplications → Utilities → Terminal.
  3. Run this command
    defaults delete com.blurbox.BlurBox
    This wipes every saved overlay and preference. There's no undo.
  4. Reopen BlurBoxYou'll start with no overlays and default preferences.
If this keeps happeningIt's a real bug, not user error. Please tell us with a description of what you did before quitting, your macOS version, and the BlurBox version. Include a Console.app log filtered to BlurBoxif you can — it'll help us trace the issue.
Browse the Help Center
Getting startedHow-to guidesTroubleshootingKeyboard shortcutsFAQSystem requirementsContact & feedbackAll help articles
HelpPrivacyTermsHome