Feature · QR code unlock

The app blocker you unlock with a QR code.

Curbox is a free Android app blocker where the key to a blocked app can be a QR code or barcode in another room. To unlock Instagram, TikTok or YouTube, you have to get up, walk to the code and scan it. Most urges do not survive the walk.

How does a QR code unlock work in an app blocker?

When you open a blocked app, Curbox shows a pause screen instead. With the QR or Barcode Scan challenge turned on, the pause screen opens your camera and waits. Scan the code you registered and the proceed button appears. Scan anything else and nothing happens.

That sounds like a small step, but it changes the shape of the decision. Tapping a button takes half a second and happens on autopilot. Standing up and walking to the kitchen takes thirty seconds and happens on purpose. You will still unlock sometimes, and that is fine. The point is that you decided to.

You do not need to print anything. Curbox lets you register a code that already exists: the barcode on a box of tea, the QR code on a parcel, the ISBN on the back of a book. If your phone camera can read it, it can be your key.

Where should you put the code?

The code works best somewhere you have to move to, but not somewhere so awkward that you give up on the whole system. Think about where you usually scroll, then pick a spot that is a short, boring walk away.

you scroll here

Bedroom

Bad spot for the code. If it is on your bedside table, the scan becomes part of the habit.

good

Kitchen

Taped inside a cupboard door. Close enough that you will use it, far enough to break the loop.

great at night

Hallway

On the back of the front door. Getting out of bed in the dark to scroll is a hard sell.

depends

Desk / living room

Fine for daytime limits if you scroll in bed at night. Useless if this is where you scroll.

strongest

Car or office

For apps you only want on certain days. Leave the code where you are not.

Striped rooms are good places for the code. The shaded room is where you usually scroll.

A few placements that people find work well:

What does a scan give you?

A scan is not all-or-nothing. You decide in advance what it unlocks.

You scan the code
A preset amountThe code always grants the same time, for example 10 minutes. Good when you know your own limits and do not want to bargain with yourself.
An amount you chooseYou pick how long at the moment you scan. Good for apps you sometimes need for real, like a marketplace or a group chat inside a social app.

When the time runs out, the block comes back and so does the walk. That is what makes the QR challenge different from a timer you can snooze: every extra session costs the same effort as the first.

How to set up QR code unlock in Curbox

This takes about two minutes once Curbox is installed and set up. If you do not have it yet, get it from the downloads page.

  1. Open Reducers → Apps and tap + to create a group, or open an existing one. The same setting exists on the Short-Form Video Content reducer if you want to lock Reels and Shorts instead of whole apps.
  2. Name the group, tap Select Apps and choose the apps you want behind the code.
  3. Choose a blocking mode. On Each Open asks for the code every time. Usage Based asks only after your daily limit. Time Based asks outside the hours you allow.
  4. Tap Configure Warning Screen, set the Unlock Challenge to Require effort to unlock and pick QR or Barcode Scan.
  5. Scan the code you want to use as your key, choose whether it grants a preset time or lets you pick, and save.
  6. Put the code in its new home. Then try opening the app once, so you know the whole loop works before you need it.

The full list of options is in the unlock challenges guide.

Make the QR challenge harder to dodge

The walk is the main defence, but you can stack other settings on the same warning screen.

Delay timerA countdown before the scanner even appears. The screen brightens and the phone vibrates while you wait. Ten seconds is often enough to put the phone down.
Proceed limitsCap how many times you can get through in a time window. Scan three times today and the proceed button stops appearing, code or no code.
Custom messageShow yourself a line you wrote on a better day, such as "You said you would read tonight." It appears before the scanner.
Link to Focus ModeRequire a certain amount of focus time today before any unlock is possible, so the code only works after you have done the thing you meant to do.
Anti-uninstallIn the F-Droid variant, uninstall protection makes it harder to delete Curbox in a weak moment. The Playstore variant does not include it. See how uninstall protection works.

Why physical distance works better than willpower

Most phone habits run on very short loops: an itch of boredom, a thumb movement, a reward. A button on the pause screen, even one behind a countdown, is still part of that loop. Your thumb is already there.

A QR code in another room breaks the loop in a way your thumb cannot solve. You have to stand up, which brings your attention back to the room you are in. By the time you reach the kitchen you are often thinking about something else, and the craving has had time to fade. If it has not, you scan, you get your ten minutes, and nobody needs to feel guilty about it.

If a physical key appeals to you but you would rather tap than scan, an NFC tag does the same job with a sticker. If you would rather think than walk, try math to unlock.

Questions about QR code unlock

Can I use a QR code to unlock blocked apps on Android?

Yes. In Curbox, set the unlock challenge for an App Pause or Short-Form Video group to Require effort to unlock, then pick QR or Barcode Scan. The proceed button only appears after you scan the code you registered.

Do I need to print a special QR code?

No. You can register a code that already exists, such as the barcode on a cereal box, a book, or a product package. Any code you can scan reliably will do.

What happens if I lose the code?

Treat the code like a key. Before you rely on it, take a photo of it and store the photo somewhere you cannot reach in a moment of impulse, or register a code from an item you are unlikely to throw away, such as a book on your shelf.

Can a QR scan give me a set amount of scrolling time?

Yes. A QR code can grant a preset amount of time, for example 10 minutes, or let you choose the amount at the moment you scan.

Can I just scan a photo of the code on my laptop?

If you keep a photo of the code within reach, you can. That defeats the point, so keep any backup photo somewhere inconvenient. The friction comes from the distance between you and the code.

Is the QR unlock free?

Yes. Curbox is free and open source under GPL v3, and every unlock challenge, including QR and barcode scanning, is available without a subscription.

Related