Skip to content

Python interface to KeePass file format v3 (used in KeePass V1.x and KeePassX)

License

Notifications You must be signed in to change notification settings

Friz-zy/python-keepass

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

49 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

keepassc and python-keepass

This provides command line and Python (both 2 and 3) interfaces for operating on files in KeePass format v3 (used by KeePass 1.x, and KeePassX). Note, this is not the format used by the KeePass application version 2.x.

Notes of caution

Before using this code, understand the its (known) security and correctness limitations:

  • Unlike the KeePass/KeePassX GUI applications this code makes no attempt to secure its memory. Input files read in are stored in memory fully decrypted.

  • It is quite easy to display the stored passwords in plain text, although the defaults try to avoid this.

  • Specifying the master key on the command line will leave traces in your shells history and in the process list.

  • While input files are treated as read-only, keep backups of any files written by KeePass/KeePassX until you are assured that files written by this code are usable.

  • Key files are not currently supported.

Prerequisites and Installation

You will need to install the python-crypto package (providing the "Crypto" module). On a well behaved system do:

sudo apt-get install python-crypto

If installing into a virtualenv this prerequisite will be installed for you:

virtualenv /path/to/venv
source /path/to/venv/bin/activate
cd python-keepass
python setup.py install

Command line

The command line interface is run like:

keepassc [general_options] [command command_options] ...

Multiple commands can be specified and will be executed in order. They operate on an in-memory instance of the database file. An example,

keepass open -m secret file.kdb \
        dump -p -f '%(username)s password is: %(password)s' \
        save -m newsecret backup.kdb

Online help:

keepass -h      # short usage
keepass help    # full usage

Python Modules

Low level file access

from keepass import kpdb
db = kpdb.Database(filename,masterkey)
print db   # warning: displayed passwords in plaintext!

References and Credits

PyCrypto help

The giants on whose shoulders this works stands

First, thanks to the original authors, contributors and community behind KeePass and KeePassX. I am merely a user of KeePassX.

A big credit is due to rudi & shirou (same hacker?) for the following:

Looking through KeePass/KeePassX source made my head swim. Only after reviewing their work could I get started.

License

This package is Free Software licensed to you under the GPL v2 or later at your discretion. See the LICENSE.txt file for details.

About

Python interface to KeePass file format v3 (used in KeePass V1.x and KeePassX)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%