Bitwarden-menu

Dmenu/Rofi frontend for managing Bitwarden vaults. Uses the Bitwarden CLI tool to interact with the Bitwarden database.

This project is not associated with the Bitwarden project nor 8bit Solutions LLC.

Installation

pip install --user bitwarden-menu

Ensure ~/.local/bin is in your $PATH. Run bwm and enter your database path, keyfile path, and password.

For full installation documention see the [installation docs][docs/install.md].

Full Documentation

Installation - Configuration - Usage

Requirements

1. Python 3.7+
2. Bitwarden CLI. Ensure the bw command is in $PATH
3. Pynput
4. Dmenu, Rofi or Bemenu
5. (optional) Pinentry.
6. (optional) xdotool, ydotool(>= 1.0.0)/wtype (for Wayland).

Features

• Supports bitwarden.com and self-hosted Vaultwarden accounts.
• Auto-type username and/or password on selection. No clipboard copy/paste involved.
• Supports login with 2FA code from Authenticator(TOTP), Email, or Yubikey.
• Background process allows selectable time-out for locking the database.
• Use a custom [Keepass 2.x style auto-type sequence][6].
• Type, view or edit any field.
• Open the URL in the default web browser.
• Non U.S. English keyboard languages and layouts supported via xdotool or ydotool/wtype (for Wayland).
• Edit notes using terminal or gui editor.
• Add and Delete entries
• Rename, move, delete and add folders and collections
• Move any item to or from an organization, including support for multiple collections.
• Hide selected folders from the default and 'View/Type Individual entries' views.
• Define multiple vault URLs in the config file.
• Configure the characters and groups of characters used during password generation.
• Optional Pinentry support for secure passphrase entry.
• Add, edit and type TOTP codes.

License

• MIT

Usage

bwm [-h] [-v VAULT] [-l LOGIN] [-a AUTOTYPE]

• Run bwm or bind to keystroke combination.
• Enter account URL on first run.
• Start typing to match entries.
• Configure ~/.config/bwm/config.ini as desired.
• More detailed usage information.

Tests

To run tests in a venv: make test (not implemented yet)

Development

• To install bitwarden-menu in a venv: make
• Build man page from Markdown source: make man

Planned features

• Unit tests
• TOTP support
• Notifications for syncing status (e.g. when a sync is complete)
• Clipboard support