$ brew install harunsasmaz/tap/passman
$ go install github.com/harunsasmaz/passman/cmd/passman@latest
You can see releases section for binaries and supported platforms. They contain the compiled executable.
- Verify that you have go 1.17.x installed.
$ go version
If go
is not installed, follow directions on Go Install Page.
- Clone repository
$ git clone https://github.com/harunsasmaz/passman.git
$ cd passman
- Build and Install
On MacOS/BSD
# may require you to use sudo
$ make
$ cp passman /usr/local/bin/passman
On Unix/Linux
# may require you to use sudo
$ go build -o passman cmd/passman/main.go
$ cp passman /usr/local/bin/passman
$ passman -h
NAME:
passman - generate and manage your passwords on your computer
USAGE:
passman [COMMANDS] [FLAGS] [ARGS]
VERSION:
1.0.0
AUTHOR:
Harun Sasmaz <me@harunsasmaz.com>
...
USAGE:
passman generate [FLAGS] [ARGS]
If you set --level, other options will be discarded
OPTIONS:
--level value, -l value choose a strength to use built-in options. Easy: 1, Mid: 2, Hard: 3. Example: -l 1
--length value, -n value set the length of the password (default: 16)
--digit value, -d value set the number of digits included in the password. (default: 4)
--symbol value, -s value set the number of symbols included in the password. (default: 4)
--upper, -u set if password can contain uppercase letters. (default: false)
--no-repeat, -r set if password should not contain repeated characters. (default: false)
Example
$ passman generate -n 64 -d 8 -s 8 -u -r
Output:
> Copied to clipboard!
> "VLJpTB%P3O+ZvRm/W9C8czFEXqoKIwhl7uiU`&dgGnNkYM4rb6H?eyax1fjs@2S|"
USAGE:
passman create [FLAGS] [ARGS]
OPTIONS:
--alias value, -a value set an alias for the new credentials.
--account value, -u value set account or host that password will be used for.
--password value, -p value set password.
--generate, -g generates a new secure password to save. (default: false)
Example
$ passman create -a website -u harunsasmaz.com -g
Output:
> Successfully created credentials for alias: website
USAGE:
passman get <alias>
Example
$ passman get website
$ Password: <YOUR_PASSMAN_PASSWORD>
Output:
> Successfully retrieved password!
> Password is used for account: harunsasmaz.com
> Copied password to clipboard!
USAGE:
passman update [FLAGS] [ARGS]
OPTIONS:
--alias value, -a value set alias that you want to update.
--account value, -u value set account or host if you want to update.
--password value, -p value set password if you want to update.
--generate, -g generates a new secure password to update. (default: false)
Example
$ passman update -a website -u harunsasmaz.me
$ Password: <YOUR_PASSMAN_PASSWORD>
Output:
> Account name renewed!
> Successfully saved changes!
USAGE:
passman delete [FLAGS] [ARGS]
OPTIONS:
--alias value, -a value delete credentials for provided alias
--all delete all stored credentials (default: false)
Example
$ passman delete -a website
$ Password: <YOUR_PASSMAN_PASSWORD>
Output:
> Successfully deleted credentials for alias: website
There are still tons of work to do. So, any kind of help to improve passman is welcomed.
passman's source code is licensed under GNU GPL-3.0 License