Metadata-Version: 2.1
Name: masterpass
Version: 0.1.10
Summary: Generates deterministic passwords for services
Home-page: https://github.com/jpedro/master
Download-URL: https://github.com/jpedro/master/tarball/master
Author: jpedro
Author-email: jpedro.barbosa@gmail.com
License: MIT
Keywords: deterministic password
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3
Description-Content-Type: text/markdown

# Master

Deterministic passwords for everyone.

![Strong password](https://blogs.quickheal.com/wp-content/uploads/2017/11/5_password_mistakes_people_make.jpg)


This uses a combination of `username + password + service + counter`
to generate the same password, over and over again, thus eliminating
the need to store, maintain and back up other generated passwords.

The username and password are not stored anywhere. A service name
list is kept under the file `~/.config/master/list.txt` (or whatever
`MASTER_LIST` points to) purely for autocompletion (which will be
added later).


## Install

    pip install masterpass

Yes, yes. The package is called `masterpass` but the binary is called
`master`. To be fixed after [#2582](https://github.com/pypi/support/issues/2582)
is resolved.


## Usage

```
$ master --help
Usage: master [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  get      Gets the deterministic password for SERVICE.
  ls       Lists all stored services.
  rm       Removes SERVICE from the stored list.
  version  Shows the version.
```


## Environment variables

| Name                | Default                       |
| ------------------- | ----------------------------- |
| `MASTER_LIST`       | `~/.config/master/list.txt`   |
| `MASTER_USERNAME`   | (None) [1]                    |
| `MASTER_PASSWORD`   | (None) [1]                    |
| `MASTER_SEPARATOR`  | `-`                           |
| `MASTER_LENGTH`     | `6`                           |
| `MASTER_CHUNKS`     | `6`                           |

**Note [1]:** If you don't set the `MASTER_USERNAME` or the
`MASTER_PASSWORD` you will be prompted for them.
