LinuxCommandLibrary

gotp

TOTP/MFA authenticator for command line

TLDR

Show current TOTP code
$ gotp show [account-name]
copy
Add new TOTP account
$ gotp add [name] [secret-key]
copy
Generate QR code for setup
$ gotp qr [account-name]
copy
List all accounts
$ gotp list
copy

SYNOPSIS

gotp [options] command

DESCRIPTION

gotp is a command-line TOTP (Time-based One-Time Password) authenticator. It stores and generates 2FA/MFA codes for accounts without requiring a phone or browser extension.
The tool encrypts stored secrets and can generate QR codes for easy mobile app setup.

PARAMETERS

show NAME

Show current TOTP code for account
add NAME SECRET
Add new TOTP account
remove NAME
Remove account
list
List all accounts
qr NAME
Generate QR code for account
export
Export accounts (encrypted)
import FILE
Import accounts from file
-c, --config FILE
Configuration file path
--clip
Copy code to clipboard
-v, --version
Display version and exit
-h, --help
Display help and exit

SECURITY

Secrets are encrypted at rest using a master password. Clipboard integration for secure code copying. No network access required after setup.

CAVEATS

System clock must be accurate for valid codes. Secrets are only as secure as the encryption password. Backup codes recommended for account recovery.

HISTORY

gotp was created for users preferring terminal-based 2FA management or needing MFA access on headless servers.

SEE ALSO

[oathtool](https://www.nongnu.org/oath-toolkit/), [keepassxc](https://keepassxc.org/), [1password-cli](https://developer.1password.com/docs/cli/)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard