https://github.com/thimc/totp
command line TOTP (RFC6238) authenticator
https://github.com/thimc/totp
authenticator cli totp
Last synced: 8 months ago
JSON representation
command line TOTP (RFC6238) authenticator
- Host: GitHub
- URL: https://github.com/thimc/totp
- Owner: thimc
- License: mit
- Created: 2024-06-29T16:38:19.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-07-09T19:40:13.000Z (almost 2 years ago)
- Last Synced: 2025-08-16T08:40:07.782Z (10 months ago)
- Topics: authenticator, cli, totp
- Language: Go
- Homepage:
- Size: 3.91 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# totp
_DISCLAIMER: I am not a security expert so I wouldn't necessarily
recommend you to use this for your actual passwords. This project
simply exists on my github so that I can use it across many devices._
totp is a TOTP (Time-based one-time password) authenticator as
specified by RFC6238 and is made to work well with other programs,
in that way it is almost homogeneous with "pass(1) - the standard
unix password manager".
## Usage
To use totp you will either need to pipe the data to totp or specify
a file with your secrets (using the -f flag). The input should
contain two tab-separated fields:
1. The first field is an identifier for what the temporary password
will be for. This is up to the user to decide and will not affect
the outcome of the secrets. __Note that the field is truncated at 25
characters.__
2. The second (and last) field is the secret key.
I recommend keeping a GnuPG encrypted file with all the secrets on disk
and adding a alias in your shell to use totp:
totp='gpg -qd $HOME/.totp.gpg 2>/dev/null | (which totp)'
## License
MIT