https://github.com/arpanrec/bitwarden-exporter
Bitwarden Export to Keepass
https://github.com/arpanrec/bitwarden-exporter
backup bitwarden bitwarden-cli keepass vault vaultwarden
Last synced: 4 months ago
JSON representation
Bitwarden Export to Keepass
- Host: GitHub
- URL: https://github.com/arpanrec/bitwarden-exporter
- Owner: arpanrec
- License: mit
- Created: 2022-12-24T04:52:58.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-12-08T11:28:00.000Z (6 months ago)
- Last Synced: 2025-12-20T16:45:28.785Z (6 months ago)
- Topics: backup, bitwarden, bitwarden-cli, keepass, vault, vaultwarden
- Language: Python
- Homepage:
- Size: 2.43 MB
- Stars: 5
- Watchers: 0
- Forks: 0
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# 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= uvx bitwarden-exporter==1.10.2 --help
```
or
```bash
BW_SESSION= uvx bitwarden-exporter==1.10.2 --help
```
Run it from [source](https://github.com/arpanrec/bitwarden-exporter)
```bash
BW_SESSION= uvx git+https://github.com/arpanrec/bitwarden-exporter.git@main --help
```
Install with [pipx](https://github.com/pypa/pipx) from [PyPI](https://pypi.org/project/bitwarden-exporter/)
```bash
BW_SESSION= 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