2019-07-01 06:03:41 +00:00
|
|
|
# gpm: Go Passwords Manager
|
|
|
|
|
2019-07-23 17:25:45 +00:00
|
|
|
[![Version](https://img.shields.io/badge/latest_version-1.1.0-green.svg)](https://git.yaegashi.fr/nishiki/gpm/releases)
|
2019-07-01 06:03:41 +00:00
|
|
|
[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](https://git.yaegashi.fr/nishiki/gpm/src/branch/master/LICENSE)
|
|
|
|
|
|
|
|
gpm is passwords manager write in go and use AES-256 to encrypt the wallets
|
|
|
|
|
|
|
|
## Features
|
|
|
|
|
2019-07-20 13:45:22 +00:00
|
|
|
- generate TOTP code
|
2019-07-01 06:03:41 +00:00
|
|
|
- copy your login, password or otp in clipboard
|
|
|
|
- manage multiple wallets
|
2019-07-16 20:56:17 +00:00
|
|
|
- generate random password
|
2019-07-01 06:03:41 +00:00
|
|
|
|
|
|
|
## Install
|
|
|
|
|
2019-07-23 17:20:08 +00:00
|
|
|
- Install [golang](https://golang.org/doc/install)
|
|
|
|
- Add `~/go/bin` in your `PATH`
|
|
|
|
- Download and build
|
2019-07-01 06:03:41 +00:00
|
|
|
|
2019-07-23 17:20:08 +00:00
|
|
|
```text
|
|
|
|
go get git.yaegashi.fr/nishiki/gpm/cmd/gpm
|
|
|
|
```
|
|
|
|
|
|
|
|
## How to use
|
|
|
|
|
|
|
|
### First steps
|
|
|
|
|
|
|
|
- Add new entry `gpm -add`
|
2019-07-01 06:03:41 +00:00
|
|
|
|
|
|
|
```text
|
2019-07-23 17:20:08 +00:00
|
|
|
Enter the passphrase to unlock the wallet:
|
|
|
|
Enter the name: Test
|
|
|
|
Enter the group: MyGroup
|
|
|
|
Enter the URI: http://localhost
|
|
|
|
Enter the username: lastname
|
|
|
|
Enter the new password:
|
|
|
|
Enter the OTP key:
|
|
|
|
Enter a comment: My first entry
|
|
|
|
the entry has been added
|
2019-07-01 06:03:41 +00:00
|
|
|
```
|
|
|
|
|
2019-07-23 17:20:08 +00:00
|
|
|
- Search and copy `gpm -copy`
|
2019-07-01 06:03:41 +00:00
|
|
|
|
|
|
|
```text
|
2019-07-23 17:20:08 +00:00
|
|
|
Enter the passphrase to unlock the wallet:
|
|
|
|
|
|
|
|
MyGroup
|
|
|
|
|
|
|
|
| NAME | URI | USER | OTP | COMMENT
|
|
|
|
----+------+------------------+----------+-----+-----------------
|
|
|
|
0 | Test | http://localhost | lastname | X | My first entry
|
|
|
|
|
|
|
|
select one action: p
|
|
|
|
select one action: l
|
|
|
|
select one action: q
|
2019-07-01 06:03:41 +00:00
|
|
|
```
|
|
|
|
|
2019-07-23 17:20:08 +00:00
|
|
|
### All options
|
2019-07-01 06:03:41 +00:00
|
|
|
|
|
|
|
```text
|
|
|
|
gpm -help
|
|
|
|
-add
|
|
|
|
add a new entry in the wallet
|
|
|
|
-config string
|
|
|
|
specify the config file
|
|
|
|
-copy
|
|
|
|
enter an copy mode for an entry
|
|
|
|
-delete
|
|
|
|
delete an entry
|
2019-07-23 17:20:08 +00:00
|
|
|
-digit
|
|
|
|
use digit to generate a random password
|
|
|
|
-export
|
|
|
|
export a wallet in json format
|
2019-07-01 06:03:41 +00:00
|
|
|
-group string
|
2019-07-23 17:20:08 +00:00
|
|
|
search the entries in this group
|
2019-07-01 06:03:41 +00:00
|
|
|
-help
|
|
|
|
print this help message
|
2019-07-23 17:20:08 +00:00
|
|
|
-import string
|
|
|
|
import entries from a json file
|
|
|
|
-length int
|
|
|
|
specify the password length (default 16)
|
|
|
|
-letter
|
|
|
|
use letter to generate a random password
|
2019-07-01 06:03:41 +00:00
|
|
|
-list
|
|
|
|
list the entries in a wallet
|
2019-07-23 17:20:08 +00:00
|
|
|
-password
|
|
|
|
generate and print a random password
|
2019-07-01 06:03:41 +00:00
|
|
|
-pattern string
|
|
|
|
search the entries with this pattern
|
2019-07-23 17:20:08 +00:00
|
|
|
-random
|
|
|
|
generate a random password for a new entry or an update
|
|
|
|
-special
|
|
|
|
use special chars to generate a random password
|
2019-07-01 06:03:41 +00:00
|
|
|
-update
|
|
|
|
update an entry
|
2019-07-23 17:20:08 +00:00
|
|
|
-wallet string
|
|
|
|
specify the wallet
|
2019-07-01 06:03:41 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
|
|
```text
|
|
|
|
Copyright (c) 2019 Adrien Waksberg
|
|
|
|
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
you may not use this file except in compliance with the License.
|
|
|
|
You may obtain a copy of the License at
|
|
|
|
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
See the License for the specific language governing permissions and
|
|
|
|
limitations under the License.
|
|
|
|
```
|