https://github.com/rossmacarthur/passthesalt

:key: Deterministic password generation and password storage
https://github.com/rossmacarthur/passthesalt

password password-manager pbkdf2 python python2 python3

Last synced: 11 days ago
JSON representation

:key: Deterministic password generation and password storage

• Host: GitHub
• URL: https://github.com/rossmacarthur/passthesalt
• Owner: rossmacarthur
• License: mit
• Created: 2017-08-15T20:27:08.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2023-03-17T09:41:13.000Z (almost 2 years ago)
• Last Synced: 2024-12-17T02:42:01.878Z (17 days ago)
• Topics: password, password-manager, pbkdf2, python, python2, python3
• Language: Python
• Homepage:
• Size: 129 KB
• Stars: 1
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# PassTheSalt

[![PyPI](https://img.shields.io/pypi/v/passthesalt)](https://pypi.org/project/passthesalt/)

![PyPI: supported Python](https://img.shields.io/pypi/pyversions/passthesalt)

[![Build status](https://img.shields.io/github/workflow/status/rossmacarthur/passthesalt/build)](https://github.com/rossmacarthur/passthesalt/actions?query=workflow%3Abuild)

[![Code coverage](https://img.shields.io/codecov/c/github/rossmacarthur/passthesalt/master.svg)](https://codecov.io/gh/rossmacarthur/passthesalt)

[![Code style](https://img.shields.io/badge/code%20style-black-101010.svg)](https://github.com/psf/black)

A command line application for deterministic password generation and password

storage.

## Getting started

Install it using

```sh

pip install passthesalt

```

and start storing secrets with

```sh

pts add

```

## How does it work?

Secrets are generated on the fly using the same secure algorithm each time which

uses a *master password* and a *description* of the password. Only the

description of the secret is stored. This means the secrets are not stored

anywhere.

The generation algorithm is PBKDF2 using 2048 iterations of HMAC-SHA-256,

applied to (*full name* + *master password*) as the key and the *description* as

the salt.

Since sometimes you cannot choose your passwords the application also has

provision to securely encrypt secrets with the master password.

## Usage

The command-line interface has the following commands

```

add      Add a secret.

diff     Compare two stores.

edit     Edit a secret.

encrypt  Encrypt a secret.

get      Retrieve a secret.

ls       List the secrets.

mv       Relabel a secret.

pull     Retrieve a remote store.

push     Update the remote store.

rm       Remove a secret.

```

All commands and options are documented in the cli. You can use the `--help`

option with any command.

## License

This project is licensed under the MIT license ([LICENSE](LICENSE) or

http://opensource.org/licenses/MIT).