A cli based TOTP app.
Project description
totp-cli is a simple command line application to generate OTP tokens for two factor authentication using RFC6238.
These are compatible with many popular services such as Facebook, GitHub, Google, eve-online, battle.net, etc.
totp-cli fetches your shared key (aka: code) from pass, generates the token, outputs it to stdout and copies it to your CLIPBOARD X selection. Default X selection can be overridden with the PASSWORD_STORE_X_SELECTION environment variable.
Shared keys should be stored in your pass storage under 2fa/SERVICE/code, for example 2fa/github/code. The add command can be used to add this less painfully
Usage
Usage:
totp SERVICE
For example:
$ totp github 621787
You don’t need to run totp from the command line if you just want to paste the code; you can run if from dmenu, or whatever your application launcher is.
About pass entries
Pass entries are expected to have the TOTP secret in their first line (as provided by the third party). The amount of digits token must have (for example, battle.net uses 8), must be provided in a separate line, with a format like:
Digits: 8
For the moment, only customizing the token length is possible.
Requirements
There are also some platform-specific requirements for copying code into the clipboard:
xclip for Xorg (Linux/BSD).
Installation
Installation is quite simple:
$ pip install totp
There is also an AUR package available for ArchLinux users.
You can also configure shell completion for totp-cli:
Bash
Download totp-cli-completion.bash and source it from your bash configuration file (e.g. .bash_profile)
Zsh
Downlaod totp-cli-completion.zsh as _totp to site-functions directory (e.g. /usr/local/share/zsh/site-functions)
License
totp-cli is distrbuted under the terms of the ISC license. See LICENSE for details.
Copyright (c) 2014-2017 Hugo Osvaldo Barrera <hugo@barrera.io>
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
