passhole 1.5.0

CLI KeePass client with dmenu support

passhole is a CLI interface for KeePass 1.x (v3) and 2.x (v4) databases with support for dmenu inspired by pass.

Features

With passhole, you can:

• add existing passwords

• generate new passwords

• autofill selected forms via keyboard shortcut (using the type command)

• generate correct horse battery staple style passwords

passhole makes use of gpg-agent to securely cache your database password for a few minutes.

See below for examples and the manual for a complete list of commands and options.

Setup

pip install passhole
ph init

Example Usage

# add a new entry with manually created password
>>> ph add github
Username: Evidlo
Password:
Confirm:
URL: github.com

# add an entry with a generated alphanumeric password
>>> ph add neopets -a
Username: Evidlo
URL: neopets.com

# add a new group
>>> ph add social/

# add an entry to `social/` with a 32 character password (alphanumeric + symbols)
>>> ph add social/facebook -s 32
Username: [e-mail]
URL: facebook.com

# add an entry to `social/` with a correct-horse-battery-staple type password
>>> ph add social/twitter -w
Username: [e-mail]
URL: twitter.com

# list all entries
>>> ph list
github
neopets
[social]
├── facebook
└── twitter

# display contents of entry
>>> ph show social/twitter
Title: twitter
Username: Evidlo
Password: inns.ambien.travelling.throw.force
URL: twitter.com

# retrieve contents of specific field for use in scripts
>>> ph show social/twitter --field password
inns.ambien.travelling.throw.force

Example i3wm config for filling forms.

# select entry using dmenu, then send password to keyboard
bindsym $mod+p exec ph type dmenu
# select entry using dmenu, then send username + password to keyboard
bindsym $mod+Shift+p exec ph type dmenu --tabbed