clawoflight / puma

PUMA - Password (and User) Manager

PUMA - Password (and User) MAnager

This is a very simple and effective password manager built on gnupg, the coreutils, xdotool and optionally dmenu and zenity.

I chose the name from the options given to me by this awesome acronym generator because it sounds awesome.

Concept

The concept is trivial. You simply keep a folder with some gpg-encrypted files of the form:

// $PUMA_KEYRING/shop/amazon.gpg
User: [e-mail]
Pass: Tr0ub4dor&3

Subfolders are transparently supported since v0.6.

When you want to log in somewhere, simply invoke puma or puma-menu with the required account name while having keyboard focus in the login form, and PUMA will log you in.

Install

PUMA is just shell glue combining a lot of existing programs. It has the following dependencies:

• gnupg
• pandoc (to compile the man pages)
• xdotool

Optionally, for puma-menu:

• dmenu

Optionally, for puma-add:

• zenity
• diceware for secure random password generation

To install, just type make install in the project root. The Makefile honors the PREFIX and DESTDIR environment variables for easy packaging by maintainers used to the GNU autotools.

If you are on Arch, you can find a package in the AUR.

Usage

To type out the user name, TAB, password and ENTER for an account:

$puma <account-name>
$puma -u <account-name>  # Types the user name only
$puma -p <account-name>  # Types the password only

You will probably only use puma directly in your own scripts, or if using a window manager like AwesomeWM that allows you to execute arbitrary shell commands.

puma-menu uses dmenu to provide a GUI login flow. This is the recommended way to use PUMA.

Simply invoke it with keyboard focus in a login form and select the account to which you want to be logged in.

Optionally, if $PUMA_KEYRING/autoconfig.csv exists, puma-menu will automatically log you in if it finds a matching entry using the focused window title:

// autoconfig.csv
domain (unused), window title substring, puma account name (argument to puma)
amazon.com, Amazon Sign In, shop/amazon

puma-add is a GUI dialog to simplify adding an account:

$puma-add [--random]

For more information, read the man-pages.