[<img src="https://gitlab.com/uploads/-/system/project/avatar/2296403/logo.png" align="right" height="110"/>][github-link]
# pass import
[![][workflow]][action] [![][gitlab]][gitlab-link] [![][coverage]][coverage-link] [![][quality]][quality-link] [![
][release]][release-link]
**A [pass] extension for importing data from most existing password managers**
## Description
`pass import` is a password store extension allowing you to import your password database to a password store repository conveniently. It natively supports import from <!-- NB BEGIN -->62<!-- NB END --> different password managers. More manager support can easily be added.
Passwords are imported into the existing default password store, therefore the password store must have been initialized before with `pass init`.
By default, pass imports entries at the root of the password store and only keeps the main data (password, login, email, URL, group). This behaviour can be changed using the provided options.
Pass import handles duplicates and is compatible with [browserpass]. It imports OTP secret in a way that is compatible with [pass-otp].
pass-import also provides a `pimport` script that allows importing passwords to other password managers. For instance, you can import passwords from Lastpass to a Keepass database. It currently supports password export from <!-- NB DST BEGIN -->8<!-- NB DST END --> managers.
**The following password managers are supported:**
<!-- LIST BEGIN -->
<!-- Do not edit manually, use 'make doc' instead. -->
<table>
<thead>
<th align="center">Password Manager</th>
<th align="center">Formats</th>
<th align="center">How to export Data</th>
<th align="center">Command line</th>
</thead>
<tbody>
<tr>
<td align="center" rowspan="4"><a href="https://1password.com">1password</a></td>
<td align="center"><code>csv v8</code></td>
<td align="center"><i>See <a href="https://support.1password.com/export">this guide</a></i></td>
<td align="center"><code>pass import 1password file.csv</code></td>
</tr>
<tr>
<td align="center"><code>1pif v4</code></td>
<td align="center"><i>See <a href="https://support.1password.com/export">this guide</a></i></td>
<td align="center"><code>pass import 1password file.1pif</code></td>
</tr>
<tr>
<td align="center"><code>csv v4</code></td>
<td align="center"><i>See <a href="https://support.1password.com/export">this guide</a></i></td>
<td align="center"><code>pass import 1password file.csv</code></td>
</tr>
<tr>
<td align="center"><code>csv v6</code></td>
<td align="center"><i>See <a href="https://support.1password.com/export">this guide</a></i></td>
<td align="center"><code>pass import 1password file.csv</code></td>
</tr>
<tr>
<td align="center" rowspan="2"><a href="https://github.com/beemdevelopment/Aegis">aegis</a></td>
<td align="center"><code>json</code></td>
<td align="center"><i>Settings> Tools: Export Plain</i></td>
<td align="center"><code>pass import aegis file.json</code></td>
</tr>
<tr>
<td align="center"><code>json</code></td>
<td align="center"><i>Settings> Tools: Export encrypted</i></td>
<td align="center"><code>pass import aegis file.json</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://github.com/andOTP/andOTP">andotp</a></td>
<td align="center"><code>json</code></td>
<td align="center"><i>Backups> Backup plain</i></td>
<td align="center"><code>pass import andotp file.json</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://support.apple.com/guide/keychain-access">apple-keychain</a></td>
<td align="center"><code>keychain</code></td>
<td align="center"><i>See <a href="https://gist.github.com/santigz/601f4fd2f039d6ceb2198e2f9f4f01e0">this guide</a></i></td>
<td align="center"><code>pass import applekeychain file.txt</code></td>
</tr>
<tr>
<td align="center" rowspan="4"><a href="https://bitwarden.com">bitwarden</a></td>
<td align="center"><code>csv</code></td>
<td align="center"><i>Tools> Export Vault> File Format: .csv</i></td>
<td align="center"><code>pass import bitwarden file.csv</code></td>
</tr>
<tr>
<td align="center"><code>csv</code></td>
<td align="center"><i>Tools> Export Vault> File Format: .csv</i></td>
<td align="center"><code>pass import bitwarden file.csv</code></td>
</tr>
<tr>
<td align="center"><code>json</code></td>
<td align="center"><i>Tools> Export Vault> File Format: .json</i></td>
<td align="center"><code>pass import bitwarden file.json</code></td>
</tr>
<tr>
<td align="center"><code>json</code></td>
<td align="center"><i>Tools> Export Vault> File Format: .json</i></td>
<td align="center"><code>pass import bitwarden file.json</code></td>
</tr>
<tr>
<td align="center" rowspan="2"><a href="https://abine.com">blur</a></td>
<td align="center"><code>json</code></td>
<td align="center"><i>Settings: Export Data: Export Blur Data</i></td>
<td align="center"><code>pass import blur file.json</code></td>
</tr>
<tr>
<td align="center"><code>csv</code></td>
<td align="center"><i>Settings: Export Data: Export CSV: Accounts: Export CSV</i></td>
<td align="center"><code>pass import blur file.csv</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://buttercup.pw">buttercup</a></td>
<td align="center"><code>csv</code></td>
<td align="center"><i>File > Export > Export File to CSV</i></td>
<td align="center"><code>pass import buttercup file.csv</code></td>
</tr>
<tr>
<td align="center" rowspan="2"><a href="https://support.google.com/chrome">chrome</a></td>
<td align="center"><code>csv</code></td>
<td align="center"><i>In chrome://password-manager/settings under 2Export passwordsDownload File</i></td>
<td align="center"><code>pass import chrome file.csv</code></td>
</tr>
<tr>
<td align="center"><code>csv</code></td>
<td align="center"><i>See <a href="https://support.google.com/chrome/answer/95606#see">this guide</a></i></td>
<td align="center"><code>pass import chrome file.csv</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://clipperz.is">clipperz</a></td>
<td align="center"><code>html</code></td>
<td align="center"><i>Settings > Data > Export: HTML + JSON</i></td>
<td align="center"><code>pass import clipperz file.html</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="">csv</a></td>
<td align="center"><code>csv</code></td>
<td align="center"><i>Nothing to do</i></td>
<td align="center"><code>pass import csv file.csv --cols 'url,login,,password'</code></td>
</tr>
<tr>
<td align="center" rowspan="2"><a href="https://www.dashlane.com">dashlane</a></td>
<td align="center"><code>csv</code></td>
<td align="center"><i>File > Export > Unsecured Archive in CSV</i></td>
<td align="center"><code>pass import dashlane file.csv</code></td>
</tr>
<tr>
<td align="center"><code>json</code></td>
<td align="center"><i>File > Export > Unsecured Archive in JSON</i></td>
<td align="center"><code>pass import dashlane file.json</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://spideroak.com/encryptr">encryptr</a></td>
<td align="center"><code>csv</code></td>
<td align="center"><i>Compile from source and follow instructions from <a href="https://github.com/SpiderOak/Encryptr/issues/295#issuecomment-322449705">this guide</a></i></td>
<td align="center"><code>pass import encryptr file.csv</code></td>
</tr>
<tr>
<td align="center" rowspan="2"><a href="https://www.enpass.io">enpass</a></td>
<td align="center"><code>json v6</code></td>
<td align="center"><i>Menu > File > Export > As JSON</i></td>
<td align="center"><code>pass import enpass file.json</code></td>
</tr>
<tr>
<td align="center"><code>csv</code></td>
<td align="center"><i>File > Export > As CSV</i></td>
<td align="center"><code>pass import enpass file.csv</code></td>
</tr>
<tr>
<td align="center" rowspan="2"><a href="https://www.mozilla.org/en-US/firefox/lockwise/">firefox</a></td>
<td align="center"><code>csv</code></td>
<td align="center"><i>In about:logins Menu: Export logins</i></td>
<td align="center"><code>pass import firefox file.csv</code></td>
</tr>
<tr>
<td align="center"><code>csv</code></td>
<td align="center"><i>Add-ons Prefs: Export Passwords: CSV</i></td>
<td align="center"><code>pass import firefox file.csv</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="http://fpm.sourceforge.net">fpm</a></td>
<td align="center"><code>xml</code></td>
<td align="center"><i>File > Export Passwords: Plain XML</i></td>
<td align="center"><code>pass import fpm file.xml</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://github.com/helloworld1/FreeOTPPlus">freeotp+</a></td>
<td align="center"><code>json</code></td>
<td align="center"><i>Settings> Export> Export JSON Format</i></td>
<td align="center"><code>pass import freeotp+ file.json</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://wiki.gnome.org/Projects/GnomeKeyring">gnome</a></td>
<td align="center"><code>libsecret</code></td>
<td align="center"><i>Nothing to do</i></td>
<td align="center"><code>pass import gnome-keyring <label></code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://gitlab.gnome.org/World/Authenticator">gnome-auth</a></td>
<td align="center"><code>json</code></td>
<td align="center"><i>Backup > in a plain-text JSON file</i></td>
<td align="center"><code>pass import gnome-authenticator file.json</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://www.gopass.pw/">gopass</a></td>
<td align="center"><code>gopass</code></td>
<td align="center"><i>Nothing to do</i></td>
<td align="center"><code>pass import gopass path/to/store</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://github.com/zdia/gorilla/wiki">gorilla</a></td>
<td align="center"><code>csv</code></td>
<td align="center"><i>File > Export: Yes: CSV Files</i></td>
<td align="center"><code>pass import gorilla file.csv</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="http://fpm.sourceforge.net">kedpm</a></td>
<td align="center"><code>xml</code></td>
<td align="center"><i>File > Export Passwords: Plain XML</i></td>
<td align="center"><code>pass import kedpm file.xml</code></td>
</tr>
<tr>
<td align="center" rowspan="3"><a href="https://www.keepass.info">keepass</a></td>
<td align="center"><code>kdbx</code></td>
<td align="center"><i>Nothing to do</i></td>
<td align="center"><code>pass import keepass file.kdbx</code></td>
</tr>
<tr>
<td align="center"><code>csv</code></td>
<td align="center"><i>File > Export > Keepass (CSV)</i></td>
<td align="center"><code>pass import keepass file.csv</code></td>
</tr>
<tr>
<td align="center"><code>xml</code></td>
<td align="center"><i>File > Export > Keepass (XML)</i></td>
<td align="center"><code>pass import keepass file.xml</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://www.keepassx.org">keepassx</a></td>
<td align="center"><code>xml</code></td>
<td align="center"><i>File > Export to > Keepass XML File</i></td>
<td align="center"><code>pass import keepassx file.xml</code></td>
</tr>
<tr>
<td align="center" rowspan="2"><a href="https://www.keepassx.org">keepassx2</a></td>
<td align="center"><code>kdbx</code></td>
<td align="center"><i>Nothing to do</i></td>
<td align="center"><code>pass import keepassx2 file.kdbx</code></td>
</tr>
<tr>
<td align="center"><code>csv</code></td>
<td align="center"><i>Database > Export to CSV File</i></td>
<td align="center"><code>pass import keepassx2 file.csv</code></td>
</tr>
<tr>
<td align="center" rowspan="2"><a href="https://keepassxc.org">keepassxc</a></td>
<td align="center"><code>kdbx</code></td>
<td align="center"><i>Nothing to do</i></td>
<td align="center"><code>pass import keepassxc file.kdbx</code></td>
</tr>
<tr>
<td align="center"><code>csv</code></td>
<td align="center"><i>Database > Export to CSV File</i></td>
<td align="center"><code>pass import keepassxc file.csv</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://keepersecurity.com">keeper</a></td>
<td align="center"><code>csv</code></td>
<td align="center"><i>Settings > Export : Export to CSV File</i></td>
<td align="center"><code>pass import keeper file.csv</code></td>
</tr>
<tr>
<td align="center" rowspan="2"><a href="https://www.lastpass.com">lastpass</a></td>
<td align="center"><code>cli</code></td>
<td align="center"><i>Nothing to do</i></td>
<td align="center"><code>pass import lastpass <login></code></td>
</tr>
<tr>
<td align="center"><code>csv</code></td>
<td align="center"><i>More Options > Advanced > Export</i></td>
<td align="center"><code>pass import lastpass file.csv</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://myki.com">myki</a></td>
<td align="center"><code>csv</code></td>
<td align="center"><i>See <a href="https://support.myki.com/myki-app/exporting-your-passwords-from-the-myki-app/how-to-export-your-passwords-account-data-from-myki">this guide</a></i></td>
<td align="center"><code>pass import myki file.csv</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://wiki.gnome.org/Projects/NetworkManager">network-manager</a></td>
<td align="center"><code>nm</code></td>
<td align="center"><i>Also support specific networkmanager dir and ini file</i></td>
<td align="center"><code>pass import networkmanager</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://nordpass.com/">nordpass</a></td>
<td align="center"><code>csv</code></td>
<td align="center"><i>Settings > Export Items</i></td>
<td align="center"><code>pass import nordpass file.csv</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://padloc.app">padlock</a></td>
<td align="center"><code>csv</code></td>
<td align="center"><i>Settings > Export Data and copy text into a .csv file</i></td>
<td align="center"><code>pass import padlock file.csv</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://passwordstore.org">pass</a></td>
<td align="center"><code>pass</code></td>
<td align="center"><i>Nothing to do</i></td>
<td align="center"><code>pass import pass path/to/store</code></td>
</tr>
<tr>
<td align="center" rowspan="2"><a href="https://passman.cc">passman</a></td>
<td align="center"><code>csv</code></td>
<td align="center"><i>Settings > Export credentials > Export type: CSV</i></td>
<td align="center"><code>pass import passman file.csv</code></td>
</tr>
<tr>
<td align="center"><code>json</code></td>
<td align="center"><i>Settings > Export credentials > Export type: JSON</i></td>
<td align="center"><code>pass import passman file.json</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://www.passpack.com">passpack</a></td>
<td align="center"><code>csv</code></td>
<td align="center"><i>Settings > Export > Save to CSV</i></td>
<td align="center"><code>pass import passpack file.csv</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://www.enpass.io">passpie</a></td>
<td align="center"><code>yaml v1.0</code></td>
<td align="center"><i>`passpie export file.yml`</i></td>
<td align="center"><code>pass import passpie file.yml</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://pwsafe.org">pwsafe</a></td>
<td align="center"><code>xml</code></td>
<td align="center"><i>File > Export To > XML Format</i></td>
<td align="center"><code>pass import pwsafe file.xml</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://revelation.olasagasti.info">revelation</a></td>
<td align="center"><code>xml</code></td>
<td align="center"><i>File > Export: XML</i></td>
<td align="center"><code>pass import revelation file.xml</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://www.roboform.com">roboform</a></td>
<td align="center"><code>csv</code></td>
<td align="center"><i>Roboform > Options > Data & Sync > Export To: CSV file</i></td>
<td align="center"><code>pass import roboform file.csv</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://safeincloud.ladesk.com/">safeincloud</a></td>
<td align="center"><code>csv</code></td>
<td align="center"><i>File > Export > Comma-Separated Values (CSV)</i></td>
<td align="center"><code>pass import safeincloud file.csv</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="https://saferpass.net">saferpass</a></td>
<td align="center"><code>csv</code></td>
<td align="center"><i>Settings > Export Data: Export data</i></td>
<td align="center"><code>pass import saferpass file.csv</code></td>
</tr>
<tr>
<td align="center" rowspan="1"><a href="http://upm.sourceforge.net">upm</a></td>
<td align="center"><code>csv</code></td>
<td align="center"><i>Database > Export</i></td>
<td align="center"><code>pass import upm file.csv</code></td>
</tr>
<tr>
<td align="center" rowspan="2"><a href="https://www.zoho.com/vault">zoho</a></td>
<td align="center"><code>csv</code></td>
<td align="center"><i>Tools > Export Secrets: Zoho Vault Format CSV</i></td>
<td align="center"><code>pass import zoho file.csv</code></td>
</tr>
<tr>
<td align="center"><code>csv</code></td>
<td align="center"><i>Tools > Export Secrets: Zoho Vault Format CSV</i></td>
<td align="center"><code>pass import zoho file.csv</code></td>
</tr>
</tbody>
</table>
<!-- LIST END -->
**The following destination password managers are supported:**
<!-- LIST DST BEGIN -->
| **Exporters Password Manager** | **Format** | **Command line** |
|:------------------------------:|:----------:|:----------------:|
| [csv]() | csv | `pimport csv src [src]` |
| [gopass](https://www.gopass.pw/) | gopass | `pimport gopass src [src]` |
| [keepass](https://www.keepass.info) | kdbx | `pimport keepass src [src]` |
| [keepassx2](https://www.keepassx.org) | kdbx | `pimport keepassx2 src [src]` |
| [keepassxc](https://keepassxc.org) | kdbx | `pimport keepassxc src [src]` |
| [lastpass](https://www.lastpass.com) | cli | `pimport lastpass src [src]` |
| [pass](https://passwordstore.org) | pass | `pimport pass src [src]` |
| [sphinx](https://github.com/stef/pwdsphinx/) | | `pimport sphinx src [src]` |
<!-- LIST DST END -->
## Usage
### Basic use
To import password from any supported password manager simply run:
```sh
pass import path/to/passwords
```
If `pass-import` is not able to detect the format, you need to provide the password manager `<pm>` you want to import data from:
```sh
pass import <pm> path/to/passwords
```
If you want to import data to a password manager other than `pass`, run:
```sh
pimport <new_pm> <former_pm> path/to/passwords --out path/to/destination/pm
```
### Help
<!-- USAGE BEGIN -->
```
usage: pass import [-r path] [-p path] [-k KEY] [-a] [-f] [-c] [-C] [-P] [-d] [--sep CHAR] [--del CHAR] [--cols COLS] [--filter FILTER] [--config CONFIG]
[-l] [-h] [-V] [-v | -q]
[src ...]
Import data from most of the password manager. Passwords are imported into
the existing default password store; therefore, the password store must have
been initialised before with 'pass init'.
Password managers:
src Path to the data to import. Can also be the password manager name followed by the path to the data to import. The password manager
name can be: 1password, aegis, andotp, apple-keychain, bitwarden, blur, buttercup, chrome, clipperz, csv, dashlane, encryptr,
enpass, firefox, fpm, freeotp+, gnome, gnome-auth, gopass, gorilla, kedpm, keepass, keepassx, keepassx2, keepassxc, keeper,
lastpass, myki, network-manager, nordpass, padlock, pass, passman, passpack, passpie, pwsafe, revelation, roboform, safeincloud,
saferpass, upm, zoho.
Common optional arguments:
-r path, --root path Only import the password from a specific subfolder.
-p path, --path path Import the passwords to a specific subfolder.
-k KEY, --key KEY Path to a keyfile if required by a manager.
-a, --all Also import all the extra data present.
-f, --force Overwrite existing passwords.
-c, --clean Make the paths more command line friendly.
-C, --convert Convert invalid characters present in the paths.
-P, --pwned Check imported passwords against haveibeenpwned.com.
-d, --dry-run Do not import passwords, only show what would be imported.
Extra optional arguments:
--sep CHAR Provide a characters of replacement for the path separator. Default: '-'
--del CHAR Provide an alternative CSV delimiter character. Default: ','
--cols COLS CSV expected columns to map columns to credential attributes. Only used by the csv importer.
--filter FILTER Export whole entries matching a JSONPath filter expression. Default: (none) This field can be: - a string JSONPath expression - an
absolute path to a file containing a JSONPath filter expression. List of supported filter: https://github.com/h2non/jsonpath-ng
Example: - '$.entries[*].tags[?@="Defaults"]' : Export only entries with a tag matching 'Defaults'
--config CONFIG Set a config file. Default: '.import'
Help related optional arguments:
-l, --list List the supported password managers.
-h, --help Show this help message and exit.
-V, --version Show the program version and exit.
-v, --verbose Set verbosity level, can be used more than once.
-q, --quiet Be quiet.
More information may be found in the pass-import(1) man page.
```
<!-- USAGE END -->
Usage for `pimport` can been seen with `pimport -h` or `man pimport`.
## Examples
**Import password from KeePass**
```
pass import keepass.xml
(*) Importing passwords from keepass to pass
. Passwords imported from: keepass.xml
. Passwords exported to: ~/.password-store
. Number of password imported: 6
. Passwords imported:
Social/mastodon.social
Social/twitter.com
Social/news.ycombinator.com
Servers/ovh.com/bynbyjhqjz
Servers/ovh.com/jsdkyvbwjn
Bank/aib
```
This is the same than: `pimport pass keepass.xml --out ~/.password-store`
**Import password to a different password store**
```
export PASSWORD_STORE_DIR="~/.mypassword-store"
pass init <gpg-id>
pass import keepass.kdbx
```
**Import password to a subfolder**
```
pass import bitwarden.json -p Import/
(*) Importing passwords from bitwarden to pass
. Passwords imported from: bitwarden.json
. Passwords exported to: ~/.password-store
. Root path: Import
. Number of password imported: 6
. Passwords imported:
Import/Social/mastodon.social
Import/Social/twitter.com
Import/Social/news.ycombinator.com
Import/Servers/ovh.com/bynbyjhqjz
Import/Servers/ovh.com/jsdkyvbwjn
Import/Bank/aib
```
**Other examples:**
- If the manager is not correctly detected, you can pass it at source argument:
`pass import dashlane dashlane.csv`
- Import NetworkManager password on default dir: `pass import networkmanager`
- Import a NetworkManager INI file: `pass import nm.ini`
- Import a One password 1PIF: `pass import 1password.1pif`
- Import a One password CSV: `pass import 1password.csv`
- Import a Passman JSON file: `pass import passman.json`
- Import Lastpass file to a keepass db: `pimport keepass lastpass.csv --out keepass.kdbx`
- Import a password store to a CSV file: `pimport csv ~/.password-store --out file.csv`
- Export Bitwarden to SPHINX: pimport sphinx bitwarden.json -o sphinx.cfg
## GPG keyring
Before importing data to pass, your password-store repository must exist and your GPG keyring must be usable. In order words you need to ensure that:
- All the public gpgids are present in the keyring.
- All the public gpgids are trusted enough.
- At least one private key is present in the keyring.
Otherwise, you will get the following error:
`invalid credentials, password encryption/decryption aborted.`
To set the trust on a GPG key, one can run `gpg --edit-key <gpgid>` then `trust`.
## Security consideration
**Direct import**
Passwords should not be written in plain text form on the drive. Therefore, when possible, you should import it directly from the encrypted data. For instance, with an encrypted keepass database:
```sh
pass import keepass file.kdbx
```
**Secure erasure**
Otherwise, if your password manager does not support it, you should take care of securely removing the plain text password database:
```sh
pass import lastpass data.csv
shred -u data.csv
```
**Encrypted file**
Alternatively, pass-import can decrypt gpg encrypted file before importing it. For example:
```sh
pass import lastpass lastpass.csv.gpg
```
**Mandatory Access Control (MAC)**
AppArmor profiles for `pass` and `pass-import` are available in [`apparmor.d`][apparmor.d]. If your distribution support AppArmor, you can clone the [apparmor.d] and run: `make && sudo make install pass pass-import` to only install these apparmor security profiles.
**Network**
pass-import only needs to establish network connection to support cloud based password manager. If you do not use these importers you can ensure pass-import is not using the network by removing the `network` rules in the apparmor profile of pass-import.
**Password Update**
You might also want to update the passwords imported using [`pass-update`][update].
## Configuration file
Some configurations can be read from a configuration file called `.import` if it is present at the root of the password repository. The configuration read from this file will be overwritten by their corresponding command-line option if present.
Example of the `.import` configuration file for the default password repository in `~/.password-store/.import`:
```yaml
---
# Separator string
separator: '-'
# The list of string that should be replaced by other string. Only activated
# if the `clean` option is enabled.
cleans:
' ': '-'
'&': 'and'
'@': At
"'": ''
'[': ''
']': ''
# The list of protocols. To be removed from the title.
protocols:
- http://
- https://
# The list of invalid characters. Replaced by the separator.
invalids:
- '<'
- '>'
- ':'
- '"'
- '/'
- '\\'
- '|'
- '?'
- '*'
- '\0'
```
## Installation [<img src="https://repology.org/badge/vertical-allrepos/pass-import.svg" align="right">][repology-link]
**Requirements**
* `pass 1.7.0` or greater.
* Python 3.8+
* `python3-setuptools` to build and install it.
* `python3-yaml` (`apt install python3-yaml` or `pip3 install pyaml`, or `python3 -m pip install pyaml` if on MacOS running python installed via `brew`)
**Optional Requirements**
| **Dependency** | **Required for** | **apt** | **pip** |
|:--------------:|:----------------:|:-------:|:-------:|
| [pass] | Password Store import/export | `apt install pass` | N/A |
| [lpass] | Lastpass cli based import/export | `apt install lpass` | N/A |
| [defusedxml] | Recommended XML library | `apt install python3-defusedxml` | `pip3 install defusedxml` |
| [pykeepass] | Keepass import from KDBX file | N/A | `pip3 install pykeepass` |
| [secretstorage] | Gnome Keyring import | `apt install python3-secretstorage` | `pip3 install secretstorage` |
| [cryptography] | AndOTP or Aegis encrypted import | `apt install python3-cryptography` | `pip3 install cryptography` |
| [file-magic] | Detection of file decryption | `apt install python-magic` | `pip3 install file-magic` |
| [pwdsphinx] | Export to SPHINX | N/A(coming soon) | `pip3 install pwdsphinx` |
| filter | Filter exports | N/A | `pip3 install jsonpath-ng` |
**ArchLinux**
`pass-import` is available in the [Arch User Repository][aur].
```sh
yay -S pass-import # or your preferred AUR install method
```
**Debian/Ubuntu**
`pass-import` is available under [my own debian repository][repo] with the package name `pass-extension-import`. Both the repository and the package are signed with my GPG key: [`06A26D531D56C42D66805049C5469996F0DF68EC`][keys].
```sh
wget -qO - https://pkg.pujol.io/debian/gpgkey | gpg --dearmor | sudo tee /usr/share/keyrings/pujol.io.gpg >/dev/null
echo 'deb [arch=amd64 signed-by=/usr/share/keyrings/pujol.io.gpg] https://pkg.pujol.io/debian/repo all main' | sudo tee /etc/apt/sources.list.d/pkg.pujol.io.list
sudo apt-get update
sudo apt-get install pass-extension-import
```
**NixOS**
```sh
nix-env -iA nixos.passExtensions.pass-import
```
**Using pip**
```sh
pip install pass-import
```
**From git**
```sh
git clone https://github.com/roddhjav/pass-import/
cd pass-import
python3 setup.py install
```
**Stable version**
```sh
wget https://github.com/roddhjav/pass-import/releases/download/v3.5/pass-import-3.5.tar.gz
tar xzf pass-import-3.5.tar.gz
cd pass-import-3.5
python3 setup.py install
```
[Releases][releases] and commits are signed using [`06A26D531D56C42D66805049C5469996F0DF68EC`][keys].
You should check the key's fingerprint and verify the signature:
```sh
wget https://github.com/roddhjav/pass-import/releases/download/v3.5/pass-import-3.5.tar.gz.asc
gpg --recv-keys 06A26D531D56C42D66805049C5469996F0DF68EC
gpg --verify pass-import-3.5.tar.gz.asc
```
**Local install**
Alternatively, from git or from a stable version you can do a local install with:
```sh
cd pass-import
python3 setup.py install --user
```
> [!IMPORTANT]
> For local install you need to:
>
> 1. Set `PASSWORD_STORE_ENABLE_EXTENSIONS` to `true` for the local extension to be enabled.
> 2. Set `PASSWORD_STORE_EXTENSIONS_DIR` to local the install path of python
>
> Example:
> ```sh
> export PASSWORD_STORE_ENABLE_EXTENSIONS=true
> export PASSWORD_STORE_EXTENSIONS_DIR="$(python -m site --user-site)/usr/lib/password-store/extensions/"
> ```
## The import Library
One can use pass-import as a python library. Simply import the classes of the password manager you want to import and export. Then use them in a context manager. For instance, to import password from a cvs Lastpass exported file to password-store:
```python
from pass_import.managers.lastpass import LastpassCSV
from pass_import.managers.passwordstore import PasswordStore
with LastpassCSV('lastpass-export.csv') as importer:
importer.parse()
with PasswordStore('~/.password-store') as exporter:
exporter.data = importer.data
exporter.clean(True, True)
for entry in exporter.data:
exporter.insert(entry)
```
Alternatively, you can import the same Lastpass file to a Keepass database:
```python
from pass_import.managers.keepass import Keepass
from pass_import.managers.lastpass import LastpassCSV
with LastpassCSV('lastpass-export.csv') as importer:
importer.parse()
with Keepass('keepass.kdbx') as exporter:
exporter.data = importer.data
exporter.clean(True, True)
for entry in exporter.data:
exporter.insert(entry)
```
## Contribution
Feedback, contributors, pull requests are all very welcome. Please read the [`CONTRIBUTING.rst`](CONTRIBUTING.rst) file for more details on the contribution process.
[github-link]: https://github.com/roddhjav/pass-import
[workflow]: https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Froddhjav%2Fpass-import%2Fbadge&style=flat-square
[action]: https://actions-badge.atrox.dev/roddhjav/pass-import/goto
[gitlab]: https://gitlab.com/roddhjav/pass-import/badges/master/pipeline.svg?style=flat-square
[gitlab-link]: https://gitlab.com/roddhjav/pass-import/pipelines
[coverage]: https://gitlab.com/roddhjav/pass-import/badges/master/coverage.svg?style=flat-square
[coverage-link]: https://roddhjav.gitlab.io/pass-import/
[quality]: https://img.shields.io/codacy/grade/783d8cf291434d2b8f1c063b51cfebbb/master.svg?style=flat-square
[quality-link]: https://www.codacy.com/app/roddhjav/pass-import
[release]: https://img.shields.io/github/release/roddhjav/pass-import.svg?maxAge=600&style=flat-square
[release-link]: https://github.com/roddhjav/pass-import/releases/latest
[repology-link]: https://repology.org/project/pass-import/versions
[pass]: https://www.passwordstore.org/
[keys]: https://pujol.io/keys
[repo]: https://pkg.pujol.io
[aur]: https://aur.archlinux.org/packages/pass-import
[releases]: https://github.com/roddhjav/pass-import/releases
[keybase]: https://keybase.io/roddhjav
[update]: https://github.com/roddhjav/pass-update
[browserpass]: https://github.com/browserpass/browserpass-extension
[pass-otp]: https://github.com/tadfisher/pass-otp
[apparmor.d]: https://github.com/roddhjav/apparmor.d
[lpass]: https://github.com/lastpass/lastpass-cli
[defusedxml]: https://github.com/tiran/defusedxml
[pyaml]: https://pyyaml.org/
[pykeepass]: https://github.com/pschmitt/pykeepass
[secretstorage]: https://secretstorage.readthedocs.io/en/latest/
[cryptography]: https://cryptography.io
[file-magic]: https://www.darwinsys.com/file/
[pwdsphinx]: https://github.com/stef/pwdsphinx/
Raw data
{
"_id": null,
"home_page": "https://github.com/roddhjav/pass-import",
"name": "pass-import",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "password-store,password,pass,pass-extension,password-manager,importer",
"author": "Alexandre Pujol",
"author_email": "alexandre@pujol.io",
"download_url": "https://files.pythonhosted.org/packages/f1/69/1d763287f49eb2d43f14280a1af9f6c2aa54a306071a4723a9723a6fb613/pass-import-3.5.tar.gz",
"platform": null,
"description": "[<img src=\"https://gitlab.com/uploads/-/system/project/avatar/2296403/logo.png\" align=\"right\" height=\"110\"/>][github-link]\n\n# pass import\n\n[![][workflow]][action] [![][gitlab]][gitlab-link] [![][coverage]][coverage-link] [![][quality]][quality-link] [![\n][release]][release-link]\n\n**A [pass] extension for importing data from most existing password managers**\n\n\n## Description\n\n`pass import` is a password store extension allowing you to import your password database to a password store repository conveniently. It natively supports import from <!-- NB BEGIN -->62<!-- NB END --> different password managers. More manager support can easily be added.\n\nPasswords are imported into the existing default password store, therefore the password store must have been initialized before with `pass init`.\n\nBy default, pass imports entries at the root of the password store and only keeps the main data (password, login, email, URL, group). This behaviour can be changed using the provided options.\n\nPass import handles duplicates and is compatible with [browserpass]. It imports OTP secret in a way that is compatible with [pass-otp].\n\npass-import also provides a `pimport` script that allows importing passwords to other password managers. For instance, you can import passwords from Lastpass to a Keepass database. It currently supports password export from <!-- NB DST BEGIN -->8<!-- NB DST END --> managers.\n\n**The following password managers are supported:**\n\n<!-- LIST BEGIN -->\n<!-- Do not edit manually, use 'make doc' instead. -->\n<table>\n <thead>\n <th align=\"center\">Password Manager</th>\n <th align=\"center\">Formats</th>\n <th align=\"center\">How to export Data</th>\n <th align=\"center\">Command line</th>\n </thead>\n <tbody>\n <tr>\n <td align=\"center\" rowspan=\"4\"><a href=\"https://1password.com\">1password</a></td>\n <td align=\"center\"><code>csv v8</code></td>\n <td align=\"center\"><i>See <a href=\"https://support.1password.com/export\">this guide</a></i></td>\n <td align=\"center\"><code>pass import 1password file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\"><code>1pif v4</code></td>\n <td align=\"center\"><i>See <a href=\"https://support.1password.com/export\">this guide</a></i></td>\n <td align=\"center\"><code>pass import 1password file.1pif</code></td>\n </tr>\n <tr>\n <td align=\"center\"><code>csv v4</code></td>\n <td align=\"center\"><i>See <a href=\"https://support.1password.com/export\">this guide</a></i></td>\n <td align=\"center\"><code>pass import 1password file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\"><code>csv v6</code></td>\n <td align=\"center\"><i>See <a href=\"https://support.1password.com/export\">this guide</a></i></td>\n <td align=\"center\"><code>pass import 1password file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"2\"><a href=\"https://github.com/beemdevelopment/Aegis\">aegis</a></td>\n <td align=\"center\"><code>json</code></td>\n <td align=\"center\"><i>Settings> Tools: Export Plain</i></td>\n <td align=\"center\"><code>pass import aegis file.json</code></td>\n </tr>\n <tr>\n <td align=\"center\"><code>json</code></td>\n <td align=\"center\"><i>Settings> Tools: Export encrypted</i></td>\n <td align=\"center\"><code>pass import aegis file.json</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://github.com/andOTP/andOTP\">andotp</a></td>\n <td align=\"center\"><code>json</code></td>\n <td align=\"center\"><i>Backups> Backup plain</i></td>\n <td align=\"center\"><code>pass import andotp file.json</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://support.apple.com/guide/keychain-access\">apple-keychain</a></td>\n <td align=\"center\"><code>keychain</code></td>\n <td align=\"center\"><i>See <a href=\"https://gist.github.com/santigz/601f4fd2f039d6ceb2198e2f9f4f01e0\">this guide</a></i></td>\n <td align=\"center\"><code>pass import applekeychain file.txt</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"4\"><a href=\"https://bitwarden.com\">bitwarden</a></td>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>Tools> Export Vault> File Format: .csv</i></td>\n <td align=\"center\"><code>pass import bitwarden file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>Tools> Export Vault> File Format: .csv</i></td>\n <td align=\"center\"><code>pass import bitwarden file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\"><code>json</code></td>\n <td align=\"center\"><i>Tools> Export Vault> File Format: .json</i></td>\n <td align=\"center\"><code>pass import bitwarden file.json</code></td>\n </tr>\n <tr>\n <td align=\"center\"><code>json</code></td>\n <td align=\"center\"><i>Tools> Export Vault> File Format: .json</i></td>\n <td align=\"center\"><code>pass import bitwarden file.json</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"2\"><a href=\"https://abine.com\">blur</a></td>\n <td align=\"center\"><code>json</code></td>\n <td align=\"center\"><i>Settings: Export Data: Export Blur Data</i></td>\n <td align=\"center\"><code>pass import blur file.json</code></td>\n </tr>\n <tr>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>Settings: Export Data: Export CSV: Accounts: Export CSV</i></td>\n <td align=\"center\"><code>pass import blur file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://buttercup.pw\">buttercup</a></td>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>File > Export > Export File to CSV</i></td>\n <td align=\"center\"><code>pass import buttercup file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"2\"><a href=\"https://support.google.com/chrome\">chrome</a></td>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>In chrome://password-manager/settings under 2Export passwordsDownload File</i></td>\n <td align=\"center\"><code>pass import chrome file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>See <a href=\"https://support.google.com/chrome/answer/95606#see\">this guide</a></i></td>\n <td align=\"center\"><code>pass import chrome file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://clipperz.is\">clipperz</a></td>\n <td align=\"center\"><code>html</code></td>\n <td align=\"center\"><i>Settings > Data > Export: HTML + JSON</i></td>\n <td align=\"center\"><code>pass import clipperz file.html</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"\">csv</a></td>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>Nothing to do</i></td>\n <td align=\"center\"><code>pass import csv file.csv --cols 'url,login,,password'</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"2\"><a href=\"https://www.dashlane.com\">dashlane</a></td>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>File > Export > Unsecured Archive in CSV</i></td>\n <td align=\"center\"><code>pass import dashlane file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\"><code>json</code></td>\n <td align=\"center\"><i>File > Export > Unsecured Archive in JSON</i></td>\n <td align=\"center\"><code>pass import dashlane file.json</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://spideroak.com/encryptr\">encryptr</a></td>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>Compile from source and follow instructions from <a href=\"https://github.com/SpiderOak/Encryptr/issues/295#issuecomment-322449705\">this guide</a></i></td>\n <td align=\"center\"><code>pass import encryptr file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"2\"><a href=\"https://www.enpass.io\">enpass</a></td>\n <td align=\"center\"><code>json v6</code></td>\n <td align=\"center\"><i>Menu > File > Export > As JSON</i></td>\n <td align=\"center\"><code>pass import enpass file.json</code></td>\n </tr>\n <tr>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>File > Export > As CSV</i></td>\n <td align=\"center\"><code>pass import enpass file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"2\"><a href=\"https://www.mozilla.org/en-US/firefox/lockwise/\">firefox</a></td>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>In about:logins Menu: Export logins</i></td>\n <td align=\"center\"><code>pass import firefox file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>Add-ons Prefs: Export Passwords: CSV</i></td>\n <td align=\"center\"><code>pass import firefox file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"http://fpm.sourceforge.net\">fpm</a></td>\n <td align=\"center\"><code>xml</code></td>\n <td align=\"center\"><i>File > Export Passwords: Plain XML</i></td>\n <td align=\"center\"><code>pass import fpm file.xml</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://github.com/helloworld1/FreeOTPPlus\">freeotp+</a></td>\n <td align=\"center\"><code>json</code></td>\n <td align=\"center\"><i>Settings> Export> Export JSON Format</i></td>\n <td align=\"center\"><code>pass import freeotp+ file.json</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://wiki.gnome.org/Projects/GnomeKeyring\">gnome</a></td>\n <td align=\"center\"><code>libsecret</code></td>\n <td align=\"center\"><i>Nothing to do</i></td>\n <td align=\"center\"><code>pass import gnome-keyring <label></code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://gitlab.gnome.org/World/Authenticator\">gnome-auth</a></td>\n <td align=\"center\"><code>json</code></td>\n <td align=\"center\"><i>Backup > in a plain-text JSON file</i></td>\n <td align=\"center\"><code>pass import gnome-authenticator file.json</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://www.gopass.pw/\">gopass</a></td>\n <td align=\"center\"><code>gopass</code></td>\n <td align=\"center\"><i>Nothing to do</i></td>\n <td align=\"center\"><code>pass import gopass path/to/store</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://github.com/zdia/gorilla/wiki\">gorilla</a></td>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>File > Export: Yes: CSV Files</i></td>\n <td align=\"center\"><code>pass import gorilla file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"http://fpm.sourceforge.net\">kedpm</a></td>\n <td align=\"center\"><code>xml</code></td>\n <td align=\"center\"><i>File > Export Passwords: Plain XML</i></td>\n <td align=\"center\"><code>pass import kedpm file.xml</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"3\"><a href=\"https://www.keepass.info\">keepass</a></td>\n <td align=\"center\"><code>kdbx</code></td>\n <td align=\"center\"><i>Nothing to do</i></td>\n <td align=\"center\"><code>pass import keepass file.kdbx</code></td>\n </tr>\n <tr>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>File > Export > Keepass (CSV)</i></td>\n <td align=\"center\"><code>pass import keepass file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\"><code>xml</code></td>\n <td align=\"center\"><i>File > Export > Keepass (XML)</i></td>\n <td align=\"center\"><code>pass import keepass file.xml</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://www.keepassx.org\">keepassx</a></td>\n <td align=\"center\"><code>xml</code></td>\n <td align=\"center\"><i>File > Export to > Keepass XML File</i></td>\n <td align=\"center\"><code>pass import keepassx file.xml</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"2\"><a href=\"https://www.keepassx.org\">keepassx2</a></td>\n <td align=\"center\"><code>kdbx</code></td>\n <td align=\"center\"><i>Nothing to do</i></td>\n <td align=\"center\"><code>pass import keepassx2 file.kdbx</code></td>\n </tr>\n <tr>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>Database > Export to CSV File</i></td>\n <td align=\"center\"><code>pass import keepassx2 file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"2\"><a href=\"https://keepassxc.org\">keepassxc</a></td>\n <td align=\"center\"><code>kdbx</code></td>\n <td align=\"center\"><i>Nothing to do</i></td>\n <td align=\"center\"><code>pass import keepassxc file.kdbx</code></td>\n </tr>\n <tr>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>Database > Export to CSV File</i></td>\n <td align=\"center\"><code>pass import keepassxc file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://keepersecurity.com\">keeper</a></td>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>Settings > Export : Export to CSV File</i></td>\n <td align=\"center\"><code>pass import keeper file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"2\"><a href=\"https://www.lastpass.com\">lastpass</a></td>\n <td align=\"center\"><code>cli</code></td>\n <td align=\"center\"><i>Nothing to do</i></td>\n <td align=\"center\"><code>pass import lastpass <login></code></td>\n </tr>\n <tr>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>More Options > Advanced > Export</i></td>\n <td align=\"center\"><code>pass import lastpass file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://myki.com\">myki</a></td>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>See <a href=\"https://support.myki.com/myki-app/exporting-your-passwords-from-the-myki-app/how-to-export-your-passwords-account-data-from-myki\">this guide</a></i></td>\n <td align=\"center\"><code>pass import myki file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://wiki.gnome.org/Projects/NetworkManager\">network-manager</a></td>\n <td align=\"center\"><code>nm</code></td>\n <td align=\"center\"><i>Also support specific networkmanager dir and ini file</i></td>\n <td align=\"center\"><code>pass import networkmanager</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://nordpass.com/\">nordpass</a></td>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>Settings > Export Items</i></td>\n <td align=\"center\"><code>pass import nordpass file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://padloc.app\">padlock</a></td>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>Settings > Export Data and copy text into a .csv file</i></td>\n <td align=\"center\"><code>pass import padlock file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://passwordstore.org\">pass</a></td>\n <td align=\"center\"><code>pass</code></td>\n <td align=\"center\"><i>Nothing to do</i></td>\n <td align=\"center\"><code>pass import pass path/to/store</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"2\"><a href=\"https://passman.cc\">passman</a></td>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>Settings > Export credentials > Export type: CSV</i></td>\n <td align=\"center\"><code>pass import passman file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\"><code>json</code></td>\n <td align=\"center\"><i>Settings > Export credentials > Export type: JSON</i></td>\n <td align=\"center\"><code>pass import passman file.json</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://www.passpack.com\">passpack</a></td>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>Settings > Export > Save to CSV</i></td>\n <td align=\"center\"><code>pass import passpack file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://www.enpass.io\">passpie</a></td>\n <td align=\"center\"><code>yaml v1.0</code></td>\n <td align=\"center\"><i>`passpie export file.yml`</i></td>\n <td align=\"center\"><code>pass import passpie file.yml</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://pwsafe.org\">pwsafe</a></td>\n <td align=\"center\"><code>xml</code></td>\n <td align=\"center\"><i>File > Export To > XML Format</i></td>\n <td align=\"center\"><code>pass import pwsafe file.xml</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://revelation.olasagasti.info\">revelation</a></td>\n <td align=\"center\"><code>xml</code></td>\n <td align=\"center\"><i>File > Export: XML</i></td>\n <td align=\"center\"><code>pass import revelation file.xml</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://www.roboform.com\">roboform</a></td>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>Roboform > Options > Data & Sync > Export To: CSV file</i></td>\n <td align=\"center\"><code>pass import roboform file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://safeincloud.ladesk.com/\">safeincloud</a></td>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>File > Export > Comma-Separated Values (CSV)</i></td>\n <td align=\"center\"><code>pass import safeincloud file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"https://saferpass.net\">saferpass</a></td>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>Settings > Export Data: Export data</i></td>\n <td align=\"center\"><code>pass import saferpass file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"1\"><a href=\"http://upm.sourceforge.net\">upm</a></td>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>Database > Export</i></td>\n <td align=\"center\"><code>pass import upm file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\" rowspan=\"2\"><a href=\"https://www.zoho.com/vault\">zoho</a></td>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>Tools > Export Secrets: Zoho Vault Format CSV</i></td>\n <td align=\"center\"><code>pass import zoho file.csv</code></td>\n </tr>\n <tr>\n <td align=\"center\"><code>csv</code></td>\n <td align=\"center\"><i>Tools > Export Secrets: Zoho Vault Format CSV</i></td>\n <td align=\"center\"><code>pass import zoho file.csv</code></td>\n </tr>\n </tbody>\n</table>\n<!-- LIST END -->\n\n\n**The following destination password managers are supported:**\n\n<!-- LIST DST BEGIN -->\n| **Exporters Password Manager** | **Format** | **Command line** |\n|:------------------------------:|:----------:|:----------------:|\n| [csv]() | csv | `pimport csv src [src]` |\n| [gopass](https://www.gopass.pw/) | gopass | `pimport gopass src [src]` |\n| [keepass](https://www.keepass.info) | kdbx | `pimport keepass src [src]` |\n| [keepassx2](https://www.keepassx.org) | kdbx | `pimport keepassx2 src [src]` |\n| [keepassxc](https://keepassxc.org) | kdbx | `pimport keepassxc src [src]` |\n| [lastpass](https://www.lastpass.com) | cli | `pimport lastpass src [src]` |\n| [pass](https://passwordstore.org) | pass | `pimport pass src [src]` |\n| [sphinx](https://github.com/stef/pwdsphinx/) | | `pimport sphinx src [src]` |\n\n<!-- LIST DST END -->\n\n## Usage\n\n### Basic use\nTo import password from any supported password manager simply run:\n```sh\npass import path/to/passwords\n```\n\nIf `pass-import` is not able to detect the format, you need to provide the password manager `<pm>` you want to import data from:\n```sh\npass import <pm> path/to/passwords\n```\n\nIf you want to import data to a password manager other than `pass`, run:\n```sh\npimport <new_pm> <former_pm> path/to/passwords --out path/to/destination/pm\n```\n\n### Help\n<!-- USAGE BEGIN -->\n```\nusage: pass import [-r path] [-p path] [-k KEY] [-a] [-f] [-c] [-C] [-P] [-d] [--sep CHAR] [--del CHAR] [--cols COLS] [--filter FILTER] [--config CONFIG]\n [-l] [-h] [-V] [-v | -q]\n [src ...]\n\n Import data from most of the password manager. Passwords are imported into\n the existing default password store; therefore, the password store must have\n been initialised before with 'pass init'.\n\nPassword managers:\n src Path to the data to import. Can also be the password manager name followed by the path to the data to import. The password manager\n name can be: 1password, aegis, andotp, apple-keychain, bitwarden, blur, buttercup, chrome, clipperz, csv, dashlane, encryptr,\n enpass, firefox, fpm, freeotp+, gnome, gnome-auth, gopass, gorilla, kedpm, keepass, keepassx, keepassx2, keepassxc, keeper,\n lastpass, myki, network-manager, nordpass, padlock, pass, passman, passpack, passpie, pwsafe, revelation, roboform, safeincloud,\n saferpass, upm, zoho.\n\nCommon optional arguments:\n -r path, --root path Only import the password from a specific subfolder.\n -p path, --path path Import the passwords to a specific subfolder.\n -k KEY, --key KEY Path to a keyfile if required by a manager.\n -a, --all Also import all the extra data present.\n -f, --force Overwrite existing passwords.\n -c, --clean Make the paths more command line friendly.\n -C, --convert Convert invalid characters present in the paths.\n -P, --pwned Check imported passwords against haveibeenpwned.com.\n -d, --dry-run Do not import passwords, only show what would be imported.\n\nExtra optional arguments:\n --sep CHAR Provide a characters of replacement for the path separator. Default: '-'\n --del CHAR Provide an alternative CSV delimiter character. Default: ','\n --cols COLS CSV expected columns to map columns to credential attributes. Only used by the csv importer.\n --filter FILTER Export whole entries matching a JSONPath filter expression. Default: (none) This field can be: - a string JSONPath expression - an\n absolute path to a file containing a JSONPath filter expression. List of supported filter: https://github.com/h2non/jsonpath-ng\n Example: - '$.entries[*].tags[?@=\"Defaults\"]' : Export only entries with a tag matching 'Defaults'\n --config CONFIG Set a config file. Default: '.import'\n\nHelp related optional arguments:\n -l, --list List the supported password managers.\n -h, --help Show this help message and exit.\n -V, --version Show the program version and exit.\n -v, --verbose Set verbosity level, can be used more than once.\n -q, --quiet Be quiet.\n\nMore information may be found in the pass-import(1) man page.\n```\n<!-- USAGE END -->\n\nUsage for `pimport` can been seen with `pimport -h` or `man pimport`.\n\n## Examples\n\n**Import password from KeePass**\n```\npass import keepass.xml\n(*) Importing passwords from keepass to pass\n . Passwords imported from: keepass.xml\n . Passwords exported to: ~/.password-store\n . Number of password imported: 6\n . Passwords imported:\n Social/mastodon.social\n Social/twitter.com\n Social/news.ycombinator.com\n Servers/ovh.com/bynbyjhqjz\n Servers/ovh.com/jsdkyvbwjn\n Bank/aib\n```\n\nThis is the same than: `pimport pass keepass.xml --out ~/.password-store`\n\n**Import password to a different password store**\n```\nexport PASSWORD_STORE_DIR=\"~/.mypassword-store\"\npass init <gpg-id>\npass import keepass.kdbx\n```\n\n**Import password to a subfolder**\n```\npass import bitwarden.json -p Import/\n(*) Importing passwords from bitwarden to pass\n . Passwords imported from: bitwarden.json\n . Passwords exported to: ~/.password-store\n . Root path: Import\n . Number of password imported: 6\n . Passwords imported:\n Import/Social/mastodon.social\n Import/Social/twitter.com\n Import/Social/news.ycombinator.com\n Import/Servers/ovh.com/bynbyjhqjz\n Import/Servers/ovh.com/jsdkyvbwjn\n Import/Bank/aib\n```\n\n**Other examples:**\n- If the manager is not correctly detected, you can pass it at source argument:\n `pass import dashlane dashlane.csv`\n- Import NetworkManager password on default dir: `pass import networkmanager`\n- Import a NetworkManager INI file: `pass import nm.ini`\n- Import a One password 1PIF: `pass import 1password.1pif`\n- Import a One password CSV: `pass import 1password.csv`\n- Import a Passman JSON file: `pass import passman.json`\n- Import Lastpass file to a keepass db: `pimport keepass lastpass.csv --out keepass.kdbx`\n- Import a password store to a CSV file: `pimport csv ~/.password-store --out file.csv`\n- Export Bitwarden to SPHINX: pimport sphinx bitwarden.json -o sphinx.cfg\n\n## GPG keyring\n\nBefore importing data to pass, your password-store repository must exist and your GPG keyring must be usable. In order words you need to ensure that:\n- All the public gpgids are present in the keyring.\n- All the public gpgids are trusted enough.\n- At least one private key is present in the keyring.\n\nOtherwise, you will get the following error:\n`invalid credentials, password encryption/decryption aborted.`\n\nTo set the trust on a GPG key, one can run `gpg --edit-key <gpgid>` then `trust`.\n\n\n## Security consideration\n\n**Direct import**\n\nPasswords should not be written in plain text form on the drive. Therefore, when possible, you should import it directly from the encrypted data. For instance, with an encrypted keepass database:\n```sh\npass import keepass file.kdbx\n```\n\n**Secure erasure**\n\nOtherwise, if your password manager does not support it, you should take care of securely removing the plain text password database:\n```sh\npass import lastpass data.csv\nshred -u data.csv\n```\n\n**Encrypted file**\n\nAlternatively, pass-import can decrypt gpg encrypted file before importing it. For example:\n```sh\npass import lastpass lastpass.csv.gpg\n```\n\n**Mandatory Access Control (MAC)**\n\nAppArmor profiles for `pass` and `pass-import` are available in [`apparmor.d`][apparmor.d]. If your distribution support AppArmor, you can clone the [apparmor.d] and run: `make && sudo make install pass pass-import` to only install these apparmor security profiles.\n\n**Network**\n\npass-import only needs to establish network connection to support cloud based password manager. If you do not use these importers you can ensure pass-import is not using the network by removing the `network` rules in the apparmor profile of pass-import.\n\n**Password Update**\n\nYou might also want to update the passwords imported using [`pass-update`][update].\n\n\n## Configuration file\n\nSome configurations can be read from a configuration file called `.import` if it is present at the root of the password repository. The configuration read from this file will be overwritten by their corresponding command-line option if present.\n\nExample of the `.import` configuration file for the default password repository in `~/.password-store/.import`:\n```yaml\n---\n\n# Separator string\nseparator: '-'\n\n# The list of string that should be replaced by other string. Only activated\n# if the `clean` option is enabled.\ncleans:\n ' ': '-'\n '&': 'and'\n '@': At\n \"'\": ''\n '[': ''\n ']': ''\n\n# The list of protocols. To be removed from the title.\nprotocols:\n - http://\n - https://\n\n# The list of invalid characters. Replaced by the separator.\ninvalids:\n - '<'\n - '>'\n - ':'\n - '\"'\n - '/'\n - '\\\\'\n - '|'\n - '?'\n - '*'\n - '\\0'\n```\n\n\n## Installation [<img src=\"https://repology.org/badge/vertical-allrepos/pass-import.svg\" align=\"right\">][repology-link]\n\n**Requirements**\n* `pass 1.7.0` or greater.\n* Python 3.8+\n* `python3-setuptools` to build and install it.\n* `python3-yaml` (`apt install python3-yaml` or `pip3 install pyaml`, or `python3 -m pip install pyaml` if on MacOS running python installed via `brew`)\n\n**Optional Requirements**\n\n| **Dependency** | **Required for** | **apt** | **pip** |\n|:--------------:|:----------------:|:-------:|:-------:|\n| [pass] | Password Store import/export | `apt install pass` | N/A |\n| [lpass] | Lastpass cli based import/export | `apt install lpass` | N/A |\n| [defusedxml] | Recommended XML library | `apt install python3-defusedxml` | `pip3 install defusedxml` |\n| [pykeepass] | Keepass import from KDBX file | N/A | `pip3 install pykeepass` |\n| [secretstorage] | Gnome Keyring import | `apt install python3-secretstorage` | `pip3 install secretstorage` |\n| [cryptography] | AndOTP or Aegis encrypted import | `apt install python3-cryptography` | `pip3 install cryptography` |\n| [file-magic] | Detection of file decryption | `apt install python-magic` | `pip3 install file-magic` |\n| [pwdsphinx] | Export to SPHINX | N/A(coming soon) | `pip3 install pwdsphinx` |\n| filter | Filter exports | N/A | `pip3 install jsonpath-ng` |\n\n**ArchLinux**\n\n`pass-import` is available in the [Arch User Repository][aur].\n```sh\nyay -S pass-import # or your preferred AUR install method\n```\n\n**Debian/Ubuntu**\n\n`pass-import` is available under [my own debian repository][repo] with the package name `pass-extension-import`. Both the repository and the package are signed with my GPG key: [`06A26D531D56C42D66805049C5469996F0DF68EC`][keys].\n```sh\nwget -qO - https://pkg.pujol.io/debian/gpgkey | gpg --dearmor | sudo tee /usr/share/keyrings/pujol.io.gpg >/dev/null\necho 'deb [arch=amd64 signed-by=/usr/share/keyrings/pujol.io.gpg] https://pkg.pujol.io/debian/repo all main' | sudo tee /etc/apt/sources.list.d/pkg.pujol.io.list\nsudo apt-get update\nsudo apt-get install pass-extension-import\n```\n\n**NixOS**\n```sh\nnix-env -iA nixos.passExtensions.pass-import\n```\n\n**Using pip**\n```sh\npip install pass-import\n```\n\n**From git**\n```sh\ngit clone https://github.com/roddhjav/pass-import/\ncd pass-import\npython3 setup.py install\n```\n\n**Stable version**\n```sh\nwget https://github.com/roddhjav/pass-import/releases/download/v3.5/pass-import-3.5.tar.gz\ntar xzf pass-import-3.5.tar.gz\ncd pass-import-3.5\npython3 setup.py install\n```\n\n[Releases][releases] and commits are signed using [`06A26D531D56C42D66805049C5469996F0DF68EC`][keys].\nYou should check the key's fingerprint and verify the signature:\n```sh\nwget https://github.com/roddhjav/pass-import/releases/download/v3.5/pass-import-3.5.tar.gz.asc\ngpg --recv-keys 06A26D531D56C42D66805049C5469996F0DF68EC\ngpg --verify pass-import-3.5.tar.gz.asc\n```\n\n**Local install**\n\nAlternatively, from git or from a stable version you can do a local install with:\n```sh\ncd pass-import\npython3 setup.py install --user\n```\n\n> [!IMPORTANT] \n> For local install you need to:\n>\n> 1. Set `PASSWORD_STORE_ENABLE_EXTENSIONS` to `true` for the local extension to be enabled.\n> 2. Set `PASSWORD_STORE_EXTENSIONS_DIR` to local the install path of python\n>\n> Example:\n> ```sh\n> export PASSWORD_STORE_ENABLE_EXTENSIONS=true\n> export PASSWORD_STORE_EXTENSIONS_DIR=\"$(python -m site --user-site)/usr/lib/password-store/extensions/\"\n> ```\n\n## The import Library\n\nOne can use pass-import as a python library. Simply import the classes of the password manager you want to import and export. Then use them in a context manager. For instance, to import password from a cvs Lastpass exported file to password-store:\n\n```python\nfrom pass_import.managers.lastpass import LastpassCSV\nfrom pass_import.managers.passwordstore import PasswordStore\n\nwith LastpassCSV('lastpass-export.csv') as importer:\n importer.parse()\n\n with PasswordStore('~/.password-store') as exporter:\n exporter.data = importer.data\n exporter.clean(True, True)\n for entry in exporter.data:\n exporter.insert(entry)\n```\n\nAlternatively, you can import the same Lastpass file to a Keepass database:\n\n```python\nfrom pass_import.managers.keepass import Keepass\nfrom pass_import.managers.lastpass import LastpassCSV\n\nwith LastpassCSV('lastpass-export.csv') as importer:\n importer.parse()\n\n with Keepass('keepass.kdbx') as exporter:\n exporter.data = importer.data\n exporter.clean(True, True)\n for entry in exporter.data:\n exporter.insert(entry)\n```\n\n\n## Contribution\n\nFeedback, contributors, pull requests are all very welcome. Please read the [`CONTRIBUTING.rst`](CONTRIBUTING.rst) file for more details on the contribution process.\n\n\n[github-link]: https://github.com/roddhjav/pass-import\n[workflow]: https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Froddhjav%2Fpass-import%2Fbadge&style=flat-square\n[action]: https://actions-badge.atrox.dev/roddhjav/pass-import/goto\n[gitlab]: https://gitlab.com/roddhjav/pass-import/badges/master/pipeline.svg?style=flat-square\n[gitlab-link]: https://gitlab.com/roddhjav/pass-import/pipelines\n[coverage]: https://gitlab.com/roddhjav/pass-import/badges/master/coverage.svg?style=flat-square\n[coverage-link]: https://roddhjav.gitlab.io/pass-import/\n[quality]: https://img.shields.io/codacy/grade/783d8cf291434d2b8f1c063b51cfebbb/master.svg?style=flat-square\n[quality-link]: https://www.codacy.com/app/roddhjav/pass-import\n[release]: https://img.shields.io/github/release/roddhjav/pass-import.svg?maxAge=600&style=flat-square\n[release-link]: https://github.com/roddhjav/pass-import/releases/latest\n[repology-link]: https://repology.org/project/pass-import/versions\n\n[pass]: https://www.passwordstore.org/\n[keys]: https://pujol.io/keys\n[repo]: https://pkg.pujol.io\n[aur]: https://aur.archlinux.org/packages/pass-import\n[releases]: https://github.com/roddhjav/pass-import/releases\n[keybase]: https://keybase.io/roddhjav\n[update]: https://github.com/roddhjav/pass-update\n[browserpass]: https://github.com/browserpass/browserpass-extension\n[pass-otp]: https://github.com/tadfisher/pass-otp\n[apparmor.d]: https://github.com/roddhjav/apparmor.d\n\n[lpass]: https://github.com/lastpass/lastpass-cli\n[defusedxml]: https://github.com/tiran/defusedxml\n[pyaml]: https://pyyaml.org/\n[pykeepass]: https://github.com/pschmitt/pykeepass\n[secretstorage]: https://secretstorage.readthedocs.io/en/latest/\n[cryptography]: https://cryptography.io\n[file-magic]: https://www.darwinsys.com/file/\n[pwdsphinx]: https://github.com/stef/pwdsphinx/\n",
"bugtrack_url": null,
"license": "GPL3",
"summary": "A pass extension for importing data from most of the existing password manager.",
"version": "3.5",
"project_urls": {
"Changelog": "https://github.com/roddhjav/pass-import/blob/master/CHANGELOG.md",
"Documentation": "https://github.com/roddhjav/pass-import",
"Homepage": "https://github.com/roddhjav/pass-import",
"Issues": "https://github.com/roddhjav/pass-import/issues",
"Source": "https://github.com/roddhjav/pass-import"
},
"split_keywords": [
"password-store",
"password",
"pass",
"pass-extension",
"password-manager",
"importer"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "03f94ace612611243865bc4f9a87634296431a91b10063bcd5f0d1df4d4eab4c",
"md5": "b45bd086f385e1654502684238bd40c4",
"sha256": "f08bdbf07552febfa9ffaba8d0ae581af20612439f1aa882fa3eee1b3f04b117"
},
"downloads": -1,
"filename": "pass_import-3.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b45bd086f385e1654502684238bd40c4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 113731,
"upload_time": "2024-02-25T13:29:46",
"upload_time_iso_8601": "2024-02-25T13:29:46.423131Z",
"url": "https://files.pythonhosted.org/packages/03/f9/4ace612611243865bc4f9a87634296431a91b10063bcd5f0d1df4d4eab4c/pass_import-3.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f1691d763287f49eb2d43f14280a1af9f6c2aa54a306071a4723a9723a6fb613",
"md5": "01fb72094f6cf225891d6d14e2a000aa",
"sha256": "e3e5ec38f58511904a82214f8a80780729dfe84628d7c5d6b1cedee20ff3fb23"
},
"downloads": -1,
"filename": "pass-import-3.5.tar.gz",
"has_sig": false,
"md5_digest": "01fb72094f6cf225891d6d14e2a000aa",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 96178,
"upload_time": "2024-02-25T13:29:48",
"upload_time_iso_8601": "2024-02-25T13:29:48.958200Z",
"url": "https://files.pythonhosted.org/packages/f1/69/1d763287f49eb2d43f14280a1af9f6c2aa54a306071a4723a9723a6fb613/pass-import-3.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-25 13:29:48",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "roddhjav",
"github_project": "pass-import",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "pass-import"
}
JSON
