.\" Automatically generated by Pandoc 3.10.1
.\"
.TH "ROFI\-RBW" "1" "August 01, 2026" "Version 1.6.1" "Rofi Third\-party Add\-on Documentation"
.SH NAME
\f[B]rofi\-rbw\f[R] \- A rofi frontend for the alternative Bitwarden
client rbw
.SH SYNOPSIS
.PP
\f[B]rofi\-rbw\f[R] [\f[B]\-h\f[R]] [\f[B]\-\-version\f[R]]
[\f[B]\-\-action\f[R] {\f[I]type\f[R],\f[I]copy\f[R],\f[I]print\f[R]}]
[\f[B]\-\-target\f[R]
{\f[I]username\f[R],\f[I]password\f[R],\f[I]totp\f[R],\f[I]OTHER\f[R]}]
[\f[B]\-\-prompt\f[R] \f[I]PROMPT\f[R]] [\f[B]\-\-selector\-args\f[R]
\f[I]SELECTOR_ARGS\f[R]] [\f[B]\-\-clipboarder\f[R]
\f[I]CLIPBOARDER\f[R]] [\f[B]\-\-typer\f[R] \f[I]TYPER\f[R]]
[\f[B]\-\-selector\f[R] \f[I]SELECTOR\f[R]] [\f[B]\-\-clear\-after\f[R]
\f[I]NUMBER\f[R]] [\f[B]\-\-typing\-key\-delay\f[R] \f[I]NUMBER\f[R]]
[\f[B]\-\-action\-sequence\-delay\f[R] \f[I]NUMBER\f[R]]
[\f[B]\-\-no\-help\f[R]] [\f[B]\-\-display\-fields\f[R]
\f[I]DISPLAY_FIELDS\f[R]] [\f[B]\-\-keybindings\f[R]
\f[I]KEYBINDINGS\f[R]] [\f[B]\-\-menu\-keybindings\f[R]
\f[I]MENU_KEYBINDINGS\f[R]] [\f[B]\-\-use\-notify\-send\f[R]]
.SH DESCRIPTION
Type, copy or print your credentials from Bitwarden using rofi.
.SH OPTIONS
.TP
\-h, \-\-help
Prints brief usage information.
.TP
\-\-version
show program\(cqs version number and exit
.TP
\-\-action, \-a
Possible values: type, copy, print
.RS
.IP
.EX
Choose what to do with the selected characters: Directly type them with the \(dqTyper\(dq, copy them to the clipboard using the \(dqClipboarder\(dq, or \(dqprint\(dq them on stdout
.EE
.RE
.TP
\-\-target, \-t
Possible values: username, password, totp, notes, number, cardholder,
brand, expiry, code, \f[I]CUSTOM FIELD NAME\f[R], menu
.RS
.IP
.EX
Choose which component of the selected entry to type/copy/print. Can be passed multiple times to use multiple targets.
Not all entries have all fields.
\(gamenu\(ga is a special value to open the target menu.
.EE
.RE
.TP
\-\-prompt \f[I]PROMPT\f[R], \-r \f[I]PROMPT\f[R]
Set the text for the prompt.
.TP
\-\-keybindings \f[I]KEYBINDINGS\f[R]
Format: ::.
.RS
.IP
.EX
Define your own keybindings. Multiple keybindings can be concatenated with \(ga,\(ga; multiple targets for one shortcut can be concatenated with \(ga:\(ga.
The pattern is \(ga<shortcut>:<action>:<target>\(ga, where \(gashortcut\(ga is your desired keybinding, \(gaaction\(ga is one of \(ga\-\-action\(ga, \(gatarget\(ga is one of \(ga\-\-target\(ga.
This feature is only available in supported \(rs\(dqselectors\(rs\(dq (currently only rofi).
.EE
.RE
.TP
\-\-menu\-keybindings \f[I]KEYBINDINGS\f[R]
Format: :.
.RS
.IP
.EX
Define your own keybindings for the target menu. Multiple keybindings can be concatenated with \(ga,\(ga.
This feature is only available in supported \(rs\(dqselectors\(rs\(dq.
.EE
.RE
.TP
\-\-clear\-after \f[I]SECONDS\f[R]
Clear the password from the clipboard after \f[I]SECONDS\f[R] seconds.
Set to \f[CR]0\f[R] to disable.
.TP
\-\-typing\-start\-delay \f[I]MILLISECONDS\f[R]
Set a small delay before typing starts.
\f[CR]0\f[R] by default.
.TP
\-\-typing\-key\-delay \f[I]MILLISECONDS\f[R]
Set a small delay between keypresses when typing.
\f[CR]0\f[R] by default.
.TP
\-\-action\-sequence\-delay \f[I]MILLISECONDS\f[R]
Define the duration in milliseconds to wait for a \f[CR]delay\f[R] step
in a keybinding sequence
(e.g.\ \f[CR]Alt+c:copy:username:delay:password\f[R]).
It applies to both \f[CR]type\f[R] and \f[CR]copy\f[R] actions.
\f[CR]1000\f[R] by default.
.TP
\-\-no\-cache
Disable the automatic frecency cache.
It contains sha1\-hashes of the selected entries and how often they were
used.
.TP
\-\-no\-help
Don\(cqt show the help message about available keyboard shortcuts.
.TP
\-\-display\-fields \f[I]DISPLAY_FIELDS\f[R]
Possible values: name_only, name_with_folder, folder, user, uri
.RS
.IP
.EX
Ordered list of fields to show in the selection list, given as separate arguments (e.g. \(ga\-\-display\-fields name_only user\(ga).
\(ganame_with_folder\(ga renders as \(gafolder/name\(ga.
Defaults to \(ganame_with_folder,user\(ga.
.EE
.RE
.TP
\-\-no\-folder \f[I](deprecated)\f[R]
Don\(cqt show folders in the list of possible entries.
Superseded by \f[CR]\-\-display\-fields\f[R].
Translates to \f[CR]\-\-display\-fields name_only user\f[R].
.TP
\-\-selector\-args \f[I]SELECTOR\-ARGS\f[R]
A string of arguments to give to the selector.
.TP
\-\-selector \f[I]SELECTOR\f[R]
Possible values: rofi, wofi
.RS
.IP
.EX
Choose the selector application manually. Usually \(garofi\(ga, but for Wayland, you may want \(gawofi\(ga.
.EE
.RE
.TP
\-\-clipboarder \f[I]CLIPBOARDER\f[R]
Possible values: xsel, xclip, wl\-copy
.RS
.IP
.EX
Choose the application to access the clipboard with manually.
.EE
.RE
.TP
\-\-typer \f[I]TYPER\f[R]
Possible values: xdotool, wtype, ydotool, dotool
.RS
.IP
.EX
Choose the application to type with manually.
.EE
.RE
.TP
\-\-use\-notify\-send
Send a desktop notification after each field is copied
(e.g.\ \(lqusername copied to clipboard\(rq).
.SH DEFAULT KEYBINDINGS
\f[I]enter\f[R] to use the default action
.PP
\f[I]alt+c\f[R] to copy the password
.PP
\f[I]alt+u\f[R] to copy the username
.PP
\f[I]alt+t\f[R] to copy the TOTP
.PP
\f[I]alt+m\f[R] to show a menu of the entry\(cqs components
.PP
\f[I]alt+s\f[R] to sync the contents of the vault
.PP
\f[I]alt+1\f[R] to autotype username and password, separated with a
\f[CR]tab\f[R] character
.PP
\f[I]alt+2\f[R] to type the username
.PP
\f[I]alt+3\f[R] to type the password
.PP
Please note that wofi does not support keybindings other than
\f[I]enter\f[R].
.SH CONFIGURATION
Args that start with \(lq\-\-\(rq (eg.
\-\-version) can also be set in a config file.
.PP
Config file syntax allows: key=value, flag=true, stuff=[a,b,c].
If an arg is specified in more than one place, then commandline values
override values from the config file.
.SH FILES
.TP
\f[I]\(ti/.cache/rofi\-rbw.runcache\f[R]
Saves the number pf times an entry has been used, so that they can be
sorted first.
Entries are hashed with sha1 so as not to leak any secrets.
.SH WEBSITE
https://github.com/fdw/rofi\-rbw
.SH AUTHORS
Fabian Winter.