Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Dmenu frontend for Keepass databases

Project description

Fully featured Dmenu/Rofi frontend for managing Keepass databases.

Inspired in part by Passhole, but I wanted something more dmenu and less command line focused.

I’m very aware of pass and passmenu, but I’ve found that the Keepass options for other platforms are much easier to use, especially for the non-technically oriented. Thus…synchronized passwords and everyone is happy!


  • NOTE Only support .kdbx databases, not .kdb
  • Auto-type username and/or password on selection. No clipboard copy/paste involved.
  • Use a custom Keepass 2.x style auto-type sequence if you have one defined (except for character repetition and the ‘special commands’). Set it per entry or set a default in the config file for all entries. Disable autotype for an entry, if desired. These require a pykeepass version later than 2018/11/06 or > 3.0.2
  • Select any single field and have it typed into the active window. Notes fields can be viewed line-by-line from within dmenu and the selected line will be typed when selected.
  • Open the URL in the default web browser from the View/Type menu.
  • Alternate keyboard languages and layouts supported via xdotool.
  • Edit entry title, username, URL and password (manually typed or auto-generate)
  • Edit notes using terminal or gui editor (set in config.ini, or uses $EDITOR)
  • Add and Delete entries
  • Rename, move, delete and add groups
  • Prompts for and saves initial database and keyfile locations if config file isn’t setup before first run.
  • Set multiple databases and keyfiles in the config file.
  • Hide selected groups from the default and ‘View/Type Individual entries’ views.
  • Keepmenu runs in the background after initial startup and will retain the entered passphrase for pw_cache_period_min minutes after the last activity.
  • Optional Pinentry support for secure passphrase entry.


  • GPLv3


  1. Python 2.7+ or 3.2+
  2. Pykeepass and PyUserInput. Install via pip or your distribution’s package manager, if available.
  3. Dmenu. Basic support is included for Rofi, but most Rofi configuration/theming should be done via Xresources.
  4. (optional) Pinentry. Make sure to set which flavor of pinentry command to use in the config file.
  5. (optional) xdotool. If you have a lot of Unicode characters or use a non-U.S. English keyboard layout, xdotool is necessary to handle typing those characters.


  • Installation

    • pip install –user keepmenu. Add ~/.local/bin to $PATH

    • In a virtualenv with pip. Link to the executable in <path/to/virtualenv/bin/keepmenu>

      mkvirtualenv keepmenu
      pip install keepmenu
    • From git. Just clone, install requirements and run

    • Available in Archlinux AUR.

  • If you start keepmenu for the first time without a config file, it will prompt you for database and keyfile locations and save them in a default config file.

  • Copy config.ini.example to ~/.config/keepmenu/config.ini, or use it as a reference for additional options.

    • Add your database(s) and keyfile(s)
    • To use a command (e.g. gpg) to lookup db password, set password_cmd_<n> in config.ini.
    • Adjust pw_cache_period_min if desired. Default is 6 hours (360 min).
    • Set the dmenu_command to rofi if you are using that instead
    • Adjust the autotype_default, if desired. Allowed codes are the Keepass 2.x codes except for repetitions and most command codes. {DELAY x} (in milliseconds) is supported. Individual autotype sequences can be edited or disabled inside Keepmenu.
    • Set type_library = xdotool if you need support for non-U.S. English keyboard layouts and/or characters.
      • When using xdotool, call setxkbmap to set your keyboard type somewhere in your window manager or desktop environment initialization. For example: exec setxkbmap de in ~/.config/i3/config.
  • If using Rofi, you can try some of the command line options in config.ini or set them using the dmenu_command setting, but I haven’t tested most of them so I’d suggest configuring via .Xresources where possible.

  • Number of lines needs to be configured in the config.ini and not in .Xresources or the Rofi config file. Keepmenu will override any number of lines settings set elsewhere.

  • If using dmenu for passphrase entry (pinentry not set), dmenu options in the [dmenu_passphrase] section of config.ini will override those in [dmenu] so you can, for example, set the normal foreground and background colors to be the same to obscure the passphrase.


If you choose to store your database password into config.ini, make sure to chmod 600 config.ini. This is not secure and I only added it as a convenience for testing.


  • Run script or bind to keystroke combination
  • Enter database and keyfile if not entered into config.ini already.
  • Start typing to match entries.
  • Hit Enter immediately after dmenu opens (“View/Type individual entries”) to switch modes to view and/or type the individual fields for the entry. If selected, the URL will open in the default browser instead of being typed.
  • To view a password without typing it, use the ‘Edit Entries’ option, then select the entry, select ‘Password’ then select ‘Manually enter password’. Type ‘ESC’ to exit without making changes.


  • To run tests: python tests/

Project details

Download files

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

Files for keepmenu, version 0.5.8
Filename, size File type Python version Upload date Hashes
Filename, size keepmenu-0.5.8-py2.py3-none-any.whl (46.5 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size keepmenu-0.5.8.tar.gz (31.7 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page