v1.4.2 · November 2026

Two-factor codes,
right in your terminal.

Authenticator is a small open-source tool that generates time-based one-time passwords (RFC 6238) from an encrypted local vault. No cloud, no account, no telemetry.

# add an account from its secret key
$ authenticator add example --secret JBSWY3DPEHPK3PXP
# print the current code
$ authenticator code example
492 039   (expires in 18s)

Features

Encrypted vault

Secrets are stored locally and encrypted with a key derived from your passphrase (Argon2id + XChaCha20-Poly1305).

Standard TOTP

Works with any service that shows a QR code or secret key: SHA-1, SHA-256 and SHA-512, 6 or 8 digits.

Import & export

Import otpauth:// URIs and export an encrypted backup you can restore on another machine.

Offline by design

No network access at all. The binary is a few megabytes and has no runtime dependencies.

Usage

authenticator add <name> --secret <key>   # add an account
authenticator list                         # show saved accounts
authenticator code <name>                  # print the current code
authenticator export --out backup.vault    # encrypted backup

Changelog

1.4.2 — 3 November 2026
Fixed clock drift handling when the system time is off by more than 30 seconds.
1.4.0 — 18 September 2026
Added SHA-512 and 8-digit codes. Faster vault unlock.
1.3.1 — 2 July 2026
Export now writes an encrypted backup by default.