keepass-dmenu

A dmenu-compatible interface for KeePass databases on Linux.

Installation

You can edit the dmenu command (default: rofi -dmenu) by changing the dmenu variable in keepass-dmenu before installation.

git clone https://github.com/SapuSeven/keepass-dmenu.git
cd keepass-dmenu
python -m pip install .

Configuration

The script is looking for a configuration file under $XDG_CONFIG_HOME/keepass-dmenu.conf, falling back to $HOME/.config/keepass-dmenu.conf if XDG_CONFIG_HOME is not set.

The file follows the INI file format.

Example

keepass-dmenu.conf.example contains a template for the configuration file.

[config]
database=PATH_TO_DATABASE
password=PLAINTEXT_PASSWORD
keyfile=PATH_TO_KEYFILE

Note: If you don't want to store the plaintext password, you currently need to rely on a keyfile stored at a secure location.

Usage

Note: You need to add the Python site-package script directory (default: ~/.local/bin) to your PATH variable.

Simply execute keepass-dmenu to show the dmenu dialog.

Usage (KeePass interface)

list: Simply returns all entries line-by-line with their full path.

info: Used to get details for a single entry. Requires additional arguments in the following format: info <path> [user|pass|otp|custom] [customFieldName]

Example

$ keepass-dmenu.py list

Group 1/Entry 1
Group 1/Entry 2
Group 1/Entry 3
Group 2/Entry 1

$ keepass-dmenu.py info "Group 1/Entry 1"

Entry: "Group 1/Entry 1 (username)"

$ keepass-dmenu.py info "Group 1/Entry 1" user

username

$ keepass-dmenu.py info "Group 1/Entry 1" otp

$ keepass-dmenu.py info "Group 1/Entry 1" custom field1

value1