Installation

Install with:

pip install --user bw-export

It will install both bw-csv-export and bw-json-export to ~/.local/bin.

You can find the latest version of the source code on Github.

bw-json-export

Generates a JSON file (bw.json) suitable for uploading to a BitWarden Vault.

Usage:

bw-json-export

Only those accounts with “bitwarden” field are exported. The “bitwarden” field is expected to be a dictionary that contain the fields to be exported. The value may be a simple string or it may be a script, and in some cases it may be a dictionary.

A typical example is:

bitwarden = dict(
    type = "login",
    name = "The Economist",
    urls = "{urls}",
    username = "{email}",
    password = "{passcode}",
)

You can add arbitrary fields using fields as represented by a NestedText dictionary:

bitwarden = dict(
    type = "login",
    name = "Visa",
    fields = """
        holder: {name}
        ccn: {ccn}
        exp: {exp}
        cvv: {cvv}
        report: {support}
    """,
)

You can also use a Python dictionary:

bitwarden = dict(
    type = "login",
    name = "Visa",
    fields = dict(
        holder = "{name}",
        ccn = "{ccn}",
        exp = "{exp}",
        cvv = "{cvv}",
        report = "{support}",
    ),
)

There are four types of entries supported, and they accept the following fields:

1: login
    name
    username
    password
    totp
    urls
    fields
    notes

2: secureNote
    name
    notes
    fields

3: card
    name
    brand
    holder
    ccn
    exp
    cvv
    fields
    notes

4: identity
    name
    title
    names
    street
    city
    state
    zip
    country
    email
    phone
    company
    ssn
    username
    passport
    license
    fields
    notes

Running bw-json-export creates the file: bw.json.

Once created, it can be imported from the BitWarden website (vault.bitwarden.com). When importing, use “Bitwarden (json)” as the file format.

By policy, BitWarden create duplicates of any imported accounts if they were previously imported. As such, you should delete existing accounts before re-importing to avoid duplicate accounts. A convenient way of doing so would be to partition your BitWarden cards into two folders, one dedicated to accounts imported from Avendesora and one dedicated you your BitWarden native cards. Before importing, first delete all the entries in the “Avendesora” folder, and then delete the folder itself by clicking on it, a pencil icon will appear, click on that, and then click on the trash can icon. Importing will then create a new “Avendesora” folder.

After first run, a settings file is created in ~/.config/bw-json-export/settings.nt. You can use it to control the name of the “Avendesora” folder. The default value is “[Avendesora-]YYMMDD”. The characters within the brackets is output verbatim and the remaining characters are interpreted as an Arrow format.

After importing your bw.json file you must delete it as it contains your secrets in plain text.

bw-csv-export

Generates a CSV file (bw.csv) suitable for uploading to a BitWarden Vault.

Usage:

bw-csv-export

Only those accounts with “bitwarden” field are exported. The “bitwarden” field is expected to be a dictionary that may contain the following fields: folder, type, name, notes, fields, url, username, password, and totp. If not given, they are left blank. Each value may be a simple string or a script.

A typical example is:

bitwarden = dict(
    type = "login",
    name = "The Economist",
    login_uri = "{urls}",
    login_username = "{email}",
    login_password = "{passcode}",
)

You can add arbitrary name-value pairs using fields:

bitwarden = dict(
    type = "login",
    name = "Visa",
    fields = """
        holder: {name}
        number: {ccn}
        exp: {exp}
        cvv: {cvv}
        report: {support}
    """,
)

Running bw-csv-export creates the file: bw.csv.

Once created, it can be imported from the BitWarden Vault website (vault.bitwarden.com). When importing, use “Bitwarden (csv)” as the file format.

By policy, BitWarden create duplicates of any imported accounts if they were previously imported. As such, you should delete existing accounts before re-importing to avoid duplicate accounts. A convenient way of doing so would be to partition your BitWarden entries into two folders, one dedicated to accounts imported from Avendesora and one dedicated you your BitWarden native entries. Normally you would keep the “No Folder” folder empty. BitWarden places freshly imported accounts into “No Folder”. You should then delete any existing accounts in the “Avendesora” folder and move all the new accounts in “No Folder” to the “Avendesora” folder.

You must then delete the bw.csv file as it can include your secrets in plain text.