Skip to content

kdbxviewer

command-line tool written in C for viewing KeePass2 Database files (kdbx)

Screenshot of the ncurses GUI

Features:

  • ncurses GUI to browse and view password database
  • Dump raw, decrypted XML content with obscured passwords
  • Display tree structure with de-obscured (=readable) passwords
  • Get tab-separated (TSV/CSV) password list

Installation

Arch Linux package

There is an Arch Linux AUR package: kdbxviewer-git. You can install it by either

  • using an AUR package manager, e.g. Yaourt: yaourt -S kdbxviewer-git
  • building the package, following the instructions on installing AUR packages in the Arch wiki.

Build from source

  1. To install, either clone the git repository or download the most recent ZIP snapshot.
  2. Get the required libraries via your OS's package manager: ncurses, gcrypt, zlib, expat, libstfl.
  3. Run make. After that, ./kdbxviewer -h gives the usage notes:

Usage

$ ./kdbxviewer -h
KDBX Viewer 0.0.1
dumps KeePass2 Database files in various formats

  ./kdbxviewer [-v] [-x|-t|-b|-i] [-p PASSPHRASE] [-K KEYFILE] [-s|-S SEARCH] FILENAME
 Commands:
   -x       XML dump
   -t       Tree
   -c       CSV format
   -i       interactive

 Options:
   -p PASSPHRASE
            decrypt file using PASSPHRASE
            WARNING: never use this on shared computers as the
            passphrase will be visible in the process list.
   -K KEYFILE
            use specified key file as part of the database key
   -s STR   show entries with title containing STR
   -S STR   show entries containing STR in any field value

Note - This tool is called kdbx-viewer for a reason... it works completely read-only at the moment, although write support might be added later on.

Documentation