Stable version

Make sure you have GPG and pip installed:

pip install pysswords

Development version

The latest development version can be installed directly from GitHub:

$ pip install --upgrade https://github.com/marcwebbie/pysswords/tarball/master

1) Syncing your database

# move your Pysswords database inside your Dropbox directory
mv ~/.pysswords ~/Dropbox/.pysswords

# create a symbolic link to your shared .pysswords directory on the default path.
ln -s ~/Dropbox/.pysswords ~/.pysswords

# move your Pysswords database inside your Dropbox directory
mv ~/.pysswords ~/GoogleDrive/.pysswords

# create a symbolic link to your shared .pysswords directory on the default path.
ln -s ~/GoogleDrive/.pysswords ~/.pysswords

2) Exporting/Importing Pyssword databases

# export database to a pysswords database file called pysswords.db
# Option: `--export`
pysswords --export pysswords.db

# import database from pysswords database file called pysswords.db
# Option: `--import`
pysswords --import pysswords.db

# import 1password 1pif exported file
pysswords --import passwords.1pif/data1.1pif

3) Grouping credentials by name

Pysswords credentials handles multiple logins for each name which groups credentials by name:

# create john credential
pysswords -a
Name: example.com
Login: john
Password: **********
Comment: No comment

# create doe credential
pysswords -a
Name: example.com
Login: doe
Password: **********
Comment:

# listing credentials
pysswords

| Name        | Login   | Password   | Comment    |
|-------------+---------+------------+------------|
| example.com | doe     | ***        |            |
| example.com | john    | ***        | No comment |

4) Selecting credentials by fullname syntax

You can select grouped credentials by using fullname syntax login@name:

pysswords -g doe@example.com

| Name        | Login   | Password   | Comment   |
|-------------+---------+------------+-----------|
| example.com | doe     | ***        |           |

5) Using multiple databases

Sometimes it is useful to have multiple databases with different passphrases for higher security. This can be done using -D Pysswords option.

# create personal Pysswords database
pysswords --init -D ~/databases/personal_passwords

# create work Pysswords database
pysswords --init -D ~/databases/work_passwords

# create junk Pysswords database
pysswords --init -D ~/databases/junk_passwords

# add password to personal Pysswords database
pysswords -D ~/databases/personal_passwords -a

# add password to junk Pysswords database
pysswords -D ~/databases/junk_passwords -a

# listing specific databases
pysswords -D ~/databases/junk_passwords

Encryption

Encryption is done with GnuGPG using AES256. Take a look at pysswords.crypt module to know more.

Database Path

The default database path is at ~/.pysswords. If you want to change the database path, add --database option to pysswords together with --init.

pysswords --init --database "/path/to/another/database/"

Database structure

Pysswords database is structured in a directory hierachy. Every credential is a .pyssword file inside a directory named after a credential group.

An empty database would look like this:

pysswords --database /tmp/pysswords --init

tree /tmp/pysswords -la
# /tmp/pysswords
# └── .keys
#     ├── pubring.gpg
#     ├── random_seed
#     ├── secring.gpg
#     └── trustdb.gpg

After adding a new credential the database would look like this:

pysswords --database /tmp/pysswords -a
# Name: github.com
# Login: octocat
# Password: **********
# Comments:

tree /tmp/pysswords -la
# /tmp/pysswords
# ├── .keys
# │   ├── pubring.gpg
# │   ├── random_seed
# │   ├── secring.gpg
# │   └── trustdb.gpg
# └── github.com
#     └── octocat.pyssword

If we add more credentials to group github.com. Directory structure would be:

pysswords --database /tmp/pysswords -a
# Name: github.com
# Login: octocat2
# Password: **********
# Comments:

tree /tmp/pysswords -la
# /tmp/pysswords
# ├── .keys
# │   ├── pubring.gpg
# │   ├── random_seed
# │   ├── secring.gpg
# │   └── trustdb.gpg
# └── github
#     └── octocat.pyssword
#     └── octocat2.pyssword