Lost my BlurBoxes after restarting
When persisted state goes missing — and how to recover.
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:
- Quit BlurBoxClick the menu bar icon and choose Quit BlurBox.
- Open TerminalApplications → Utilities → Terminal.
- Run this command
defaults delete com.blurbox.BlurBox
This wipes every saved overlay and preference. There's no undo. - Reopen BlurBoxYou'll start with no overlays and default preferences.
BlurBoxif you can — it'll help us trace the issue.