One-time passwords (TOTP)

A login item can carry an authenticator key, turning Keyguard into your two-factor code generator: the current code sits right next to the username and password it belongs to, with a countdown and a copy button, and it syncs to every device — including your watch.

Adding a key to an item

While editing a login item, set the Authenticator key in one of three ways:

  • Scan the QR code the website shows you, using the camera;
  • Load from a file — pick a screenshot or photo of the QR code;
  • Paste it — either a full otpauth:// URL or just the raw secret key.

Since adding a key edits the item, it follows the same premium rule as other vault edits — generating and copying codes is free.

Supported code types

TypeNotes
TOTPSHA-1, SHA-256, or SHA-512; 1–9 digits (default 6); custom period (default 30 s)
HOTPCounter-based variant, same algorithms
Steam Guardsteam:// secrets; the 5-character Steam code format
mOTPmotp:// secrets, with PIN support

MD5-based keys are not supported — they are rejected rather than silently producing wrong codes.

Using the codes

The item view shows the current code with a countdown timer, a preview of the upcoming code, and one-tap copy. Two settings make day-to-day use smoother:

  • Auto-copy one-time passwords — when autofill fills a login, the matching code is copied to the clipboard automatically, ready to paste into the verification field;
  • Automatically clear clipboard — wipes the code from the clipboard after a delay (see Locking & unlocking).

Storing the second factor next to the password means one vault unlock protects both. That’s a deliberate trade-off — convenience against separation of factors — and Keyguard leaves the choice to you. For your most critical accounts, consider keeping the second factor in a separate app or on a hardware key.