README.md

totp-util

Generate TOTP 2-Factor Authentication secrets and QR codes for Google Authenticator on the command-line. (It looks nicer in a real terminal!)

$ totp-util ~jellob/.totp-key "Holiday Inn" jellob@travel.kh
/Users/jellob/.totp-key read
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░██████████████░░░░██░░░░░░██░░░░██░░░░██░░██████░░░░░░████░░██████████████░░
░░██░░░░░░░░░░██░░████░░████░░████░░██░░░░██░░░░░░░░░░░░██░░░░██░░░░░░░░░░██░░
░░██░░██████░░██░░░░██████░░░░░░░░██░░░░░░░░██░░████░░░░░░██░░██░░██████░░██░░
░░██░░██████░░██░░████░░██░░████░░░░░░░░░░██░░██░░██████░░░░░░██░░██████░░██░░
░░██░░██████░░██░░░░░░██░░████░░░░░░░░██░░████░░██░░░░██░░██░░██░░██████░░██░░
░░██░░░░░░░░░░██░░██░░██░░░░██████░░████░░░░████░░░░░░░░████░░██░░░░░░░░░░██░░
░░██████████████░░██░░██░░██░░██░░██░░██░░██░░██░░██░░██░░██░░██████████████░░
░░░░░░░░░░░░░░░░░░░░░░░░░░██░░██████░░░░██░░████░░░░░░░░░░██░░░░░░░░░░░░░░░░░░
░░██████████░░██████████░░████████░░██████░░░░██░░██████░░░░██░░██░░██░░██░░░░
░░░░██████░░░░░░░░░░██░░░░░░░░░░░░██░░██░░████████░░████░░██░░░░██░░░░░░██░░░░
░░░░██░░░░░░██████░░░░████████░░██████░░░░██████░░░░░░░░██░░░░██░░████░░████░░
░░░░░░██░░████░░░░██░░████░░░░████░░░░████████░░████░░██░░░░████░░░░░░░░████░░
░░██████████████░░████████░░████░░░░██░░██░░░░░░░░░░████░░░░████████████████░░
░░██░░░░██░░██░░░░░░░░██░░██░░░░░░██████░░██░░████░░░░██░░██░░░░██░░██████░░░░
░░██░░██░░██░░██░░░░░░██░░░░░░░░████░░██░░██████░░░░██░░██░░██░░██░░██░░████░░
░░░░░░██░░████░░░░░░████░░██░░██████░░░░██░░██████░░░░░░░░░░████░░████░░████░░
░░░░░░░░████████░░░░████░░██████░░░░██░░██░░██████░░████░░██████████░░██░░██░░
░░██░░██░░░░░░░░░░░░████░░░░██░░░░██░░░░░░██░░░░████░░░░░░░░░░░░██░░████░░░░░░
░░██████░░██░░████░░░░██████░░██████████░░██░░██░░██░░░░██░░░░░░░░░░████████░░
░░████░░██░░██░░██████░░██░░░░░░██░░░░░░██████░░░░░░░░██████████░░░░██░░░░██░░
░░░░░░██░░░░░░████░░░░░░██░░░░░░██░░██░░░░██████████████░░░░████████████░░██░░
░░░░██░░░░░░░░░░░░████░░░░████░░░░██░░░░██░░░░████░░██░░░░██░░░░██░░░░████░░░░
░░██░░██░░████████████░░░░░░██████░░████░░░░██░░░░░░░░██████████████░░██████░░
░░██░░██░░██░░░░░░░░██░░░░████░░░░░░░░░░██░░████░░██░░████░░░░████████░░░░██░░
░░██████░░██████░░████░░░░██░░████████░░██░░████░░████████░░░░██░░██████████░░
░░██░░░░░░░░░░░░██░░██░░░░░░░░░░░░██░░░░░░████░░██░░██░░░░██░░░░░░░░░░████░░░░
░░██░░░░████░░██░░░░██░░████░░░░████░░░░░░██░░██░░░░░░░░██████░░░░░░░░██████░░
░░██░░░░████░░░░██░░░░████░░░░████░░░░░░░░░░████████░░██░░░░░░░░░░░░░░░░██░░░░
░░██░░░░░░░░░░████████████░░░░░░░░████░░████░░░░░░██████████████████░░████░░░░
░░░░░░░░░░░░░░░░░░██░░░░░░██████░░██░░██░░████████░░░░░░████░░░░░░██░░░░░░░░░░
░░██████████████░░██░░██░░░░██████░░░░░░░░██████░░░░░░██░░██░░██░░████░░████░░
░░██░░░░░░░░░░██░░░░░░██░░████░░██░░░░░░░░░░██░░██░░░░░░░░██░░░░░░██░░░░██░░░░
░░██░░██████░░██░░██░░░░░░██░░████████░░██░░██████████░░████████████████░░░░░░
░░██░░██████░░██░░██░░░░░░░░░░░░░░██░░░░░░██░░░░██░░██░░░░██████████░░██████░░
░░██░░██████░░██░░██░░██████░░░░████████░░██░░░░░░██████░░██░░░░██░░░░██████░░
░░██░░░░░░░░░░██░░██░░░░██░░░░██████░░██░░░░████░░░░░░░░██████░░░░░░░░░░░░██░░
░░██████████████░░██░░████░░░░░░░░██████░░██████████████░░░░░░████░░░░██████░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
otpauth://totp/Holiday%20Inn:jellob@travel.kh?secret=NYG4KQIYJ7KOJQ7C&issuer=Holiday%20Inn

Install

npm install -g https://github.com/WIZARDISHUNGRY/totp-util

Server setup

• OpenBSD/OpenSSH

Usage

$ totp-util --help

Usage: totp-util [file] [issuer] [user@host]

Options:
  -h, --help           output usage information
  -v, --version        output version number

Examples:

  $ totp-util
  $ totp-util ~mojonixon/.totp-key
  $ totp-util ~al/.totp-key "Wax Trax"
  $ totp-util ~jellob/.totp-key "Holiday Inn" jellob@travel.kh

Additional Docs

• Configuring OpenSSH with OATH and public keys (2 factor authentication)
• Using google authenticator with OpenBSD SSH logins