Skip to main content

Google Authentication command line tools

Project description


gacli was created for used with google-authenticator. Thankfully, TOTP is an open standard so gacli may have additional applications.

The ga command line utility provides convenient access to TOTP verification codes:

usage: ga [-h] [-d] [-f FILE]

Copy newline terminated TOTP verification code to Mac OS X clipboard.

optional arguments:
  -h, --help            show this help message and exit
  -d, --debug           print debug information
  -f FILE, --file FILE  Secret file

The debug option continually prints verification codes instead of copying a
single code to the clipboard.


This application assumes you have secured your local computer disk or filesystem encryption. gacli is only safe with encryption:


Choose either of the following installation methods:

  1. Simple Global
  2. VirtualEnv and User Bin (recommended)

Simple Global

  1. Please consider, again, using the VirtualEnv and User Bin method

  2. Install the pip python module, if you have not already done so.

  3. Install the gacli python module:

    sudo pip install gacli

VirtualEnv and User Bin

This installation method has the following requirements:


  1. Create a new gacli virtualenv and install the gacli python module:

    mkvirtualenv -i gacli gacli
  2. Symlink ga to home bin:

    ln -s $(which ga) ~/bin/


  1. See Security

  2. Copy the secret key from the first line of your .google_authenticator and put in ~/.ga

  3. Change permissions:

    chmod 0400 ~/.ga

GnuPG Protection

  1. Encrypt secret file:

    cat ~/.ga | gpg -aes -r EMAIL > .ga.gpg
  2. Delete unencrypted secret file:

    rm ~/.ga
  3. Add an alias to your .bashrc:

    alias gad='gpg -qd ~/.ga.gpg | ga -f -'


  • Linux or Mac OS X
    • Linux utilizes xclip or xsel.
    • Mac OS X utilizes pbcopy
  • onetimepass

Project details

Download files

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

Files for gacli, version 1.0.3
Filename, size File type Python version Upload date Hashes
Filename, size gacli-1.0.3.tar.gz (5.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page