RBW Quick Access

Demo

This is a tool that aims to replicate 1Password's Quick-Access overlay backed by rbw.

Installation

macOS

Dependencies: Homebrew

# Tap the self-hosted Homebrew repository:
brew tap oitsjustjose/homebrew \
 https://git.forgeserv.cloud/oitsjustjose/homebrew.git

# Trust the newly added Homebrew repository:
brew trust oitsjustjose/homebrew

Finally you can install / update super easily using:

brew install oitsjustjose/homebrew/rbw-quick-access

Linux

Dependencies: rbw

1. Grab the linux build from the latest release
2. Untar the release using tar -xzvf {file}
3. Finally:

cd {extracted directory}
chmod +x ./install.linux.sh
./install.linux.sh

Windows

As of now, Windows is not supported (none of my machines run Windows currently).

Post-Install

rbw Configuration

Once you have everything installed, configure rbw so it knows where your vault is and who you are with the various options. See the official rbw docs on what config options you have.

At the very least you must configure email with rbw config set email <your email>.

Limitations

Currently there's one particularly big limitation that I can't fix without killing performance: rbw also shows archived items. The best route is to make sure your archive isn't massive (mine was in the demo above, as I'd just moved from 1Password and it brought over those items).

If you need to clear out your archived items, you'll have to do it from the Vaultwarden web ui (limited at 500 items at a time), Bitwarden doesn't offer a mass-select-and-trash option. Don't forget to refresh your Bitwarden before proceeding.

Design Goals

Quick Startup

Large Dataset Support

Using PyQT6's delegate, events, and sticking with primitives where possible, the password list is able to easily handle hundreds of thousands of secrets from your vault just like that! 🫰

Parity with 1Password

When designing this, I was moving from 1Password after using it for 8+ years straight. Moving to [Vault|Bit]warden was mostly a breeze, but this was the one and only working flow that was broken up entirely.

Fields

To succeed in replicating the feel (and more importantly, functionality) of the 1Password quick-access app(let?). The biggest things were being able to search by, and see, the following when browsing and searching:

• Entry Name
• Website
• Username

Keyboard Shortcuts

After 8 years with this system, the keyboard shortcuts were pretty well engrained in my head

• Show the application with:
  • super + shift + \
  • cmd + shift + \
  • win + shift + \
• enter opens the URL, if there is one.
• alt + enter does the same? I'm not sure why... since this was redundant, I didn't bother
• ctrl + c copies the username (if present)
• ctrl + shift + c copies the password
• ctrl + alt + c copies the TOTP
• ctrl + o - NOOP; this opens the item in a new window. I don't want to deal with integrating with the BitWarden GUI too...
• ctrl + shift + o - also NOOP; this opens the item in the full 1Password window, not just the viewer window, and that's just not gonna happen...

Milestones:

• The next big milestone is to re-architect the app such that it stays alive between launches, such that running rbw-quick-access --show (or something to that effect) will spin up a singleton if it isn't running, and shows it. This would mean a single binary file is all I'd need to distribute and would make installation easier.
• Windows & macOS Builds
  • Skipping Windows for now. I frankly don't feel like it - especially since rbw isn't natively supported there. Who knows how painful getting it build with cargo .
• 1Password's Quick Access clears the search field & results after some given amount of time. It otherwise keeps the previous selection active. I want to implement the same.
• Better PinEntry support
• Auto-sync from Bitwarden on close
• Eventually we'll want a configuration screen which:
  • Would allow you to select a vault
  • ..or a specific folder
  • Change sorting methods (like sorting by most-used)
  • Change the in-app keyboard shortcuts
  • or the various colors
  • or the font