diff --git a/README.md b/README.md index ffe26f2..702550c 100644 --- a/README.md +++ b/README.md @@ -1,83 +1,65 @@ # bwzy - bitwarden ... fuzzy -bwzy is a fuzzy finder and auto-filler for Bitwarden (read-only at present). -It runs in the terminal and uses the official bitwarden CLI. +bwzy is a fuzzy finder for Bitwarden using the official bitwarden cli. -![bwzy screenshot](./bwzy.jpg) +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](https://junegunn.github.io/fzf/). # current features - - terminal UI -- more user-friendly than the `bw` command line client +- READ-ONLY ui - search based on name and folder -- hide based on name (i.e. "hide archives") - copy user/pass/totp -- local cache for speed +- 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 (currently working in hyprland) -- one-shot mode for use in scripts +- auto-fill for hyprland # requirements The following software is needed by `bwzy`: -- [bitwarden cli client](https://contributing.bitwarden.com/getting-started/clients/cli) to access bitwarden - [fzf](https://junegunn.github.io/fzf/) for fuzzy finding +- [bitwarden cli client](https://contributing.bitwarden.com/getting-started/clients/cli) to access bitwarden - [jq](https://jqlang.github.io/jq/) to work with the JSON - [OATH Toolkit](https://www.nongnu.org/oath-toolkit/) allows generating TOTP tokens - [charmbracelet - gum](https://github.com/charmbracelet/gum) for the loading spinner and color -It also expects `grep`, `sed` and `awk` to be available +it also expects `grep`, `sed` and `awk` to be available -Additionally, you will need clipboard and keyboard automation such as `wtype` and `wl-copy` under wayland. +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 ```bash -# 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 on exit -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 or a terminal named `bwzy` -BWZY_REFOCUS_CMD='' # the command to refocus 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 - +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 +BWZY_REFOCUS_CMD='' # the command to refocuse the previous window +BWZY_COPY_AND_HIDE='true' # set to 'false' to not hide bwzy on copy +BWZY_NOTIFY_CMD='notify-send -i bitwarden' # send a notification # 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_USER_SYMBOL='u+' +BWZY_PASS_SYMBOL='p+' +BWZY_TOTP_SYMBOL='t+' +BWZY_LINK_SYMBOL='l+' +BWZY_AUTO_SYMBOL='a+' +BWZY_FOLDER_SYMBOL='/' +BWZY_POINTER_SYMBOL='> ' +BWZY_PROMPT_SYMBOL='? ' ``` -`bwzy` is being tested as my daily driver under [Hyprland](https://hypr.land/) and [Wayland](https://wayland.freedesktop.org/) 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](https://hypr.land/) the following works: ```bash 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](./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 are mine: +which places the bwzy window launched vi the [bwzy.desktop](./bwzy.desktop) file into a special workspace when not needed. ```bash BWZY_USER_SYMBOL=' ' @@ -90,13 +72,23 @@ BWZY_POINTER_SYMBOL=' ' BWZY_PROMPT_SYMBOL=' ' ``` -# tips and tricks +## arch install +```bash +pacman -S fzf bitwarden-cli jq haskell-yaml oath-toolkit gum +``` +## install dependency -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. I use this often as I'm often completely offline, but still need access to my passwords for offline work. Be safe and know your risks. + +Arch Linux: +```bash +sudo pacman -S --needed wtype ydotool xdotool xvkbd wl-clipboard xclip xsel bat jq sed awk fzf +``` +## 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) +- ~~"archive" feature to filter thingsi~~ (done) +- ability to edit an entry +- ability to add a new entry diff --git a/bwzy b/bwzy index 78dc665..4cfec27 100755 --- a/bwzy +++ b/bwzy @@ -10,10 +10,12 @@ cleanup() { # defaults BWZY_CACHE="${BWZY_CACHE:-/dev/shm/bwzy-cache}" BWZY_FILTER="${BWZY_FILTER:-zz~ }" -# options passed to fzf for default and oneshot modes + BWZY_DEFAULT_OPTS=(--layout reverse --height 100%) BWZY_ONESHOT_OPTS=(--layout default --height 10 --no-header) -# visual settings + +bwzy_autofill=${BWZY_AUTOFILL_HELPER:-"$(dirname "$0")/bwzy-autofill"} + BWZY_POINTER_SYMBOL=${BWZY_POINTER_SYMBOL:-> } BWZY_PROMPT_SYMBOL=${BWZY_PROMPT_SYMBOL:-? } BWZY_USER_SYMBOL=${BWZY_USER_SYMBOL:-u+} @@ -22,18 +24,12 @@ BWZY_TOTP_SYMBOL=${BWZY_TOTP_SYMBOL:-t+} BWZY_LINK_SYMBOL=${BWZY_LINK_SYMBOL:-l+} BWZY_AUTO_SYMBOL=${BWZY_AUTO_SYMBOL:-a+} BWZY_FOLDER_SYMBOL=${BWZY_FOLDER_SYMBOL:-/} +export GLAMOUR_STYLE=tokyo-night # these are needed by the auto-completer export BWZY_COPY_CMD=${BWZY_COPY_CMD:-wl-copy} export BWZY_TYPE_CMD=${BWZY_TYPE_CMD:-wtype} -# and the auto-completer itself -export BWZY_AUTOFILL_HELPER=${BWZY_AUTOFILL_HELPER:-$(dirname "$(realpath "$0")")/bwzy-autofill} -export BWZY_TOTP_COPY=${BWZY_TOTP_COPY:-$(dirname "$(realpath "$0")")/bwzy-copy-totp} - -# set | rg BWZY -# exit 0 - read -r -d '' HELP_TEXT<<'EOH' bwzy is a fuzzy wrapper to the bitwarden cli @@ -49,13 +45,13 @@ Usage: EOH # set some defaults to override based on options -BWZY_OPTS=("${BWZY_DEFAULT_OPTS[@]}") CLEAR_CACHE='false' -DEBUG='false' -FORCE_SYNC='false' -ONESHOT='false' SYNC_CACHE='false' +FORCE_SYNC='false' +DEBUG='false' +BWZY_OPTS=("${BWZY_DEFAULT_OPTS[@]}") FILTER_ARG='-v' # argument to grep +ONESHOT='false' # read in the options while getopts "acdfhis1" o; do @@ -80,12 +76,7 @@ while getopts "acdfhis1" o; do ;; h) # show help and exit - ( echo "$HELP_TEXT" - echo -e "\n# active settings:" - echo '```bash' - set | grep '^BWZY_' | sort - echo '```' - ) | bat -l markdown --plain + echo "$HELP_TEXT" | gum format exit 0 ;; s) @@ -160,7 +151,7 @@ pre_action="execute-silent($BWZY_REFOCUS_CMD && $BWZY_HIDE_CMD)" # set up queries for the fields select_user="$jq_select_id | .login.username' <$items" select_pass="$jq_select_id | .login.password' <$items" -select_totp="$jq_select_id | .login.totp' <$items" +select_totp="$jq_select_id | .login.totp' <$items | sed 's/.*secret=//; s/&.*//' | oathtool -b --totp -" select_link="$jq_select_id | .login.uris[1].uri' <$items" select_user_pass_totp="$select_user; $select_pass; $select_totp" @@ -173,9 +164,9 @@ if [[ $ONESHOT == 'true' ]]; then else copy_user="execute-silent($select_user | $BWZY_COPY_CMD)" copy_pass="execute-silent($select_pass | $BWZY_COPY_CMD)" - copy_totp="execute-silent($select_totp | $BWZY_TOTP_COPY)" + copy_totp="execute-silent($select_totp | $BWZY_COPY_CMD)" copy_link="execute-silent($select_link | $BWZY_COPY_CMD)" - auto_paste="execute-silent(($select_user_pass_totp) | $BWZY_AUTOFILL_HELPER)" + auto_paste="execute-silent(($select_user_pass_totp) | $bwzy_autofill)" copy_user="${pre_action}+${copy_user}+change-prompt($BWZY_USER_SYMBOL)" copy_pass="${pre_action}+${copy_pass}+change-prompt($BWZY_PASS_SYMBOL)" @@ -187,9 +178,9 @@ fi preview_item="$jq_select_id' < $items | json2yaml | bat --color=always -p -l yaml" read -r -d '' fzf_header <