bwzy - bitwarden ... fuzzy

bwzy is a fuzzy finder and auto-filler for Bitwarden using the official bitwarden cli (read-only at present).

The bw cli is great, but not very user-friendly.

bwzy tries to make this quicker by caching the information and presenting it via the magnificient fzf.

bwzy also adds an archive mode which lets you hide entries based on a string.

current features

• READ-ONLY terminal UI
• filter based on name (i.e. "hide archives")
• search based on name and folder
• copy user/pass/totp
• cache the items in shared memory (/dev/shm/) to make it fast
• cache does not persist through reboots (by default)
• refresh/flush cache
• preview items in YAML form
• auto-fill for hyprland

requirements

The following software is needed by bwzy:

• fzf for fuzzy finding
• bitwarden cli client to access bitwarden
• jq to work with the JSON
• OATH Toolkit allows generating TOTP tokens
• charmbracelet - gum for the loading spinner and color

it also expects grep, sed and awk to be available

Additinally, you will need clipboard and keyboard automation such as wtype and wl-copy under wayland.

configuration

All configuration is done via environment variables, with defaults shown

# functional settings
BWZY_CACHE=`/dev/shm/bwzy-cache`           # where the passwords are cached
BWZY_KEEP_CACHE='true'                     # set to false and cache will be purged
BWZY_COPY_CMD='wl-copy'                    # the command to copy something to the clipboard
BWZY_TYPE_CMD='wtype'                      # the command used to type / send keyboard events
BWZY_HIDE_CMD=''                           # the command to hide bwzy.desktop
BWZY_REFOCUS_CMD=''                        # the command to refocuse the previous window
BWZY_COPY_AND_HIDE='true'                  # set to 'false' to not hide bwzy on copy - does not affect auto-fill
BWZY_NOTIFY_CMD='notify-send -i bitwarden' # send a notification (optional, but nice to know if a TOTP has been copied)
BWZY_FILTER="-zz~ "                        # exclude items with this string in name of folder

# cosmetic overrides which adjust the looks
BWZY_USER_SYMBOL='u+' # new prompt on user copy
BWZY_PASS_SYMBOL='p+' # new prompt on password copy
BWZY_TOTP_SYMBOL='t+' # new prompt on TOTP copy
BWZY_LINK_SYMBOL='l+' # new prompt on link copy
BWZY_AUTO_SYMBOL='a+' # new prompt on auto-fill 
BWZY_FOLDER_SYMBOL='/' # new symbol used for a folder
BWZY_POINTER_SYMBOL='> ' # the line marker used by FZF 
BWZY_PROMPT_SYMBOL='? ' # the prompt symbol used by FZF 

bwzy is being tested as my daily driver under Hyprland and Wayland only, but may be adaptable by the intrepid adventurer. The configuration items to look at are:

• BWZY_COPY_CMD
• BWZY_TYPE_CMD
• BWZY_HIDE_CMD
• BWZY_REFOCUS_CMD
• BWZY_COPY_AND_HIDE
• BWZY_NOTIFY_CMD

Note: under hyprland the following works:

BWZY_HIDE_CMD=hyprctl dispatch movetoworkspacesilent special:tools,title:bwzy
BWZY_REFOCUS_CMD=hyprctl dispatch focuscurrentorlast

This hides the bwzy window, a terminal window with the title set to bwzy, to a special workplace. A shortcut defined in my window manager brings that window to the foreground.

The bwzy.desktop file shows the way I launch it.

If you have a font and terminal with support for unicode, you can use fancy symbols. Here's mine:

BWZY_USER_SYMBOL=' '
BWZY_PASS_SYMBOL=' '
BWZY_AUTO_SYMBOL=' '
BWZY_TOTP_SYMBOL=' '
BWZY_LINK_SYMBOL=' '
BWZY_FOLDER_SYMBOL='/'
BWZY_POINTER_SYMBOL=' '
BWZY_PROMPT_SYMBOL=' '

tips and tricks

By default the cache is removed on reboot since it lives in /dev/shm/. if you have a secure encrypted file system you can override the cache location so that it persists during reboots. Be safe and know your risks.

feature ideas

• auto-fill (done)
• "archive" feature to filter things (done)
• edit an entry
• add a new entry
• folder based navigation (as in select from list of folders)