{"id":14128562,"url":"https://github.com/louisabraham/ffpass","last_synced_at":"2025-08-03T23:31:31.430Z","repository":{"id":46174535,"uuid":"144259191","full_name":"louisabraham/ffpass","owner":"louisabraham","description":"Import and Export passwords for Firefox Quantum 🔑","archived":false,"fork":false,"pushed_at":"2021-11-09T15:06:14.000Z","size":57,"stargazers_count":380,"open_issues_count":10,"forks_count":39,"subscribers_count":15,"default_branch":"master","last_synced_at":"2024-11-29T11:02:04.711Z","etag":null,"topics":["browser","firefox","firefox-browser","firefox-quantum","password-manager"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/louisabraham.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-08-10T08:26:58.000Z","updated_at":"2024-10-03T10:45:33.000Z","dependencies_parsed_at":"2022-08-12T12:40:54.582Z","dependency_job_id":null,"html_url":"https://github.com/louisabraham/ffpass","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/louisabraham%2Fffpass","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/louisabraham%2Fffpass/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/louisabraham%2Fffpass/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/louisabraham%2Fffpass/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/louisabraham","download_url":"https://codeload.github.com/louisabraham/ffpass/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228571844,"owners_count":17938772,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["browser","firefox","firefox-browser","firefox-quantum","password-manager"],"created_at":"2024-08-15T16:01:50.601Z","updated_at":"2024-12-07T06:31:25.699Z","avatar_url":"https://github.com/louisabraham.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"[![PyPI\nversion](https://badge.fury.io/py/ffpass.svg)](https://badge.fury.io/py/ffpass)\n[![Downloads](https://pepy.tech/badge/ffpass)](https://pepy.tech/project/ffpass)\n\n# ffpass - Import and Export passwords for Firefox Quantum\n\nThe latest version of Firefox doesn't allow to import or export the\nstored logins and passwords as a file.\n\nThis tools interacts with the encrypted password database of Firefox to\nprovide these features.\n\n## Installation\n\nffpass requires Python 3.6+ and will work with Firefox 58+\n\n``` bash\npip install ffpass\n```\n\n## Features\n\n  - Supports master passwords\n  - Automatic profile selection for Linux, macOS and Windows\n  - Export to CSV\n  - Import from CSV compatible with Google Chrome\n\n\u003e Note: Firefox must be closed during the whole process, as these\n\u003e actions change its database. \n\u003e\n\u003e Note: If you have Sync enabled, you'll have to disconnect and\n\u003e reconnect your Firefox account after importing the passwords.\n\n## Export to CSV\n\n``` bash\nffpass export \u003e passwords.csv\nffpass export -f passwords.csv\nffpass export --file passwords.csv\n```\n\n### Usage\n\n    usage: ffpass export [-h] [-t TO_FILE] [-d DIRECTORY] [-v]\n    \n    outputs a CSV with header `url,username,password`\n    \n    optional arguments:\n      -h, --help            show this help message and exit\n      -f FILE, --file FILE  file to export password (defaults to stdout)\n      -d DIRECTORY, --directory DIRECTORY, --dir DIRECTORY\n                            Firefox profile directory\n      -v, --verbose\n\n## Import from CSV\n\n``` bash\nffpass import \u003c passwords.csv\nffpass import -f passwords.csv\nffpass import --file passwords.csv\n```\n\nBy default, it works with the passwords exported from Google Chrome.\n\n### Usage\n\n    usage: ffpass import [-h] [-f FROM_FILE] [-d DIRECTORY] [-v]\n    \n    imports a CSV with columns `url,username,password` (order insensitive)\n    \n    optional arguments:\n      -h, --help            show this help message and exit\n      -f FILE, --file FILE  file to import from (defaults to stdin)\n      -d DIRECTORY, --directory DIRECTORY, --dir DIRECTORY\n                            [Firefox profile directory](https://support.mozilla.org/en-US/kb/profiles-where-firefox-stores-user-data#w_how-do-i-find-my-profile)\n      -v, --verbose\n\n### Formatting\n\nFor CSV files not exported from Google Chrome, take these formatting rules into consideration:\n\n    1. The CSV must have the headers \"url\", \"username\", and \"password\". Any other columns will be safely ignored.\n    2. The url must be formatted to include all prefixes (\"http://\", \"https://\", etc), or ffpass will not be able to read them correctly.\n    3. ffpass does not care if the CSV has quotes around fields, even if some fields have them and others don't.\n\n## Transfer from Google Chrome to Firefox\n\nNow, Firefox can more accurately import logins saved in Chrome/Chromium on Windows and macOS (including timestamps, deduping, http auth. logins, etc.) so you don't need to use this tool on those operating systems. See File \u003e Import from Another Browser… in Firefox to import.\n\n### Export from Google Chrome\n\n1.  Open Chrome and enter the following in the address bar:\n    `chrome://flags/#PasswordExport`\n2.  Click Default next to “Password export” and choose Enabled.\n3.  Click Relaunch Now. Chrome will restart.\n4.  Click the Chrome menu \u003ci class=\"fa fa-ellipsis-v\"\u003e\u003c/i\u003e in the\n    toolbar and choose Settings.\n5.  Scroll to the bottom and click Advanced.\n6.  Scroll to the “Passwords and forms” section and click “Manage\n    passwords”.\n7.  Click \u003ci class=\"fa fa-ellipsis-v\"\u003e\u003c/i\u003e next to Saved Passwords and\n    choose Export.\n8.  Click Export Passwords, enter the password you use to log in to your\n    computer, and save the file to `passwords.csv` (or any other\n    available name).\n\n*(instructions from \u003chttps://support.1password.com/import-chrome/\u003e)*\n\n### Import in Firefox\n\n1.  Stop Firefox\n2.  Import into Firefox:\n\n\u003c!-- end list --\u003e\n\n``` bash\nffpass import --file passwords.csv\n```\n\nRestart Firefox, making sure it didn't leave any process still open.\n\n## Transfer from Firefox to Google Chrome\n\n### Export from Firefox\n\n1.  Stop Firefox\n2.  Export from Firefox:\n\n\u003c!-- end list --\u003e\n\n``` bash\nffpass export --file passwords.csv\n```\n\n### Import in Google Chrome\n\n1.  Open Chrome and enter the following in the address bar:\n    `chrome://flags/#PasswordImport`\n2.  Click Default next to “Password import” and choose Enabled.\n3.  Click Relaunch Now. Chrome will restart.\n4.  Click the Chrome menu \u003ci class=\"fa fa-ellipsis-v\"\u003e\u003c/i\u003e in the\n    toolbar and choose Settings.\n5.  Scroll to the bottom and click Advanced.\n6.  Scroll to the “Passwords and forms” section and click “Manage\n    passwords”.\n7.  Click \u003ci class=\"fa fa-ellipsis-v\"\u003e\u003c/i\u003e next to Saved Passwords and\n    choose Import.\n8.  Select the file `passwords.csv` and click Import.\n\n## Troubleshoot\n\n  - `ffpass export: error: the following arguments are required:\n    -d/--directory/--dir`\n    \n    It means one of the following (launch with option `--verbose` to\n    know):\n    \n      - Automatic profile selection is not supported for your platform.\n      - There is more than one user profile for Firefox.\n    \n    You have to provide the `--dir` option with your Firefox Profile\n    Folder. To find it, follow these\n    [instructions](https://support.mozilla.org/en-US/kb/profiles-where-firefox-stores-user-data#w_how-do-i-find-my-profile)\n    on the website of Firefox.\n\n  - `Firefox password database is empty. Please create it from Firefox.`\n    \n    It means that Firefox currently doens't store any password. `ffpass`\n    cannot create the password database for security reasons. Just add\n    one password manually to Firefox to create the database.\n\n  - `TypeError: 'PosixPath' object is not iterable`\n    \n    See [\\#17](https://github.com/louisabraham/ffpass/issues/17).\n\n  - Empty url field (\"example.com\") in Firefox after importing: the urls of the source\n    csv file must begin with a scheme (`http://`, `https://`, `ftp://`,\n    etc…)\n    \n  - Passwords do not sync to other devices, including Lockwise app.\n\n    Importing passwords break the sync. You'll have to disconnect the\n    Firefox account in the Sync options and the re-add it.\n\n## Credits\n\nThanks a lot to @lclevy for the retro-engineering\\! I was inspired by\nhis repository \u003chttps://github.com/lclevy/firepwd\u003e.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flouisabraham%2Fffpass","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flouisabraham%2Fffpass","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flouisabraham%2Fffpass/lists"}