Make sure your computer has Ruby installed.
You can then install pws with:
$ gem install pws
$ pws --help for usage information.
If you use pws on Linux, you will need to have
xclip installed (for the clipboard to work).
Tips & Troubleshooting
How to use a .pws file in the current working directory
Besides using the
--filename path/to/safe option, you can shortly call
pws --cwd for using a
.pws file in the current directory.
.pws into version control and you have a great way to share a project's passwords within your team.
You should use a Ruby that was built with bindings to an openssl version >= 1.0 or pws will fall back to a Ruby-only version of the PBKDF2 function, which is much slower. If using openssl 1.0 is not possible for you, you can work around that issue by using the
--iterations option with a value below 75_000 (see help). If you have problems using openssl 1.0 with your Ruby, please look for a solution in this issue.
Updating from pws 0.9
The 0.9 password files are not compatible with the 1.0 version of pws, however, you can convert your safe with:
$ pws resave --in 0.9 --out 1.0
Reading the source
Projects built on top of PWS
- pws-otp Experimental OTP support for 2FA
- pwsqr Simple QR interface to pws gem. Helps to use your passwords on a smartphone.
- aws-pws A password-protected CredentialProvider for AWS
- omnivault Multi-platform keychain functionality
- Packaging ruby programs in NixOS using PWS as example
- thecatwasnot (cucumber specs loosely based on these)
© 2010-2019 Jan Lelis, MIT license