# Bitwarden Exporter
Python Wrapper for [Password Manager CLI](https://bitwarden.com/help/cli/) for exporting bitwarden vaults to KeePass.
## Features
- **Comprehensive data mapping**
- Credentials
- URIs (Compatible with keepass URL)
- Notes (Compatible with keepass note)
- TOTP codes (Compatible with keepass totp)
- Custom Fields (Compatible with additional attributes)
- Identity/Cards (Backup only, not supported by Keepass yet)
- Attachments (Compatible with keepass attachment)
- SSH keys (Compatible with keepass ssh and attachments)
- Fido U2F Keys (Backup only, not supported by Keepass yet)
- **Preserves vault structure**
- Collection and Folder hierarchy is preserved as Keepass groups.
- Built-in JSON snapshot of vault data for auditing.
- Configurable CLI with options for duplicates handling, custom temp directory, debug logging, and Bitwarden CLI path.
[Other screenshots](./docs/screenshots.md).
## Prerequisites
- [Bitwarden CLI](https://bitwarden.com/help/article/cli/#download-and-install)
- [Python](https://www.python.org/)
- [uvx](https://docs.astral.sh/uv/guides/tools/) (optional)
- [pipx](https://github.com/pypa/pipx) (optional)
- venv (optional)
## Installation
(Recommended) Run with [uvx](https://docs.astral.sh/uv/guides/tools/)
from [PyPI](https://pypi.org/project/bitwarden-exporter/)
```bash
BW_SESSION=<session token> uvx bitwarden-exporter==1.10.2 keepass --help
```
or
```bash
BW_SESSION=<session token> uvx bitwarden-exporter==1.10.2 keepass --help
```
Run it from [source](https://github.com/arpanrec/bitwarden-exporter)
```bash
BW_SESSION=<session token> uvx git+https://github.com/arpanrec/bitwarden-exporter.git@main keepass --help
```
Install with [pipx](https://github.com/pypa/pipx) from [PyPI](https://pypi.org/project/bitwarden-exporter/)
```bash
BW_SESSION=<session token> pipx install bitwarden-exporter==1.10.2
```
## [CLI Usage](./docs/cli.md)
Run `bitwarden-exporter --help` to see all available options.
## Credits
[@ckabalan](https://github.com/ckabalan)
for [bitwarden-attachment-exporter](https://github.com/ckabalan/bitwarden-attachment-exporter)
## License
MIT
Raw data
{
"_id": null,
"home_page": null,
"name": "bitwarden-exporter",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "bitwarden, export, keepass, backup",
"author": "arpan",
"author_email": "arpan <me@arpanrec.com>",
"download_url": "https://files.pythonhosted.org/packages/07/59/37b785df7401b8b77a5cfc755e89f9bfe233e9f627d8e2fbe66153dbcd8a/bitwarden_exporter-1.10.2.tar.gz",
"platform": null,
"description": "# Bitwarden Exporter\n\nPython Wrapper for [Password Manager CLI](https://bitwarden.com/help/cli/) for exporting bitwarden vaults to KeePass.\n\n## Features\n\n- **Comprehensive data mapping**\n - Credentials\n - URIs (Compatible with keepass URL)\n - Notes (Compatible with keepass note)\n - TOTP codes (Compatible with keepass totp)\n - Custom Fields (Compatible with additional attributes)\n - Identity/Cards (Backup only, not supported by Keepass yet)\n - Attachments (Compatible with keepass attachment)\n - SSH keys (Compatible with keepass ssh and attachments)\n - Fido U2F Keys (Backup only, not supported by Keepass yet)\n- **Preserves vault structure**\n - Collection and Folder hierarchy is preserved as Keepass groups.\n- Built-in JSON snapshot of vault data for auditing.\n- Configurable CLI with options for duplicates handling, custom temp directory, debug logging, and Bitwarden CLI path.\n\n\n\n[Other screenshots](./docs/screenshots.md).\n\n## Prerequisites\n\n- [Bitwarden CLI](https://bitwarden.com/help/article/cli/#download-and-install)\n\n- [Python](https://www.python.org/)\n - [uvx](https://docs.astral.sh/uv/guides/tools/) (optional)\n - [pipx](https://github.com/pypa/pipx) (optional)\n - venv (optional)\n\n## Installation\n\n(Recommended) Run with [uvx](https://docs.astral.sh/uv/guides/tools/)\nfrom [PyPI](https://pypi.org/project/bitwarden-exporter/)\n\n```bash\nBW_SESSION=<session token> uvx bitwarden-exporter==1.10.2 keepass --help\n```\n\nor\n\n```bash\nBW_SESSION=<session token> uvx bitwarden-exporter==1.10.2 keepass --help\n```\n\nRun it from [source](https://github.com/arpanrec/bitwarden-exporter)\n\n```bash\nBW_SESSION=<session token> uvx git+https://github.com/arpanrec/bitwarden-exporter.git@main keepass --help\n```\n\nInstall with [pipx](https://github.com/pypa/pipx) from [PyPI](https://pypi.org/project/bitwarden-exporter/)\n\n```bash\nBW_SESSION=<session token> pipx install bitwarden-exporter==1.10.2\n```\n\n## [CLI Usage](./docs/cli.md)\n\nRun `bitwarden-exporter --help` to see all available options.\n\n## Credits\n\n[@ckabalan](https://github.com/ckabalan)\nfor [bitwarden-attachment-exporter](https://github.com/ckabalan/bitwarden-attachment-exporter)\n\n## License\n\nMIT\n",
"bugtrack_url": null,
"license": null,
"summary": "Export Bitwarden vault",
"version": "1.10.2",
"project_urls": null,
"split_keywords": [
"bitwarden",
" export",
" keepass",
" backup"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "4d96c0523782793e20e1ec8da4a6a9bef45c3aef56aeb9e315082b678db9225b",
"md5": "b82ef4be0eebaad09dea31561ac745b7",
"sha256": "e8807c3f8d9a3e95e5d81638707061db8e4caec7e958b703689584b152f6b053"
},
"downloads": -1,
"filename": "bitwarden_exporter-1.10.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b82ef4be0eebaad09dea31561ac745b7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 18532,
"upload_time": "2025-10-29T16:45:29",
"upload_time_iso_8601": "2025-10-29T16:45:29.864706Z",
"url": "https://files.pythonhosted.org/packages/4d/96/c0523782793e20e1ec8da4a6a9bef45c3aef56aeb9e315082b678db9225b/bitwarden_exporter-1.10.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "075937b785df7401b8b77a5cfc755e89f9bfe233e9f627d8e2fbe66153dbcd8a",
"md5": "fffd81e00eb5ba7ea6beec2203dbe872",
"sha256": "5f8935697ef5976883512e1dfd97d5f2188fe5e713278230bac96e047b9103d3"
},
"downloads": -1,
"filename": "bitwarden_exporter-1.10.2.tar.gz",
"has_sig": false,
"md5_digest": "fffd81e00eb5ba7ea6beec2203dbe872",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 14327,
"upload_time": "2025-10-29T16:45:30",
"upload_time_iso_8601": "2025-10-29T16:45:30.708025Z",
"url": "https://files.pythonhosted.org/packages/07/59/37b785df7401b8b77a5cfc755e89f9bfe233e9f627d8e2fbe66153dbcd8a/bitwarden_exporter-1.10.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-29 16:45:30",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "bitwarden-exporter"
}
JSON