Skip to content
Branch: master
Go to file
Code

Latest commit

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 

README.md

passman - A simple command line password manager

DEPRECATION NOTICE

This project is not maintained anymore. While it's been in use in its current version for more than five years and was working reasonably well, I've personally switched to pass (https://www.passwordstore.org/). If you're using passman and consider switching as well, you can export all your passwords to pass using passman export_to_pass.

Features

  • Strong encryption via GPG
  • Support for either public-key or symmetric encryption
  • Add, get and delete passwords with simple commands
  • Easy web browser / login forms support
  • Custom regular expressions for matching windows

Usage

Prerequisites and configuration

  1. Make sure you have the following software installed and accessible on your system:

    bash, gpg2, dmenu, xdotool, xte, pwgen

    For Debian/Ubuntu users, this translates into having the following packages installed: bash, gnupg2, suckless-tools, xdotool, xautomation and pwgen.

  2. Run passman-config. It will set up $HOME/.passman/config for you.

  3. For convenience set up a GPG-Agent which caches your GPG credentials for some time.

Running

Adding a password

$ passman add

Getting a password

$ passman get <site>

Deleting a password

$ passman del <site>

Filling forms (always display dmenu chooser)

$ passman submitform

A dmenu dialog will pop up, let you chose the desired entry and enter the credentials via xte in the form "userpassword" or "password" if there is no user for an entry.

Filling forms (automatically try to match site key against current window name)

$ passman autosubmitform

You may map this command to an easy system-wide keyboard shortcut to save time when filling out browser login forms.

Setting a regular expression hint for a specific entry

$ passman sethint <site> '<regex>'

Be sure to quote the regex with single quotes to avoid false interpretations of your shell.

Query the regular expression hint for a specific entry

$ passman gethint <site>

Setting a custom template for a specific entry

$ passman settemplate <site> <template>

This changes the way passman will type the credentials when filling forms. Expects a comma separated list of 'Username', 'Password', 'Tab' and 'Return'. E.g. 'Username,Tab,Tab,Password,Return' for a site where you need to press 'Tab' twice between entering username and password.

Query the custom template for a specific entry

$ passman gettemplate <site>

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

About

A simple command line password manager

Resources

License

Releases

No releases published

Languages

You can’t perform that action at this time.