Skip to main content

A cli based TOTP app.

Project description

version on pypi licence

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 -a flag (or alternatively the add subcommand) 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 it from dmenu, or whatever your application launcher is.

To offset the clock by a number of seconds:

totp -s SECONDS SERVICE

For example:

$ totp -s +60 github
735092
$ totp -s -90 github
909651

To add a service:

totp -a SERVICE
# OR
totp add SERVICE

For example:

$ totp -a github
Token length [6]: 6
Shared key: KEY

Note that if the service already exists, it will be overwritten without warning.

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:

License

totp-cli is distrbuted under the terms of the ISC licence. See LICENCE for details.

Copyright (c) 2014-2017 Hugo Osvaldo Barrera <hugo@barrera.io>

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

totp-1.3.0.tar.gz (7.5 kB view details)

Uploaded Source

Built Distribution

totp-1.3.0-py3-none-any.whl (6.8 kB view details)

Uploaded Python 3

File details

Details for the file totp-1.3.0.tar.gz.

File metadata

  • Download URL: totp-1.3.0.tar.gz
  • Upload date:
  • Size: 7.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.6.7

File hashes

Hashes for totp-1.3.0.tar.gz
Algorithm Hash digest
SHA256 ade5afde91f535a3bbc0a02de246dfadec0a4ba465a59147e0db186f66a2e372
MD5 9007bdd1ba11139918f33549965cf69f
BLAKE2b-256 fdaca05d9dcefe55ebaeb7f35537db3fdf6d33b5f7f56237e8ee46918c9b9aa5

See more details on using hashes here.

File details

Details for the file totp-1.3.0-py3-none-any.whl.

File metadata

  • Download URL: totp-1.3.0-py3-none-any.whl
  • Upload date:
  • Size: 6.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.6.7

File hashes

Hashes for totp-1.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4cc013217d1d9662e93a9e8dd911010045ea2d68539e620577ceea5ac1ab3b81
MD5 21bc8b519c75cba990783c9e799ecbfa
BLAKE2b-256 6f23c736aed4e94365231045722dd49df0194d234aadd8d26aa211b86bc34a84

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page