https://github.com/nongiach/QuicKeepass

Efficiently autotype your password from keepass on i3 using rofi
https://github.com/nongiach/QuicKeepass

Last synced: about 2 months ago
JSON representation

Efficiently autotype your password from keepass on i3 using rofi

• Host: GitHub
• URL: https://github.com/nongiach/QuicKeepass
• Owner: nongiach
• License: mit
• Created: 2020-01-07T18:57:41.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2021-02-01T12:57:57.000Z (almost 4 years ago)
• Last Synced: 2024-08-18T14:37:58.591Z (4 months ago)
• Language: Python
• Size: 60.5 KB
• Stars: 32
• Watchers: 4
• Forks: 4
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: Changelog.md

Awesome Lists containing this project

• awesome-rofi - QuicKeepass - Efficiently autotype your password from keepass on i3 using rofi (Password Management)

README

        
# 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](https://img.youtube.com/vi/rQRBtT2XDIg/0.jpg)](https://www.youtube.com/watch?v=rQRBtT2XDIg) | [![IMAGE ALT TEXT HERE](https://img.youtube.com/vi/t26V3Y2ZoF0/0.jpg)](https://www.youtube.com/watch?v=t26V3Y2ZoF0) |

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  to start QuicKeepass

* Enter your keepass Master Passwod

* Type  < Enter>  to Autofill username and password

* **OR** Type  to Autofill password only

## Keyboard shortcuts

* $mod+u      =>      Start QuicKeepass

* Enter       =>      Autofill username and password

* Alt+Enter   =>      Autofill type password only

## How to install

```sh

$ sudo pip3 install --upgrade quickeepass

```

## How to start

```bash

$ 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](https://github.com/davatorium/rofi-themes/tree/master/Official%20Themes)

### 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][chk] and [#HexpressoTeam][hexpresso].

[chk]:  http://github.com/nongiach/ChaigncHackademy

[hexpresso]:     https://hexpresso.github.io

[@chaignc]:    https://twitter.com/chaignc