pass2bw/README.md

pass2csv

Needs python-gnupg. Run with path to password store as argument.

There are two ways to export CSV data:

1. The format for the KeePass Generic CSV Importer:

   Group(/),Title,Password,Notes
   

   Where 'Password' is the first line of the entry in pass and 'Notes' are all subsequent lines. '\' should not be interpreted as an escape character.

   To enable, set KPX_FORMAT=False in pass2csv.py

2. The format for the KeePassXC Importer:

   Group(/),Title,Login,Password,URL,Notes
   

   Where 'Password' is the first line of the entry in pass, 'User' is configured with LOGIN_FIELDS, URL is extracted if GET_URL is set, and 'Notes' contains any other fields that do not match EXCLUDE_ROWS.

   To enable, set KPX_FORMAT=True and configure the variables mentioned above in pass2csv.py.

   'User' field is chosen by searching for the first field with a name in LOGIN_FIELDS. Once the field is found, the login is set and the field is removed from notes.

Example KeePassXC Import

• Variable definitions (pass2csv.py)

    KPX_FORMAT=True
  
    LOGIN_FIELDS=['username', 'login', 'email']
    GET_URL=True
    EXCLUDE_ROWS=['^---$']
  

• Password entry (sites/example)

    password123
    ---
    username: user_name
    email: user@example.com
    url: example.com
    some_note
  

• Output CSV row (formatted)

    sites, example, user_name, password123, example.com, "email: user@example.com\nsome_note"
  

• user_name was chosen because username was the first filled entry in LOGIN_FIELDS.

• Both logn and URL fields were excluded from the notes field because they were used in another field.

• --- Was not included in the notes field because it was matched in EXCLUDE_ROWS.

Example KeePass Generic CSV Importer

• Variable definitions (pass2csv.py)

    KPX_FORMAT=False
  

• Password entry: Same as above

• Output CSV row (formatted)

    sites, example, password123, "---\nusername: user_name\nemail: user@example.com\nurl: example.com\nsome_note"