TOTP authenticator implement as a terminal tool
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
mina
.gitignore
LICENSE
MANIFEST.in
README.md
requirements.txt add: some basic files Feb 9, 2018
setup.py

README.md

MinaOTP-Shell

MinaOTP-Shell is a two-factor authentication tool that runs in a terminal as a command-line tool.

This command-line tool will generate secure dynamic 2FA tokens for you, the add, remove, list, show and import will be pretty convenient in the terminal.

Installation

pip install mina

Usage

  • Help information
$ mina -h
usage: mina [-h] {list,add,remove,show,import} ...

MinaOTP is a two-factor authentication tool that runs in the terminal

positional arguments:
  {list,add,remove,show,import}
                        Available commands
    list                List all tokens.
    add                 Add a new token.
    remove              Remove a token.
    show                Show a token on-time
    import              Import tokens from a local json file

optional arguments:
  -h, --help            show this help message and exit
  • List all tokens
$ mina list
=OID== =====ISSUER===== =====REMARK===== ======OTP=======
  0          test             test            904540
  1         hello            world            344962
  2          mina             otp             032218
  • Add a new token
$ mina add -h
usage: mina add [-h] --secret SECRET --issuer ISSUER --remark REMARK

optional arguments:
  -h, --help       show this help message and exit
  --secret SECRET  Secret info to generate otp object.
  --issuer ISSUER  Issuer info about new otp object.
  --remark REMARK  Remark info about new otp object.
  • Remove a token
$ mina remove -h
usage: mina remove [-h] oid

positional arguments:
  oid         oid of the token

optional arguments:
  -h, --help  show this help message and exit
  • Show a token on-time
$ mina show 2
=OID== =====ISSUER===== =====REMARK===== ======OTP=======
  2          mina             otp             983418
  • Import tokens from a local json file
$ mina import -h
usage: mina import [-h] file_path

positional arguments:
  file_path   path of the local json file

optional arguments:
  -h, --help  show this help message and exit

Todos

  • import tokens from a local json file
  • export all tokens to a local json file