Skip to content

Latest commit

 

History

History
42 lines (30 loc) · 1.59 KB

README.md

File metadata and controls

42 lines (30 loc) · 1.59 KB

TOTP-CLI

Minimalist TUI application that displays TOTP.

Note

This is not cross-platform, only tested on Linux and might work on other Unix-like systems, but never tested.

Key-bindings

  • k to move up.
  • j to move down.
  • q to quit the application.
  • Enter to copy the TOTP from the current line to the clipboard.

Configuration file

It uses the URI string format, the same format used by Google authenticator and many other OTP applications.

Example of configuration.

// This is a comment
Otpauth://totp/MyKeyName:[email protected]?secret=GZMWV5JLOMNI2XJL&issuer=AcmeCorp
Otpauth://totp/MyKeyName:[email protected]?secret=JXQWZ4TVRNUP5YKM&issuer=WidgetCo
Otpauth://totp/MyKeyName:[email protected]?secret=KBYXA6USSPQ7ZLNN&issuer=FoobarInc
Otpauth://totp/MyKeyName:[email protected]?secret=LCZYB7VTTSR8AMOO&issuer=GlobexCorp
Otpauth://totp/MyKeyName:[email protected]?secret=MDAZC8WUUTS9BNPP&issuer=BigCorp

// This is another comment
Otpauth://totp/MyKeyName:[email protected]?secret=NEBAD9XVVUT0COQQ&issuer=SmallFirm
Otpauth://totp/MyKeyName:[email protected]?secret=OFCAE0YWWVU1DPRR&issuer=MegaCorp
Otpauth://totp/MyKeyName:[email protected]?secret=PGDBF1ZXWXU2EQSS&issuer=TechCo
Otpauth://totp/MyKeyName:[email protected]?secret=QHECK2AYXYU3FRTT&issuer=StartupInc
Otpauth://totp/MyKeyName:[email protected]?secret=RIFDL3BZYZU4GSUU&issuer=ConsultingFirm

By default the secrets file should be located at $HOME/.config/totp-cli/totp.txt the name of the file can be switched out parsing in another filename, this is useful if multiple setups are needed.

totp-cli "my_other_totp_secrets_file.txt"