mirror of https://github.com/nishiki/manage-password.git synced 2024-10-27 02:33:19 +00:00

MPW is a little software which stores your passwords in an GPG encrypted file.

Find a file

Adrien Waksberg d185509113 fix bug in otp generator		2017-07-30 22:30:15 +02:00
bin	enable text editor if threre isn't nothing value who has been set	2017-05-20 15:30:19 +02:00
i18n	Update translations EN	2017-05-23 19:49:20 +02:00
lib/mpw	fix bug in otp generator	2017-07-30 22:30:15 +02:00
templates	feat: add options to edit or update an item	2017-04-13 22:35:57 +02:00
test	add test cli for copy mode	2017-05-21 17:31:48 +02:00
.gitignore	feat: comment the code with yard	2017-05-03 22:53:56 +02:00
.rubocop.yml	fix syntax for all tests	2017-05-11 22:46:59 +02:00
.travis.yml	add gem test-unit for development	2017-05-23 19:33:05 +02:00
CHANGELOG.md	fix bug in otp generator	2017-07-30 22:30:15 +02:00
Gemfile	update Gemfile to fix rubocop version	2017-06-06 23:06:25 +02:00
LICENSE	rename license	2013-12-26 21:02:53 +01:00
mpw.gemspec	gemspec: add minimal ruby version	2017-04-20 23:26:40 +02:00
README.md	fix bug in otp generator	2017-07-30 22:30:15 +02:00
VERSION	fix bug in otp generator	2017-07-30 22:30:15 +02:00

README.md

MPW: Manage your passwords!

mpw is a little software which stores your passwords in GnuPG encrypted files.

Features

generate random password
generate OTP code
copy your login, password or otp in clipboard
manage many wallets
share a wallet with others GPG keys

Install

On debian or ubuntu:

apt install ruby ruby-dev xclip
gem install mpw

How to use

First steps

Initialize your first wallet:

mpw config --init user@host.com

Add your first item:

mpw add --host assurance.com --port 443 --user user_2132 --protocol https --random
mpw add --host fric.com --user 230403 --otp-code 23434113 --protocol https --comment 'I love my bank' --random

And list your items:

mpw list

or search an item with

mpw list --pattern love
mpw list --group bank

Output:

Assurance
 ==========================================================================
  ID | Host                        | User        | OTP | Comment          
 ==========================================================================
  1  | https://assurance.com:443   | user_2132   |     |                  

Bank
 ==========================================================================
  ID | Host                        | User        | OTP | Comment          
 ==========================================================================
  3  | https://fric.com            | 230403      |  X  | I love my bank

Copy a password, login or OTP code:

mpw copy -p assurance.com

Update an item:

mpw update -p assurance.com

Delete an item:

mpw delete -p assurance.com

Manage wallets

List all available wallets:

mpw wallet

List all GPG keys in wallet:

mpw wallet --list-keys [--wallet NAME]

Share with an other GPG key:

mpw wallet --add-gpg-key test42@localhost.com
 or
mpw wallet --add-gpg-key /path/to/file

Remove a GPG key:

mpw wallet --delete-gpg-key test42@localhost.com

Export and import data

You can export your data in yaml file with your passwords in clear text:

mpw export --file export.yml

Import data from an yaml file:

mpw import --file import.yml

Example yaml file for mpw:

---
1:
  host: fric.com
  user: 230403
  group: Bank
  password: 5XdiTQOubRDw9B0aJoMlcEyL
  protocol: https
  port:
  otp_key: 330223432
  comment: I love my bank
2:
  host: assurance.com
  user: user_2132
  group: Assurance
  password: DMyK6B3v4bWO52VzU7aTHIem
  protocol: https
  port: 443
  otp_key:
  comment:

Config

Print the current config

mpw config

Output:

Configuration
 ==============================================
  lang             | fr
  gpg_key          | mpw@yae.im
  default_wallet   |
  config_dir       | /home/mpw/.config/mpw
  pinmode          | true
  gpg_exe          |
  path_wallet_test | /tmp/test.mpw
  password_numeric | true
  password_alpha   | true
  password_special | false
  password_length  | 16