/QuicKeepass

Efficiently autotype your password from keepass on i3 using rofi

Primary LanguagePythonMIT LicenseMIT

QuicKeepass

QuicKeepass is a tool that allows you to quickly paste password from your Keepass database using keyboard shorcuts.

Video DEMO: How to use QuicKeepass Video Install and Configure QuicKeepass
 DEMO: How to use QuicKeepass IMAGE ALT TEXT HERE

Why? Why? Why? Why security should be a trade of with usability? I actually think that we can design softwares that are secure and ergonomic. QuicKeepass for instance allows you to quickly paste any of your passwords from keepass with only two keyboard hits, QuicKeepass doesn't add attack surface to your keepass, it simply automates your keepass usage using pykeepass python wrapper. No secrets are stored outside of your keepass, your passwords are safe and your master password too.

How to use

  • Type <Alt+u> to start QuicKeepass
  • Enter your keepass Master Passwod
  • Type < Enter> to Autofill username and password
  • OR Type <Alt+Enter> to Autofill password only

Keyboard shortcuts

  • $mod+u => Start QuicKeepass
  • Enter => Autofill username and password
  • Alt+Enter => Autofill type password only

How to install

$ sudo pip3 install --upgrade quickeepass

How to start

$ quickeepass REPLACE_WITH_YOUR_KEEPASS.kdbx
$ # or
$ quickeepass REPLACE_WITH_YOUR_KEEPASS.kdbx --keyfile your.key
$ # or
$ quickeepass REPLACE_WITH_YOUR_KEEPASS.kdbx --keyfile your.key --password

How to configure

Add one of the bellow lines to your ~/.config/i3/config

i3 Basic configuration

bindsym $mod+u exec "quickeepass REPLACE_WITH_YOUR_KEEPASS.kdbx"

Rofi theme

Add the bellow arguments to change the theme.

quickeepass --rofiargs '-theme purple' test/password_only.kdbx

List of available theme like solarized here

Rofi activate fuzzy matching

Please man rofi to go deeper.

quickeepass --rofiargs '-matching fuzzy' test/password_only.kdbx

For other Window manager

This should work perfectly, just see the above commands and adapt the start command, pull requests are welcom.

Warning / Usecase

QuicKeepass is not a replacement to Keepass it only wraps Keepass to allow you to efficiently paste your passwords on Linux.

How it works?

It's barely 200 lines of code heavily commented, have a look! :)

New features?

  • Tell me what you need :)
  • if Term in title "Return" instead of "Tab" between user and password
  • Alt+l => type login only
  • wait that Alt goes up again before sending keys

By @chaignc from ChaigncHackademy and #HexpressoTeam.