You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
rustotpony/README.md

1.8 KiB

🐴 RusTOTPony

Build Status Build status

CLI manager of one-time password generators aka Google Authenticator. Actually, it's simple in-file database which stores TOTP secret keys without any encryption (will be added in the future).

Installation

From source

  1. Clone this repo
  2. Run cargo install from the inside of the repo directory
  3. Keep calm and wait for compilation

Probably, you need gcc (Linux) or clang (Mac OS) to compile dependencies.

Usage

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

Steps:

  1. Retrieve your secret key from TOTP provider (it must be base32 encoded)
  2. Add new generator with totp add GENNAME (you will be asked for your secret)
  3. Check new generator by totp list or just display dashboard with one-time passwords with totp dash

TODO

  • command completion
  • database password caching
  • tests
  • binaries for main platforms
  • refactor show and show-all commands

License

Licensed under the MIT License.