← Back to docs
🔑
Features

Password lock — deep dive

Last verified: May 2026

What it does

Password lock asks for a password every time you try to disable the block. The hash lives in your macOS Keychain under a per-block account name — never in plain text, never in the block JSON, never on FocusDragon's servers.

When to use it

  • You want friction without a hard time commitment.
  • You share the Mac with a trusted person who can hold the password (a partner, a study buddy).
  • You're comfortable choosing a password that's annoying enough to type that you won't disable casually.

How to configure

  • Set Lock Type to Password in the block editor.
  • Enter a password. There are no complexity rules — pick what works for you.
  • Save. The hash is written to Keychain at this moment; the password never appears in the block file.

Weak vs strong passwords

A short, common password is functionally a speed bump — you'll type it without thinking. A long, awkward password (a full sentence with punctuation) actually creates the pause that breaks the impulse. The right strength is whatever you wouldn't type on autopilot.

There is no password recovery. By design. If you forget it, the only path is to wait out any other lock (Timer, Date, Schedule) layered on the block, or to uninstall FocusDragon — which itself is gated by the daemon while a block is active. Write the password somewhere safe BEFORE you save the block.

Common misconfig

  • Reusing your Mac login password — muscle memory blasts through the friction.
  • Letting your password manager autofill it — defeats the entire mechanism. Disable autofill for FocusDragon.
  • Picking something so hard you lock yourself out indefinitely. Strong, but recoverable from your own notes.
Still stuck? Contact support