pschmitt / pkp

Straightforward CLI for KeePass - powered by pykeepass
GNU General Public License v3.0
4 stars 1 forks source link

😸 pkp ⚡⚡

GitHub release (latest by date) CI

pkp (pronunciation) is a simple CLI tool to query KeePass databases from CLI.

It's built on the awesome pykeepass library.

Installation

Binary

The easiest way to start would be to check out the latest release.

NOTE: The -termux binaries are manually built on Termux with ./build.sh termux (no CI).

zinit

# KeePass
() {
  local extra_args=()

  if command -v termux-info > /dev/null
  then
    extra_args=(bpick"*termux")
  fi

  zzinit \
    $extra_args \
    as"command" \
    from"gh-r" \
    sbin"pkp* -> pkp" \
    for pschmitt/pkp
}

From pypi

# Recommended
pipx install pkp

# Boring alternative
pip3 install --user pkp

Usage

Just run pkp --help. You'll get it:

usage: pkp.py [-h] [-V] -f FILE [-p PASSWORD] [-F KEYFILE] [-I] [-r] [-C] [-D]
              {list,ls,l,get,g,entry,e,show,display,sh,ds,search,find,fd,se,f,s}
              ...

positional arguments:
  {list,ls,l,get,g,entry,e,show,display,sh,ds,search,find,fd,se,f,s}
                        sub-command help
    list (ls, l)        List entries (by path)
    get (g, entry, e)   Get entries
    show (display, sh, ds)
                        Show entry data
    search (find, fd, se, f, s)
                        Find entries

options:
  -h, --help            show this help message and exit
  -V, --version         show program's version number and exit
  -f FILE, --file FILE  KeePass DB file
  -p PASSWORD, --password PASSWORD
                        Password
  -F KEYFILE, --keyfile KEYFILE
                        Key file
  -I, --case-sensitive  Case sensitive matching
  -r, --raw             Disable REGEX path search
  -C, --no-color        Disable colored output
  -D, --debug           Debug mode