Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

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
Release History

Release History

This version
History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
gacli-1.0.3.tar.gz (5.3 kB) Copy SHA256 Checksum SHA256 Source Jan 16, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting