|German Lashevich 38a560681a Obey clippy||2 months ago|
|.github||2 months ago|
|ci||1 year ago|
|src||2 months ago|
|.gitignore||2 years ago|
|.travis.yml||1 year ago|
|Cargo.lock||2 months ago|
|Cargo.toml||2 months ago|
|LICENSE||2 years ago|
|README.md||4 months ago|
|TODO||1 year ago|
|appveyor.yml||1 year ago|
CLI manager of time-based one-time password generators. It is a desktop alternative for Google Authenticator.
Make sure you have
$HOME/.cargo/bin in your
$ cargo install rustotpony
cargo installfrom the inside of the repo directory
Probably, you will need
gcc (Linux) or
clang (Mac OS) to compile dependencies.
$ totp help 🐴 RusTOTPony 0.2.3 German Lashevich <email@example.com> CLI manager of one-time password generators aka Google Authenticator USAGE: totp [SUBCOMMAND] FLAGS: -h, --help Prints help information -V, --version Prints version information SUBCOMMANDS: add Add a new generator dash Show realtime dashboard with all generators delete Delete generator eradicate Delete all generators help Prints this message or the help of the given subcommand(s) list List all generators rename Rename generator Try `totp help [SUBCOMMAND]` to see help for the given subcommand
At the very first run
totp asks for a password for a new database. It's located at
$HOME/.rustotpony/db.json (don't be confused by
json extension, actually, it's a binary file). If you forget the password or want to change it, you have to remove
$HOME/.rustotpony directory. It's not convenient, but I'm going to improve usablity and an option for changing password.
Retrieve a secret key from your TOTP provider (it must be encoded with base32, for example:
$ # Creating a fake secret key for demo purposes $ echo 123321555 | base32 GEZDGMZSGE2TKNIK
Add new generator with
totp add <NAME> (you will be asked for a secret and a password)
$ # Adding a new TOTP generator $ totp add demo Enter your secret code: Enter your database pass: New application created: demo
If it's not the first run, you'll be asked for password twice: for opening database and for saving it.
totp list to check your secrets
$ # Listing all secrets in the database $ totp list Enter your database pass: +------+------------------+----------+ | name | key | username | +------+------------------+----------+ | demo | GEZDGMZSGE2TKNIK | | +------+------------------+----------+
totp dash or just
totp for realtime dashboard
$ # Display real-time dashboard with all generators $ totp Enter your database pass: Welcome to RusTOTPony realtime dashboard! Press ^C to quit. [============================================= ] 009216 demo
After hitting ^C it'll cleanup the dashboard
$ totp Enter your database pass: I won't tell anyone about this 🤫
Licensed under the MIT License.