markembling / totp-tool

A tiny python tool for providing TOTP (and HOTP) one-time tokens when given a secret.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

TOTP Tool
=========

This is a tiny python tool for providing HOTP/TOTP one-time tokens.

The secret token must be provided to the tool as an argument or on stdin, and 
may be either the raw secret or an otpauth:// URI.

    totp.py [options] SECRET
    OR
    totp.py [options] --stdin < secret.txt

If the secret is provided via stdin, it MUST be the first line in the file.
Whitespace will be stripped from the beginning and end.

The script also takes several other arguments. Full details can be seen by 
running with the help option:

    totp.py --help

Dependencies
------------

This script uses the following excellent libraries:

    - tadeck/onetimepass <https://github.com/tadeck/onetimepass>
    - six <https://pypi.python.org/pypi/six>

These are packaged within the 'dist' directory so that the entire thing can 
be placed on a USB stick (if your secrets are there too, best encrypt it!) or 
similar and used on any python-equipped machine.

The script should work under modern Python 2.x and 3.x versions. It has 
been tested on 2.7 and 3.3.

About

A tiny python tool for providing TOTP (and HOTP) one-time tokens when given a secret.

License:BSD 3-Clause "New" or "Revised" License


Languages

Language:Python 100.0%