auth-cmd 0.2

A 2FA/TOTP authentication tool

A secure and privacy-focused command-line tool for two-factor authentication (2FA) and Time-based One-Time Passwords (TOTP).

[!IMPORTANT]
To ensure the safety of your authentication data, please use auth-cmd only on a secure, private computer.

Installation

Install zbar

• Ubuntu

  sudo apt update && sudo apt install -y libzbar-dev

• MacOS

  brew install zbar

• If auth-cmd cannot locate the zbar library after installation, try creating a symbolic link for the zbar shared library:
• reference

  mkdir ~/lib
  ln -s $(brew --prefix zbar)/lib/libzbar.dylib ~/lib/libzbar.dylib

• Windows
  • Download the installer from the zbar homepage and follow the instructions provided.

Install Package

pip install auth-cmd

Usage

This tool provides several commands to manage TOTP tokens.

Add a Token

To add a new token by a QRcode

auth add-qr

If you know the secret of a TOTP. You can add a new token by

auth add

Generate a TOTP

To generate a TOTP for a specific token:

auth gen <name>

The generated TOTP will be copied to your clipboard.

Want Faster? Create an alias to speed up the process!

alias gen='auth gen'
# or
alias g='auth gen'

List Tokens

To list all existing tokens:

auth list

Remove a Token

To remove a specific token:

auth remove <name>

License

This project is licensed under the MIT License. See the LICENSE file for details.

Author

Ken Lin ([e-mail])