/tokeny

Minimal TOTP generator from your Shell

Primary LanguageGoMIT LicenseMIT

Tokeny

Tokeny is a minimal CLI TOTP (Time-Based One-Time Password) generator.

1. Installation

Tokeny is go-getable

go get github.com/zalopay-oss/tokeny

or you can manually download binary for your system from GitHub's Releases section.

2. Usage

Please consult tokeny --help for all features' usages.

NAME:
   tokeny - Another TOTP generator

USAGE:
   tokeny [global options] command [command options] [arguments...]

COMMANDS:
   setup    setup master password
   add      add new entry
   get      get OTP
   delete   delete selected entry
   list     list all entries
   help, h  Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --help, -h  show help (default: false)

Master Password

Tokeny requires a Master Password for authenticating you against the whole application.

Master Password can be set only once, on the very first time you run tokeny setup. After that, all other commands will ask for Master Password once for every 5 minutes.

In case you lost your Master Password, the only way to reset it is removing all data (including token entries), located at $HOME/.tokeny.

3. Caution

Please think twice before using Tokeny, since having token generator in your machine may make you lose the benefits of Two-Factor Authentication.