Skip to content

Latest commit

 

History

History
58 lines (37 loc) · 1.75 KB

readme.md

File metadata and controls

58 lines (37 loc) · 1.75 KB

RBW Menu

This script allows for interactively getting credentials from rbw, probably triggered via window-manager keybinding.

Roadmap

This does exactly what I need; I don't plan to change much.

Dependencies

  • rbw
  • jq - JSON parser
  • wofi - Optional menu GUI. Trivial to replace with dmenu, bemenu, fzf, or whatever else.

Installation

For all methods:

  1. Look over the source code.
  2. Install and set up rbw

From Source

  1. Install dependencies
  2. clone this repo
  3. # make install

Packages

(If you package it somewhere else, feel free to submit a PR adding it to this list.)

Usage

  • Show menu, print username for selected item to stdout: $ rbw-menu
  • Show menu, copy password for selected item to clipboard: $ rbw-menu password | wl-copy
  • Show menu, copy OTP for selected item to clipboard: $ rbw-menu code | wl-copy
  • Use a different picker: RBW_MENU_COMMAND="fzf" rbw-menu

I use these scripts with sway, though they'll work with anything. Relevant part of my config:

bindsym $mod+p exec rbw-menu password | wl-copy
bindsym $mod+u exec rbw-menu username | wl-copy
bindsym $mod+o exec rbw-menu code | wl-copy

Using a different menu

By default, we use wofi. To change this, set the RBW_MENU_COMMAND environment variable to anything which can accept a list from STDIN, and return a single line from that list to STDOUT.

Releases

  • 1.0 - Initial release
  • 1.1 - Remove bespoke OTP support, use rbw code instead
  • 1.2 - Check for and handle locked vault
  • 1.3 - Remove undocumented bash dependency; rewrite script to be POSIX sh compliant