Skip to main content

Passhole

https://img.shields.io/matrix/pykeepass:matrix.org.svg

passhole is a commandline password manager for KeePass inspired by pass.

https://i.imgur.com/lWLgbo3.gif

Features

  • fill user/pass field in any application via keyboard shortcut

  • add, delete, move, edit, rename entries and groups

  • generate alphanumeric, symbolic, or correct horse battery staple style passwords

  • temporarily cache database password (by default for 10 minutes)

  • multiple databases

  • supports KeePass v3 and v4 databases

  • supports TOTP

See below for examples and the manual (or man passhole) for a complete list of commands and options.

Setup

pip install passhole
ph init

# optionally install zenity for graphical password prompt
sudo apt install zenity

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: evan@evanw.org
URL: facebook.com

# add an entry to `social/` with a correct-horse-battery-staple type password
$ ph add social/twitter -w
Username: evan@evanw.org
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 Keybindings

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

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

Testing and Development

Running tests

# from repo root dir:
python test/tests.py

Isolated install in Docker

# debian
make docker_debian

Building manpage and packaging

make man
make dist

See also

Build Dependencies

Alpine

apk add gcc libffi-dev py3-lxml py3-pip python3-dev libc-dev

Release files for passhole 1.10.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for passhole 1.10.1
File Size Uploaded
passhole-1.10.1.tar.gz 65.4 kB Details

Release files / passhole-1.10.1.tar.gz

Download URL passhole-1.10.1.tar.gz
Size 65.4 kB
Tags Source
SHA-256 checksum
How to use checksums
e71f110391f40f100023475e2d78544b2faae6f1a2c4258753877d1585d171d1
BLAKE2b-256 checksum
How to use checksums
435c996e762e83b7a26f381d961a50d3f39da157877ef4e7b0b72c0e3722c843
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.8

Release history Release notifications | RSS feed

This release

1.10.1 This release

1 release file

1.10.0

1 release file

1.9.10

1 release file

1.9.9

1 release file

1.9.8

1 release file

1.9.7

1 release file

1.9.6

1 release file

1.9.5

1 release file

1.9.4

2 release files

1.9.3

1 release file

1.9.2

1 release file

1.9

1 release file

1.8.2

1 release file

1.8.0

1 release file

1.7.7

1 release file

1.7.6

1 release file

1.7.5

1 release file

1.7.4

1 release file

1.7.3

1 release file

1.7.2

1 release file

1.7

1 release file

1.6.1

1 release file

1.6.0

1 release file

1.5.5

1 release file

1.5.4

1 release file

1.5.2

1 release file

1.5.0

1 release file

1.4.3

1 release file

1.4.2

1 release file

1.4.1

1 release file

1.4.0

1 release file

1.3.5

1 release file

1.3.4

1 release file

1.3.3

1 release file

1.3.2

1 release file

1.3.1

1 release file

1.3.0

1 release file

1.2.2

1 release file

1.2.1

1 release file

1.2

1 release file

1.1

1 release file

1.0

1 release file

0.4.3

1 release file

0.4.2

1 release file

0.4.1

1 release file

0.4

1 release file

0.3

1 release file

0.2

1 release file

0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page