Google Authenticator in the Shell
Shell
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
COPYING
README.md
ga

README.md

ga: Google Authenticator in the Shell

Generate two factor authentication codes that are compatible with Google Authenticator (a.k.a. RFC6238 TOTP) from the shell.

References

RFC6238

Installing

Just download and install ga somewhere on your path (e.g., $HOME/bin/ga).

Requirements:

  • gnupg

Optional dependencies:

  • xclip - to send login codes to the X clipboard instead of stdout
  • zbar - to parse QR codes from screen with -c option
  • qrencode, imagemagick - to display QR codes with -v option

Using

  • ga [-x] service - get token for service
  • ga -[x]c service - record seed for new service
  • ga -[x]v service - view qrcode for service
  • ga -l - list services setup

The -x, -xc, and -xv flags disable use of X11 even when $DISPLAY is set, compared to no option, -c, and -v.

OS X and GPG Tools

Mac OS X users may be using the GPG Tools distribution. For some strange reason, this package doesn't detect when you are running in a terminal session without a display (e.g., SSH), so by default, it always launches a GUI for key entry. Which makes ga impossible to use over SSH on OS X.

To fix this, you'll want to tell it to uses a curses display for passpharse entry:

export PINENTRY_USER_DATA="USE_CURSES=1"

A good way to decide when to export this variable is by detecting it SSH_CONNECTION is a non-empty string.

Get involved!

We are happy to receive bug reports, fixes, documentation enhancements, and other improvements.

Please report bugs via the github issue tracker.

Master git repository:

  • git clone git://github.com/scslab/ga.git

Authors

David Mazières.