Report Bug · Request Feature · Ask Question · Report security bug
Built to be secure, it encrypts your passwords with a key that only you know. Its intuitive syntax and reduced set of commands make it easy to use.
Table of Contents
Here's a breakdown of the packages needed and their versions:
- poetry >= 1.8.3 (only for manual installation)
- cryptocode >= 0.1
- prettytable >= 3.10.0
- rich >= 13.7.1
Note
The software has been developed and tested using Python 3.12.1. The minimum required version to run the software is Python 3.6. Although the software may work with previous versions, it is not guaranteed.
pswm can be installed easily as a PyPI package. Just run the following command:
pip3 install pswmImportant
For best practices and to avoid potential conflicts with your global Python environment, it is strongly recommended to install this program within a virtual environment. Avoid using the --user option for global installations. We highly recommend using pipx for a safe and isolated installation experience. Therefore, the appropriate command to install pswm would be:
pipx install pswmThe program can now be ran from a terminal with the pswm command.
When running pswm for the first time, you will be prompted to define a master password that will be used to encrypt your other passwords.
If you forget your master password, pswm will give you the option to reset it after three failed attempts. This would delete all your saved passwords since they would be encrypted with your old master password and impossible to decrypt without it. You should store your master password somewhere safe or choose something you will always remember.
After choosing a master password, a password vault will be created as an encrypted file named pswm inside ~/.local/share/pswm/.
You can use any of the following commands to access your password vault:
You can use the included python script from_csv.py to import passwords from your browser into pswm:
- In Chrome, navigate to
Settings > Autofill > Passwords. - Click on the three dotted menu to the right of Saved Passwords and select
Export passwords. - You can now execute the script to import all your passwords into pswm with the following command:
python3 from_csv.py <file.csv> <master_password>
This software comes without any warranty as distributed under the GNU GPL 2.0 license.
You should receive a copy of the license with your download of pswm.
Note
Credits to Julynx for creating the script. I only make improvements in his code based on my preferences to customize it. All the ideas and the base of the script are his.