Metadata-Version: 2.4
Name: bitwarden-exporter
Version: 1.5.0
Summary: Export Bitwarden vault
Keywords: bitwarden,export,keepass,backup
Author: arpan
Author-email: arpan <me@arpanrec.com>
License-Expression: MIT
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: Unix
Classifier: Operating System :: POSIX
Classifier: Operating System :: Microsoft :: Windows
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Utilities
Classifier: Topic :: System :: Archiving
Classifier: Topic :: System :: Archiving :: Backup
Classifier: Topic :: Security
Classifier: Topic :: Security :: Cryptography
Classifier: Topic :: System :: Recovery Tools
Requires-Dist: gnupg==2.3.1
Requires-Dist: pydantic==2.12.2
Requires-Dist: pykeepass==4.1.1.post1
Requires-Dist: cachier==4.1.0
Requires-Dist: pyfiglet==1.0.4
Requires-Dist: bandit==1.8.6 ; extra == 'dev'
Requires-Dist: black==25.9.0 ; extra == 'dev'
Requires-Dist: isort==7.0.0 ; extra == 'dev'
Requires-Dist: mypy==1.18.2 ; extra == 'dev'
Requires-Dist: neovim==0.3.1 ; extra == 'dev'
Requires-Dist: packaging==25.0 ; extra == 'dev'
Requires-Dist: pylint==4.0.1 ; extra == 'dev'
Requires-Dist: pyright==1.1.406 ; extra == 'dev'
Requires-Dist: types-pyyaml==6.0.12.20250915 ; extra == 'dev'
Requires-Dist: types-requests==2.32.4.20250913 ; extra == 'dev'
Requires-Python: >=3.10
Provides-Extra: dev
Description-Content-Type: text/markdown

# Bitwarden Exporter

```text
 ____  _ _                         _            
| __ )(_) |___      ____ _ _ __ __| | ___ _ __  
|  _ \| | __\ \ /\ / / _` | '__/ _` |/ _ \ '_ \ 
| |_) | | |_ \ V  V / (_| | | | (_| |  __/ | | |
|____/|_|\__| \_/\_/ \__,_|_|  \__,_|\___|_| |_|
                                                
 _____                       _            
| ____|_  ___ __   ___  _ __| |_ ___ _ __ 
|  _| \ \/ / '_ \ / _ \| '__| __/ _ \ '__|
| |___ >  <| |_) | (_) | |  | ||  __/ |   
|_____/_/\_\ .__/ \___/|_|   \__\___|_|   
```

Python Wrapper for [Password Manager CLI](https://bitwarden.com/help/cli/) for exporting bitwarden vaults with **attachments**.

This allows you to take a whole backup of your bitwarden vault, including organizations where you don't have access for admin/owner.

### Prerequisites

- [Bitwarden CLI](https://bitwarden.com/help/article/cli/#download-and-install)

### (Recommended) Run with [uvx](https://docs.astral.sh/uv/guides/tools/).

```bash
uvx bitwarden-exporter
```

### Install with [pipx](https://github.com/pypa/pipx).

```bash
pipx install bitwarden-exporter
```

### Options

```bash
bitwarden-exporter --help
```

```text
  -h, --help            show this help message and exit
  -l EXPORT_LOCATION, --export-location EXPORT_LOCATION
                        Bitwarden Export Location, Default: bitwarden_dump_<timestamp>.kdbx, This is a dynamic value, Just in case if it exists, it will be overwritten
  -p EXPORT_PASSWORD, --export-password EXPORT_PASSWORD
                        Bitwarden Export Password, It is recommended to use a password file
  -pf EXPORT_PASSWORD_FILE, --export-password-file EXPORT_PASSWORD_FILE
                        Bitwarden Export Password File, Mutually Exclusive with --export-password
  --allow-duplicates, --no-allow-duplicates
                        Allow Duplicates entries in Export, In bitwarden each item can be in multiple collections, Default: --no-allow-duplicates
  --tmp-dir TMP_DIR     Temporary Directory to store temporary sensitive files, Make sure to delete it after the export, Default: /home/arpan/workspace/bitwarden-
                        exporter/bitwarden_dump_attachments
  --verbose, --no-verbose
                        Enable Verbose Logging, This will print debug logs, THAT MAY CONTAIN SENSITIVE INFORMATION, Default: --no-verbose
```

## Roadmap

- Make a cloud-ready option for bitwarden zero-touch backup, Upload to cloud storage.
- Restore back to bitwarden.

## Credits

[@ckabalan](https://github.com/ckabalan) for [bitwarden-attachment-exporter](https://github.com/ckabalan/bitwarden-attachment-exporter)

## License

MIT
