Experimenting with creating a password manager
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



Author: eric-cc-su

Locker is an experimental, trying-to-learn-new-things, terminal Python password manager. The program uses the cryptography Python library to encrypt and store key, password pairs. The idea is to be able to securely save and serve passwords for the user, as well as encrypt the user's files as requested.



Locker has been developed and tested on Windows 7 and OS X 10.10 (Yosemite). Locker has not yet been tested on Linux distros and may or may not produce unwanted side effects.

##Running Locker

In the terminal, navigate to the Locker directory and run locker.py as a python script using Python 3

cd */locker
python locker.py

##Initial Authentication

When running Locker, you will first need to supply a "locker combination". Currently (06/24/15), any unrecognized locker combinations will ask the user if they wish to create a new repository. This allows users to have multiple, isolated "databases". Make sure you are using the correct locker combination to access the desired sensitive data.



The list function will display the key values in the catalog. This shows the user what key, value pairs they have saved in the database.



The import function will read a file (preferably .txt) and import key, value pairs into the database from the file data. You need to provide two things to the import function:

  1. The filepath: you will be prompted for the filepath. You may use an absolute or a relative file path. Press Enter to input the formatting.
  2. The formatting: it is expected that your file is set up in a simple key, value style format. Use LABEL to represent the key, and PWD to represent the value. LABEL and PWD are case sensitive and your input should reflect the exact spacing and content of your file's lines.
    • ex: if the lines of your file are set up as: Facebook - password1, you will input LABEL - PWD.
    • ex: if the lines of your file are more like password add some words facebook, there was the key then you will need to input PWD add some words LABEL, there was the key



The new function will allow the user to add a new key, value pair.



Delete a key, value pair.



encrypt will be used to encrypt files unrelated to Locker. The user will provide the filepath and a key to encrypt the file. The file will only be decryptable with the proper key.



decrypt will be used to serve a key, value pair's value to the user. The user will input the key and the key's value will be decrypted and served to the user. If encrypt is developed to encrypt individual files, decrypt will have the ability to either decrypt or serve the file.

Functional: decrypts key, value pairs and files


I know extremely little about developing programs for encryption and security. The experimental, trying-to-learn-new-things designation above is EXTREMELY IMPORTANT to note as this is an IN PROGRESS project to teach myself more about Python and security. I am NOT responsible for any lost or compromised sensitive data that may result from the use of this code.

You Know Nothing

(Know Your Meme)

This code is licensed under the MIT License and under copyright by Eric Su

© 2015 Eric Su