Metadata-Version: 2.1
Name: keepassxc-pwned
Version: 0.3.0
Summary: Check your keepassxc database against previously breached haveibeenpwned passwords
Home-page: https://github.com/seanbreckenridge/keepassxc-pwned
Author: Sean Breckenridge
Author-email: seanbrecke@gmail.com
License: MIT
Description: # KeepassXC-Pwned
        
        [![PyPi version](https://img.shields.io/pypi/v/keepassxc_pwned.svg)](https://pypi.python.org/pypi/keepassxc_pwned) [![Python 3.6|3.7](https://img.shields.io/pypi/pyversions/keepassxc_pwned.svg)](https://pypi.python.org/pypi/keepassxc_pwned) [![Build Status](https://travis-ci.com/seanbreckenridge/keepassxc-pwned.svg?branch=master)](https://travis-ci.com/seanbreckenridge/keepassxc-pwned) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)
        
        This checks a [KeePassXC](https://keepassxc.org/) database against previously cracked [haveibeenpwned](https://haveibeenpwned.com/) passwords.
        
        #### Requirements
        
        * `keepassxc-cli` binary (typically installed with KeePassXC)
        * python 3.6 or above
        
        #### Install
        
        `pip3 install keepassxc-pwned`
        
        #### Run
        
        Run: `keepassxc_pwned ~/database.kdbx`
        
        ```
        Usage: keepassxc_pwned [OPTIONS] DATABASE
        
          Check a keepassxc database against previously cracked haveibeenpwned
          passwords
        
        Options:
          -p, --plaintext      Print breached passwords in plaintext; defaults to sha1
                               hashes.
          -k, --key-file PATH  Key file for the database
          -v, --verbose        Print debug messages
          -q, --quiet          Don't print status messages, just the summary
          --help               Show this message and exit.
        ```
        
        Sample Run:
        
        ```
        $ keepassxc_pwned ~/Documents/updated_database.kdbx
        Insert password for /home/sean/Documents/updated_database.kdbx:
        Checking password for Amazon...
        Checking password for Github...
        Checking password for Netflix...
        Checking password for Steam...
        Checking password for letterboxd...
        Checking password for linkedin...
        Checking password for minecraft...
        Found password for 'minecraft' 3 times in the dataset!
        Checking password for soundcloud...
        Checking password for stackoverflow...
        Checking password for wikipedia...
        Found 1 previously breached password:
        minecraft:5BAA61E4C9B93F3F0682250B6CF8331B7EE68FD8:3
        ```
        
        You can also import this to use in python code...
        
        ```
        from keepassxc_pwned import check_password
        check_password("password")
        ```
        
        *Note: `check_password` doesn't attempt to do any rate limiting.*
        
        ... or enter the password manually...
        
        ```
        $ python3 -m keepassxc_pwned
        Password to check:
        Found password 1054 times!
        ```
        
        #### Privacy concerns
        
        This tool only transmits the first 5 characters of the SHA-1 hash of your passwords.
        You can read more about that [here](https://www.troyhunt.com/ive-just-launched-pwned-passwords-version-2/#cloudflareprivacyandkanonymity).
        
        #### Troubleshooting
        
        If you get the following error while using `keepassxc-cli`:
        
        ```
        dyld: Library not loaded: /usr/local/opt/quazip/lib/libquazip.1.dylib
          Referenced from: /usr/local/bin/keepassxc-cli
          Reason: image not found
        Abort trap: 6
        ```
        
        ... installing `quazip` should fix that:
        
        - `brew install quazip` (Mac)
        
        - `sudo apt install libquazip-dev` (Linux)
        
        If `keepassxc-cli` fails with an error message like "Invalid Command extract.", the command was changed in KeePassXC 2.5.0, and is now called `export`. Upgrade KeePassXC to the latest version, and try again.
        
        #### Tests
        
        * Clone this repository
        * Install dev dependencies: `pip3 install -r requirements-dev.txt`
        * `mypy keepassxc_pwned`
        * `pytest`
        
        
Keywords: keepassxc password-strength password
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: End Users/Desktop
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Description-Content-Type: text/markdown
