Skip to content

buttercup/buttercup-importer

Repository files navigation

Buttercup Vault Importer

Import vaults from other password managers

npm Tests npm downloads

About

This vault importer coverts password vaults from other formats to the Buttercup vault format (BCUP).

Usage

This library is not intended to be used as a standalone application. Its functionality is available via the Buttercup Desktop applications.

You can of course use the importer in your own projects, by importing the individual importers.

Eg.

const { KDBXImporter } = require("@buttercup/importer");

KDBXImporter.loadFromFile("...");

Check out the API documentation.

Supported platforms

The importer requires Node 14 or later.

Supported password vault formats

  • Bitwarden JSON exports
  • Buttercup (BCUP) vaults
  • Buttercup CSV exports
  • CSV files
  • KeePass KDBX vaults (removed in v3)
  • KeePass XML exports
  • LastPass CSV exports
  • 1Password (1PIF) exports

Importing from 3rd-party managers

KeePass

KeePass vaults can be imported using either of the 2 supported importers:

  • KeePass XML (version 2) - KeePass2XMLImporter
  • KDBX vaults (up to, and including, version 4) - KDBXImporter

To import KeePass vaults, first export to XML format.

1Password

1Password vaults can be imported from 1pif directories using the OnePasswordImporter module.

Imported 1Password archives may lose some information regarding their type (eg. Credit cards). The 1Password Importer supports importing the following types:

  • Web Forms
  • Passwords
  • Credit Cards
  • Software Licenses
  • Emails
  • SSNs
  • Router Passwords

LastPass

Lastpass credentials can be exported as CSV files, which can be imported using Buttercup importer.

Bitwarden

Bitwarden credentials can be exported as JSON files, which can be imported using Buttercup importer.

Imported bitwarden archives contain the username, password, the first url associated with the item, notes and any custom fields. Attachments are not currently supported.

Buttercup

Buttercup vaults can be imported using the ButtercupImporter.

Importing from Buttercup exports

Exported Buttercup vaults can be re-imported into a new Vault. Take the exported CSV file and import that in Buttercup Desktop.