# Master
[![Deploy pages](https://github.com/jpedro/master/actions/workflows/pages.yaml/badge.svg)](https://github.com/jpedro/master/actions/workflows/pages.yaml)
Generates deterministic passwords
<!-- ![Pictutre](https://raw.githubusercontent.com/jpedro/master/master/docs/strong.jpg) -->
<!-- ![Strong password](https://raw.githubusercontent.com/jpedro/master/master/docs/blink.gif) -->
This is inspired by [spectre.app](https://spectre.app/) but simpler.
This uses a sha256 hashed combination of `username + password + service`
to generate the same password, thus eliminating the need to store,
maintain and back up other generated passwords.
[jpedro.github.io/master](https://jpedro.github.io/master/) has the
browser experience.
The used 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.
Eventually, the idea is to create a simple browser extension that uses
the URL domain name as the service.
## 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
NAME
master -- Generates deterministic passwords for services
USAGE
master NAME Gets the password for service NAME
master -l, --list Lists all stored services
master -r, --remove NAME Removes service NAME from the stored list
master -v, --version Shows the version
master -h, --help Shows this help
```
## 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` |
Using these default settings, it will generate a password that's 41
characters long. 6 chunks of 6 character long with 5 separators in
between.
> *Note*
> [1] If you don't set the `MASTER_USERNAME` or the `MASTER_PASSWORD` you
> will be prompted for them.
Raw data
{
"_id": null,
"home_page": "https://github.com/jpedro/master",
"name": "masterpass",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3",
"maintainer_email": "",
"keywords": "deterministic password generator",
"author": "jpedro",
"author_email": "jpedro.barbosa@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/f1/9e/a695b04b45601900a9381d874794404704447f23cafa934a584088a96332/masterpass-0.2.4.tar.gz",
"platform": null,
"description": "# Master\n\n[![Deploy pages](https://github.com/jpedro/master/actions/workflows/pages.yaml/badge.svg)](https://github.com/jpedro/master/actions/workflows/pages.yaml)\n\nGenerates deterministic passwords\n\n\n<!-- ![Pictutre](https://raw.githubusercontent.com/jpedro/master/master/docs/strong.jpg) -->\n<!-- ![Strong password](https://raw.githubusercontent.com/jpedro/master/master/docs/blink.gif) -->\n\nThis is inspired by [spectre.app](https://spectre.app/) but simpler.\nThis uses a sha256 hashed combination of `username + password + service`\nto generate the same password, thus eliminating the need to store,\nmaintain and back up other generated passwords.\n\n[jpedro.github.io/master](https://jpedro.github.io/master/) has the\nbrowser experience.\n\nThe used service name list is kept under the file\n`~/.config/master/list.txt` (or whatever `MASTER_LIST` points to)\n*purely for autocompletion*, which will be added later.\n\nEventually, the idea is to create a simple browser extension that uses\nthe URL domain name as the service.\n\n\n## Install\n\n pip install masterpass\n\nYes, yes. The package is called `masterpass` but the binary is called\n`master`. To be fixed after [#2582](https://github.com/pypi/support/issues/2582)\nis resolved.\n\n\n## Usage\n\n```\n$ master --help\n\nNAME\n master -- Generates deterministic passwords for services\n\nUSAGE\n master NAME Gets the password for service NAME\n master -l, --list Lists all stored services\n master -r, --remove NAME Removes service NAME from the stored list\n master -v, --version Shows the version\n master -h, --help Shows this help\n\n```\n\n\n## Environment variables\n\n| Name | Default |\n| ------------------- | ----------------------------- |\n| `MASTER_LIST` | `~/.config/master/list.txt` |\n| `MASTER_USERNAME` | (None) [1] |\n| `MASTER_PASSWORD` | (None) [1] |\n| `MASTER_SEPARATOR` | `-` |\n| `MASTER_LENGTH` | `6` |\n| `MASTER_CHUNKS` | `6` |\n\nUsing these default settings, it will generate a password that's 41\ncharacters long. 6 chunks of 6 character long with 5 separators in\nbetween.\n\n> *Note*\n> [1] If you don't set the `MASTER_USERNAME` or the `MASTER_PASSWORD` you\n> will be prompted for them.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Deterministic password generator",
"version": "0.2.4",
"project_urls": {
"Download": "https://github.com/jpedro/master/tarball/master",
"Homepage": "https://github.com/jpedro/master"
},
"split_keywords": [
"deterministic",
"password",
"generator"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e15146ad3d09b81b8a16d371b7c978b279342d283cd69ce747da555c2305c685",
"md5": "6aedb64cee8510ceda25c1789e3f1add",
"sha256": "2cafedff66efb5a122d27b3b5156b05b3774371d2d00916a31d6cf1256d6e4f4"
},
"downloads": -1,
"filename": "masterpass-0.2.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6aedb64cee8510ceda25c1789e3f1add",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3",
"size": 6177,
"upload_time": "2023-07-27T01:42:36",
"upload_time_iso_8601": "2023-07-27T01:42:36.271093Z",
"url": "https://files.pythonhosted.org/packages/e1/51/46ad3d09b81b8a16d371b7c978b279342d283cd69ce747da555c2305c685/masterpass-0.2.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f19ea695b04b45601900a9381d874794404704447f23cafa934a584088a96332",
"md5": "6e612c322ff224b4d0ac1471af886afb",
"sha256": "cf8a3f45e78ca02a1daad9110fbdcd80248cda694b0d9e687807cda92e828481"
},
"downloads": -1,
"filename": "masterpass-0.2.4.tar.gz",
"has_sig": false,
"md5_digest": "6e612c322ff224b4d0ac1471af886afb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3",
"size": 5169,
"upload_time": "2023-07-27T01:42:37",
"upload_time_iso_8601": "2023-07-27T01:42:37.723456Z",
"url": "https://files.pythonhosted.org/packages/f1/9e/a695b04b45601900a9381d874794404704447f23cafa934a584088a96332/masterpass-0.2.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-27 01:42:37",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jpedro",
"github_project": "master",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "masterpass"
}