totp-cli

A CLI tool to generate Time-Based One Time Passwords (TOTP)


Keywords
totp, otp, 2fa, cli, tools, two, factor, authentication, google, authenticator
License
MIT
Install
pip install totp-cli==1.0

Documentation

totp-cli

A simple utility to help store secrets in keyring and generate TOTPs based on those secrets. Read here

Basically does what the Google Authenticator app does on the phone. Except you look much cooler and also helpful when you don't have your phone.

asciicast

Installation

pip3 install totp-cli

Usage

Get secrets from 2FA settings page of the website that you're trying to add.

Choose any of these options

$ totp [add, show, get, help]

and then follow instructions.

Security

All the secrets are stored in system keyring so they remain safe. Information like name, issuer and email are stored in plaintext locally. Name is used for look up in the keyring. Email and Issuer are only there to help you distinguish.

Notes

Tested with facebook & bitbucket. Tested only on MacOS. Should work on other platforms too..