wofi-bitwarden-menu

A wofi-based menu for accessing data stored in Bitwarden. It is a Python script that queries Bitwarden and builds the corresponding menus in wofi.

Requirements

The following programs must be installed on the system:

• wofi
• wl-clipboard
• libnotify-bin
• bw server: a machine on the local network with bw installed is required to connect to the Bitwarden server where the data is stored

Configuration

The application reads its configuration from ${HOME}/.config/bwmenu.conf. If the file does not exist, default values are used (localhost:9090).

Example bwmenu.conf content:

HOST=host-bw-serve
PORT=9090
WOFI_CFG=~/.config/wofi/style.css
LOCK_TIMEOUT=10

• HOST: Address of the server running bw serve.
• PORT: Server port.
• WOFI_CFG: Path to the wofi CSS style file.
• LOCK_TIMEOUT: Time in minutes before the vault is automatically locked.

A keyboard shortcut can be configured to launch the script from anywhere to copy and paste user credentials.

For example, with sway you can add the following line to the configuration file:

bindsym $mod+Control+b exec bwmenu

You need a Bitwarden CLI client (bw) available on the local network or on the machine itself. After authenticating with the Bitwarden server, start the service with a command like:

bw serve --hostname host-bw-server --port 9090

In the example, the machine is named rpi5c and the port is 9090. The HOST variable in the application's configuration must point to that machine and port.

The application script includes a default style and configuration that can be customized to the user's preference.

Installation

Debian

Download the installation package from bwmenu and install it with the package manager:

sudo dpkg -i wofi-bitwarden-menu.deb
sudo apt install -f # To fix dependencies

Other distributions

Clone the repository with:

git clone https://github.com/RaulGarcia2/wofi-bitwarden-menu.git

Copy the Python script bwmenu and the bash scripts wofi-bitwarden-mata and wofi-bitwarden-bloquea to $HOME/.local/bin, or to any directory included in the PATH environment variable. Copy the bitwarden.svg file to $HOME/.local/share/icons, and the wofi-bitwarden-menu.desktop file to $HOME/.local/share/applications.